| 1 | An entity with this attribute can be replaced with another entity under certain conditions. |
| 2 | |
| 3 | This might be a siege weapon or mobile building packing or unpacking (with each being a separate entity), a structure being upgraded to more advanced version (such as from Town to City) and so forth. |
| 4 | |
| 5 | Upgrades can also be singular or global. The above examples only affect one entity, but a user could for example research a tech that replaces all instances of a certain entity with a more advanced version. |
| 6 | |
| 7 | = !NewEntity = |
| 8 | ''BRIEF DESCRIPTION ::'' This is the entity name of the replacement entity this entity will become when the pre-requisites for transformation are met. |
| 9 | |
| 10 | = Food = |
| 11 | ''BRIEF DESCRIPTION ::'' This much Food will be deducted from the player's Resource Pool when he upgrades this entity. |
| 12 | |
| 13 | = Ore = |
| 14 | ''BRIEF DESCRIPTION ::'' This much Ore will be deducted from the player's Resource Pool when he upgrades this entity. |
| 15 | |
| 16 | = Stone = |
| 17 | ''BRIEF DESCRIPTION ::'' This much Stone will be deducted from the player's Resource Pool when he upgrades this entity. |
| 18 | |
| 19 | = Wood = |
| 20 | ''BRIEF DESCRIPTION ::'' This much Wood will be deducted from the player's Resource Pool when he upgrades this entity. |
| 21 | |
| 22 | = Time = |
| 23 | ''BRIEF DESCRIPTION ::'' This is the amount of time (in seconds) that it will take to complete the upgrade of this entity. |
| 24 | |
| 25 | = Req = |
| 26 | ''BRIEF DESCRIPTION ::'' This attribute lists the IDs of the units, structures and techs that must be created/researched before this entity has the option to transform. |
| 27 | |
| 28 | Note that the string should support slashes (or whatever's easiest: ||, OR, or whatever) to indicate where only one of a set are required. eg: "fc/mt" means that the player needs to have built a Farm Centre or Military Centre. |
| 29 | |
| 30 | = Phase = |
| 31 | ''BRIEF DESCRIPTION ::'' This attribute states the Phase (Village/Town/City) that must be attained before this entity has the option to transform. |
| 32 | |
| 33 | Example: |
| 34 | |
| 35 | <Traits> |
| 36 | // Village Centre can be upgraded to Town Centre by spending resources and time, and building certain structures. |
| 37 | {{{ |
| 38 | <Transform |
| 39 | newentity="Town Centre" |
| 40 | food="100" |
| 41 | ore="250" |
| 42 | stone="50" |
| 43 | wood="100" |
| 44 | time="250" |
| 45 | req="fc/mt, mt/fc" |
| 46 | phase="Village" |
| 47 | ></Transform> |
| 48 | }}} |
| 49 | </Traits> |