Editing MG/Attack-boost

Jump to navigation Jump to search

Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.

Latest revision Your text
Line 1: Line 1:
Attack boosts are a [[MegaGlest]] only extender which allows boosts to be applied to units in the form of emanations. Within a radius of the unit with the attack boost, other units (which can be foes, allies, a specific faction, a specific unit, or any unit) can have their stats modified and have an optional particle effect. So in other words, attack boosts provide a way to boost or detriment nearby units.
+
Attack boosts are a [[MegaGlest]] only extender which allows boosts to be applied to units when attacking, such as increasing the attacker and units near the attack's stats. These appear inside the attack skill.
  
 
{{TOC limit|2}}
 
{{TOC limit|2}}
Line 11: Line 11:
 
<unit-type name="name" />
 
<unit-type name="name" />
 
</target>
 
</target>
<max-hp value="0" regeneration="0" value-percent-multiplier="false" />
+
<max-hp value="0" value-percent-multipler="false" />
<max-ep value="0" regeneration="0" value-percent-multiplier="false" />
+
<max-ep value="0" value-percent-multipler="false" />
<sight value="0" value-percent-multiplier="false" />
+
<sight value="0" value-percent-multipler="false" />
<attack-strength value="0" value-percent-multiplier="false" />
+
<attack-strenght value="0" value-percent-multipler="false" />
<attack-range value="0" value-percent-multiplier="false" />
+
<attack-range value="0" value-percent-multipler="false" />
<armor value="0" value-percent-multiplier="false" />
+
<armor value="0" value-percent-multipler="false" />
<move-speed value="0" value-percent-multiplier="false" />
+
<move-speed value="0" value-percent-multipler="false" />
<production-speed value="0" value-percent-multiplier="false" />
+
<production-speed value="0" value-percent-multipler="false" />
 
<particles value="true">
 
<particles value="true">
 
<originator-particle-file path="glow_particles.xml" />
 
<originator-particle-file path="glow_particles.xml" />
Line 27: Line 27:
  
 
==Documentation==
 
==Documentation==
All tags except <tt>&lt;allow-multiple-boost&gt;</tt>, <tt>&lt;radius&gt;</tt>, and <tt>&lt;target&gt;</tt> are optional.
 
 
The <tt>value-percent-multiplier</tt> attribute causes the value to be treated as a percentage of what was given in the xml. So if a unit has a base speed of 100 and you set the speed value of the attack boost to 50 with <tt>value-percent-multiplier</tt> true, then the speed will be increased by 50% to a total of 150 speed.
 
 
If <tt>value-percent-multiplier</tt> is false, the stat is simple added.
 
 
Hint: the value can be negative to "damage" units
 
 
 
===allow-multiple-boosts===
 
===allow-multiple-boosts===
 
If true, there can be multiple boosts, which will stack. If false, boosts cannot stack, but will simply overwrite.
 
If true, there can be multiple boosts, which will stack. If false, boosts cannot stack, but will simply overwrite.
Line 42: Line 34:
  
 
===target===
 
===target===
This tag defines who gets effected by the attack boosts. The value defines the broad characteristic, either <tt>all</tt> (any unit, regardless of alliances), <tt>ally</tt> (only allied units), <tt>foe</tt> (only opposing units), or <tt>faction</tt> (only units in the same faction).
+
This tag defines who gets effected by the attack boosts. The value defines the broad characteristic, either <tt>all</tt> (any unit, regardless of alliances), <tt>ally</tt> (only allied units), <tt>foe</tt> (only opposing units), or <tt>faction</tt> (only units in the same faction).<!-- Why is "unit-types" not listed here? Because you can now have unit-type children in any of these types, it does the same thing as the "all" type, making it useless -->
  
