View source for Armordefs.lua

This file sorts units into different armor classes. Weapons can deal different amount of damage to different armor classes. 

=Location=
<code>armordefs.lua</code> is a file in the <code>Gamedata/</code> directory of a Spring Game.

=Source=
The engine source code which parses the data from this file is viewable here:

* {{sourcelink|file=rts/Sim/Misc/DamageArrayHandler.cpp}}

=Details=
By default a damage class named "default" exists and every unit is in it.
So if all your weapons only deal "default" damage then this file is not needed.

=Example=
<code><pre>
local armorDefs = {
	tanks = {
		"supertank",
		"megatank",
	},

	infantry = {
		"dude",
	},
}

--NOTE: only needed for <95.0 (before engine was expecting a cryptic format)
if not(Game) or not(Game.version) then
  for categoryName, categoryTable in pairs(armorDefs) do
    local t = {}
    for _, unitName in pairs(categoryTable) do
      t[unitName] = 1
    end
    armorDefs[categoryName] = t
  end
end

return armorDefs</pre></code>

=Weapon Example=
Goes with above example, a weapon that deals 60 damage to infantry but only 5 damage to tanks:
<code><pre>
...
damage = {
	infantry = 60,
	tanks = 5,
},
...
</pre></code>

=Shields=
In engine versions =< 96.0 the damage dealt to shields is the weapon's ''default'' value.
This [https://springrts.com/mantis/view.php?id=4450 changed] in v98.0

Putting a shield into an armor class is analogical to units, ie. the armorDefs entry is its weaponDef name:
<code><pre>
armorDefs = {
  units = { "shieldbot" },
  shields = { "shieldbot_shield" }
}</pre></code>

Then in some damage table:
<code><pre>damage = {
  default = 123,
  units = 456,
  shields = 789
}</pre></code>

=Links to more Examples=
[http://code.google.com/p/zero-k/source/browse/trunk/mods/zk/gamedata/armordefs.lua zero-K]<br>
Contains scripting to take into account various things like EMP damage.

[http://code.google.com/p/springtutorialgame/source/browse/trunk/SpringTutorialGame.sdd/Gamedata/armordefs.lua|Spring Tutorial Game]<br>
Uses default damage class, except for one unit that is "armored."

[http://sourceforge.net/p/mwspring/code/899/tree/Gamedata/armordefs.lua MechCommander: Legacy]<br>
Automatically assigns units to an armor class based on [[Gamedev:UnitDefs|UnitDef]] tags and custom params.

[[Category:gamedata]]