Changes between Version 6 and Version 7 of Aura_Templates


Ignore:
Timestamp:
Apr 6, 2016, 9:56:30 AM (8 years ago)
Author:
sanderd17
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • Aura_Templates

    v6 v7  
    1 The auras can be used on an entity by including the following part in the entity XML:
     1The auras can be used on an entity by creating an aura json like this:
    22
    33{{{
    4 #!xml
    5   <Auras>
    6     <Aura1>
    7       <Type>range</Type>
    8       <Radius>60</Radius>
    9       <Affects>Worker</Affects>
    10       <Modifications>
    11         <Builder.Rate> <Multiply>1.15</Multiply> </Builder.Rate>
    12       </Modifications>
    13       <AuraName>Builder Aura</AuraName>
    14       <AuraDescription>Buildings construct 15% faster within his vision.</AuraDescription>
    15       <OverlayIcon>art/textures/ui/session/auras/build_bonus.png</OverlayIcon>
    16     </Aura1>
    17     <Aura2>
    18       <Type>global</Type>
    19       <Affects>Temple</Affects>
    20       <Modifications>
    21         <Cost.Resources.stone> <Add>-50</Add> </Cost.Resources.stone>
    22       </Modifications>
    23       <AuraName>Acropolis Aura</AuraName>
    24       <AuraDescription>Temples are 50 stone cheaper during his lifetime.</AuraDescription>
    25     </Aura2>
    26   </Auras>
     4#!json
     5{
     6    type: range,
     7    radius: 60,
     8    affects: ["Worker"],
     9    modifications: [
     10        {value: "Builder/Rate", multiply: 1.15}
     11    ],
     12    auraName: "Builder Aura",
     13    auraDescription: "Buildings construct 15% faster within his vision.",
     14    overlayIcon: "art/textures/ui/session/auras/build_bonus.png"
    2715}}}
    2816
    29 The '''Type''' can currently be '''range, global, formation, garrison or garrisonedUnits'''. The range type also requires an extra Radius (as in the example), all entities in this Radius will be affected by the aura. Global auras work on all entities (like technologies, but the working is reverted when the entity with an aura dies). Global and range auras also affect the unit itself when applicable. Formation auras affect all members of the same formation as the unit. The garrison aura has an effect on the garrisoning structure (arrows the structure shoots, speed of a ship, ...). And as last one, the garrisonedUnits aura influences the units that are visibly garrisoned (giving units on a wall extra armor f.e.).
     17The '''type''' can currently be '''range, global, formation, garrison or garrisonedUnits'''. The range type also requires an extra Radius (as in the example), all entities in this radius will be affected by the aura. Global auras work on all entities (like technologies, but the working is reverted when the entity with an aura dies). Global and range auras also affect the unit itself when applicable. Formation auras affect all members of the same formation as the unit. The garrison aura has an effect on the garrisoning structure (arrows the structure shoots, speed of a ship, ...). And as last one, the garrisonedUnits aura influences the units that are visibly garrisoned (giving units on a wall extra armor f.e.).
    3018
    3119
    32 '''Affects''' determines the classes it affects, listed as "Class1+Class2 Class3", which means Class3 OR (Class1 AND Class2). The aura will only have an effect on the listed classes.
     20'''affects''' determines the classes it affects, listed as "Class1+Class2 Class3", which means Class3 OR (Class1 AND Class2). The aura will only have an effect on the listed classes.
    3321
    34 '''!AffectedPlayers''' defines on which players it will act (a hero might cause the enemy to have less armour). The possible values are '''Player''' (yourself), '''Ally''', '''MutualAlly''' or '''Enemy'''. This value defaults to Player.
     22'''!affectedPlayers''' defines on which players it will act (a hero might cause the enemy to have less armour). The possible values are '''Player''' (yourself), '''Ally''', '''!MutualAlly''' or '''Enemy'''. This value defaults to Player.
    3523
    36 '''Modifications''' are list of modifications that will be applied. Similarly structured as with technologies. A modification consists out of key, which presents the name of the value that will be changed, and either '''Add''' or '''Multiply''' to resp. add or multiply the value of the affected entity with something. Note that the actions should be reversible (they are reversed when the aura carrying entity is killed), so multiplications with 0 are not allowed. All other values are supported.
     24'''modifications''' are list of modifications that will be applied. Similarly structured as with technologies. A modification consists out of key, which presents the name of the value that will be changed, and either '''add''' or '''aultiply''' to resp. add or multiply the value of the affected entity with something. Note that the actions should be reversible (they are reversed when the aura carrying entity is killed), so multiplications with 0 are not allowed. All other values are supported.
    3725
    3826Note that the list of modifiable unit properties is the same as with the Technologies (see TechModifications), but as '/' is not valid as an XML key, the '/' signs are replaced with dots. So Health.Max instead of Health/Max. You can escape a dot (.) by using a double (..). So "ResourceGatherer.Rates.food..grain" would become "ResourceGatherer/Rates/food.grain".
    3927
    40 '''!AuraName''' and '''!AuraDescription''' are not mandatory, but will appear in various UI elements.
     28'''!auraName''' and '''!auraDescription''' are not mandatory, but will appear in various UI elements.
    4129
    42 '''!OverlayIcon''' is the icon showed above all affected entity's.
     30'''!overlayIcon''' is the icon showed above all affected entity's.
    4331
    4432