This tag can have a<tt>unit-type</tt> children which can limit them down to only the listed units that fit the broader characteristic previously listed. However, it's also possible to use just these broader characteristics. For example, having just <tt>&lt;target value="ally" /&gt;</tt> allows it to effect all unit types of all allies. However, you can give it <tt>unit-type</tt> children tags to allow it to effect those types of units only if they are allies. For example, you might want it to only boost allied melee units, where you'd set the target value to ally and give a child <tt>unit-type</tt> tag to each melee unit.
+
This tag can have <tt>unit-type</tt> children which can limit them down to only the listed units that fit the broader characteristic previously listed. However, it's also possible to use just these broader characteristics. For example, having just <tt>&lt;target value="ally" /&gt;</tt> allows it to effect all unit types of all allies. However, you can give it <tt>unit-type</tt> children tags to allow it to effect those types of units only if they are allies. For example, you might want it to only boost allied melee units, where you'd set the target value to ally and give a child <tt>unit-type</tt> tag to each melee unit.
  
 
The <tt>include-self</tt> tag defines whether or not the unit with the attack boost should be included as a target.
 
The <tt>include-self</tt> tag defines whether or not the unit with the attack boost should be included as a target.
 
Note:MG Deveopment branch features "tags" wich can be used to define a goup of units" this tag is suposed to work most places including here
 
  
 
===max-hp===
 
===max-hp===
max-HP itself is ignored for boosts, just the <tt>regeneration</tt> attribute affects HP regeneration.
+
How much to effect the max HP by. Negative numbers can decrease the skill. If the <tt>value-percent-multipler</tt> is true, the number is a percentage (where 100 is the same as no multiplier, 200 is the same as a doubling the stat, and 50 is the same as halving the stat). If <tt>value-percent-multipler</tt> is false, then the number is static, meaning it increases or decreases by the amount specified.
  
 
===max-ep===
 
===max-ep===
Max EP is ignored for boosts,just the <tt>regeneration</tt> attribute affects EP regeneration.
+
How much to effect the max EP by. Negative numbers can decrease the skill. If the <tt>value-percent-multipler</tt> is true, the number is a percentage (where 100 is the same as no multiplier, 200 is the same as a doubling the stat, and 50 is the same as halving the stat). If <tt>value-percent-multipler</tt> is false, then the number is static, meaning it increases or decreases by the amount specified. If you need to have the ability regain ep on units you need to set it up like this. <max-ep value="0"  regeneration="5"/>
  
 
===sight===
 
===sight===
How much to effect the sight by. Negative numbers can decrease the skill.
+
How much to effect the sight by. Negative numbers can decrease the skill. If the <tt>value-percent-multipler</tt> is true, the number is a percentage (where 100 is the same as no multiplier, 200 is the same as a doubling the stat, and 50 is the same as halving the stat). If <tt>value-percent-multipler</tt> is false, then the number is static, meaning it increases or decreases by the amount specified.
  
 
===attack-strenght===
 
===attack-strenght===
How much to effect the attack strength by (note the necessary misspelling of the tag). Negative numbers can decrease the skill.
+
How much to effect the attack strength by (note the necessary misspelling of the tag). Negative numbers can decrease the skill. If the <tt>value-percent-multipler</tt> is true, the number is a percentage (where 100 is the same as no multiplier, 200 is the same as a doubling the stat, and 50 is the same as halving the stat). If <tt>value-percent-multipler</tt> is false, then the number is static, meaning it increases or decreases by the amount specified.
  
 
===attack-range===
 
===attack-range===
How much to effect the attack range by. Negative numbers can decrease the skill.
+
How much to effect the attack range by. Negative numbers can decrease the skill. If the <tt>value-percent-multipler</tt> is true, the number is a percentage (where 100 is the same as no multiplier, 200 is the same as a doubling the stat, and 50 is the same as halving the stat). If <tt>value-percent-multipler</tt> is false, then the number is static, meaning it increases or decreases by the amount specified.
  
 
===armor===
 
===armor===
How much to effect the armor by. Negative numbers can decrease the skill.
+
How much to effect the armor by. Negative numbers can decrease the skill. If the <tt>value-percent-multipler</tt> is true, the number is a percentage (where 100 is the same as no multiplier, 200 is the same as a doubling the stat, and 50 is the same as halving the stat). If <tt>value-percent-multipler</tt> is false, then the number is static, meaning it increases or decreases by the amount specified.
  
 
===move-speed===
 
===move-speed===
How much to effect the move speed by. Negative numbers can decrease the skill.
+
How much to effect the move speed by. Negative numbers can decrease the skill. If the <tt>value-percent-multipler</tt> is true, the number is a percentage (where 100 is the same as no multiplier, 200 is the same as a doubling the stat, and 50 is the same as halving the stat). If <tt>value-percent-multipler</tt> is false, then the number is static, meaning it increases or decreases by the amount specified.
  
 
===production-speed===
 
===production-speed===
How much to effect the production speed (produce/morph/upgrade) by. Negative numbers can decrease the skill.
+
How much to effect the production speed by. Negative numbers can decrease the skill. If the <tt>value-percent-multipler</tt> is true, the number is a percentage (where 100 is the same as no multiplier, 200 is the same as a doubling the stat, and 50 is the same as halving the stat). If <tt>value-percent-multipler</tt> is false, then the number is static, meaning it increases or decreases by the amount specified.
  
 
===Particles===
 
===Particles===
It's also possible to apply particle systems to the attacker and/or the affected units. These tags are optional. The attack can be given a particle system with the <tt>originator-particle-file</tt> tag, while the affected units can be given one with the <tt>affected-particle-file</tt> tag. The originator particle effect only occurs if the attack boost is being used (it must be affecting at least one unit, which can include the user if <tt>include-self</tt> is set to true.
+
It's also possible to apply particle systems to the attacker and/or the affected units. These tags are optional. The attack can be given a particle system with the <tt>originator-particle-file</tt> tag, while the affected units can be given one with the <tt>affected-particle-file</tt> tag.
  
==Examples==
+
==Example==
===Example 1===
 
 
In this example, all swordmen in the same faction within a five cell radius of the attacking unit will gain 10% more HP and +20 attack. The affected units will all have the particle system defined in the <tt>glow_particles.xml</tt> file applied to them.
 
In this example, all swordmen in the same faction within a five cell radius of the attacking unit will gain 10% more HP and +20 attack. The affected units will all have the particle system defined in the <tt>glow_particles.xml</tt> file applied to them.
  
Line 88: Line 77:
 
<unit-type name="swordman" />
 
<unit-type name="swordman" />
 
</target>
 
</target>
<max-hp value="110" value-percent-multiplier="true" />
+
<max-hp value="110" value-percent-multipler="true" />
 
<max-ep value="0"/>
 
<max-ep value="0"/>
 
<sight value="0"/>
 
<sight value="0"/>
Line 99: Line 88:
 
<affected-particle-file path="glow_particles.xml"/>
 
<affected-particle-file path="glow_particles.xml"/>
 
</particles>
 
</particles>
</attack-boost>
 
</syntaxhighlight>
 
 
===Example 2===
 
In this system, all nearby enemy units (on a different team) within 10 tiles will have their move speed reduced by 20% (so it's 80% of the original). Multiple boosts will not stack (as that could result in extremely slow speeds). There are no used particle effects. In this example, all optional tags have been excluded.
 
 
<syntaxhighlight lang="xml">
 
<attack-boost>
 
<allow-multiple-boosts value="false" />
 
<radius value="10" />
 
<target value="foe" include-self="false" />
 
<move-speed value="80" value-percent-multiplier="true" />
 
 
</attack-boost>
 
</attack-boost>
 
</syntaxhighlight>
 
</syntaxhighlight>

Please note that all contributions to MegaGlest are considered to be released under the Creative Commons Attribution Share Alike (see MegaGlest:Copyrights for details). If you do not want your writing to be edited mercilessly and redistributed at will, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource. Do not submit copyrighted work without permission!

To edit this page, please answer the question that appears below (more info):

Cancel Editing help (opens in new window)

Template used on this page: