User Tools

Site Tools


modding:xml:damage_descriptor

This is an old revision of the document!


A damage descriptor string is used to specify a type and amount of damage. It also includes modifiers for special damage (such as radioactive contamination). A damage string consists of a single damage specifier plus zero or more special damage modifiers. Each element is separated by semi-colons. Damage descriptor strings are generally used in weapon definitions. For example:

damage="blast:5d6; radiation1; momentum4; WMD4"

Damage Specifier

A damage specifier consists of a damage type followed by a colon and then a dice range. The damage type can be one of the following strings:

  • laser
  • kinetic
  • particle
  • blast
  • ion
  • thermo
  • positron
  • plasma
  • antimatter
  • nano
  • graviton
  • singularity
  • darkAcid
  • darkSteel
  • darkLightning
  • darkFire
  • generic

For example (surrounding quotes are omitted):

laser:1d4

The above specifies 1-4 points of laser damage.

Special Damage Modifiers

A special damage modifier consists of a string immediately followed by a number from 1 to 7. For example, the modifier “radiation1” specifies that the target will be hit with level 1 radiation.

The following special damage modifiers are defined:

blinding This modifier does not affect shields, but if it strikes a target's armor, it blinds its short-range scanner. The chance that the target will be blinded depends on the level of blinding specified in the modifier:

  • 1 = 4%
  • 2 = 16%
  • 3 = 36%
  • 4 = 64%
  • 5 = 100%
  • 6 = 144%
  • 7 = 196%

The value above is modified by the armor's blindingDamageAdj attribute (e.g., if blindingDamageAdj=“50” then the above values are multiplied by 50/100). Armor of level 6 and above is intrinsically immune to blinding damage (unless otherwise specified by a blindingDamageAdj attribute).

If a target is blinded, the blindness will last for a number of seconds (real time) equal to half the damage.

Any weapon with the blinding modifier is incapable of doing damage to the target armor regardless of its damage value.

The blinding damage modifier is generally associated with the ion damage type.

device If damage with this modifier strikes a target's armor, it has a chance of damaging a random device on the target. To determine the chance of damage, use the table under blinding damage and adjust it by the deviceDamageAdj attribute on the armor. Armor of level 11 and above is intrinsically immune to device damage. Like blinding damage, this damage modifier is generally associated with the ion damage type.

deviceDisrupt Device disrupt damage is similar to device damage above except the effect is not permanent. The affected device is disrupted for a number of seconds equal to twice the damage.

disintegration Disintegration is a fearsome effect that instantly destroys an unshielded target hit by it. Certain kinds of armor are immune to disintegration, but beyond that there is no chance of avoiding its effect. As of version 1.07 there are no levels in the effect–that is, “disintegration1” is the same as “disintegration7”. For future compatibility, always use “disintegration1”.

EMP The EMP damage modifier causes a target to lose control, if it hits the target's armor. To determine the chance that a target will be affected, use the table under blinding damage and adjust it by the EMPDamageAdj attribute on the armor. Armor of level 9 and above is intrinsically immune to EMP damage, unless otherwise specified. The EMP effect lasts for a number of seconds equal to half the damage.

Like blinding damage, this modifier is incapable of doing damage to the target armor regardless of its damage value and is generally associated with the ion damage type.

mining This modifier is used for mining devices. The chance that useable ore will be produced is depends on the mining level of the modifier and on the mining difficulty of the target. The base probability is determined from the modifier:

  • 1 = 4%
  • 2 = 10%
  • 3 = 20%
  • 4 = 34%
  • 5 = 52%
  • 6 = 74%
  • 7 = 100%

When an object is hit with this effect, the <OnMining> event will be fired.

momentum This modifier imparts momentum on to any object it hits. The momentum imparted is proportional to the square of the modifier level.

radiation When an unshielded target is hit with this effect, the target is contaminated by radiation. For future compatibility, always use “radiation1” for this effect.

shatter This effect destroys an unshielded target massing less than a certain value. The mass value depends on the modifier level:

  • 1 = <50 tons
  • 2 = <250 tons
  • 3 = <1,250 tons
  • 4 = <6,250 tons
  • 5 = <31,250 tons
  • 6 = <156,250 tons
  • 7 = <781,250 tons

shield This modifier multiplies the damage done when hitting shields. The amount of damage done to shields is increased by a certain percent depending on the difference between the damage modifier and the shield level. For example, if “shield5” damage hits a level 3 shield the difference is +2 levels. Conversely, if “shield3” hits a level 5 shield, the difference is -2 levels. Consult the following table to determine the damage increase:

  • ⇐ -4 levels = no extra damage
  • -3 levels = 50% extra damage
  • -2 levels = 100% extra damage (damage is doubled)
  • -1 level = 150% extra damage
  • same level = 200% extra damage (damage is trebled)
  • +1 level = 250% extra damage
  • +2 levels = 300% extra damage (damage is quadrupled)
  • +3 levels = 350% extra damage
  • +4 levels = 400% extra damage

Note: In versions prior to 1.07 the calculation of extra damage was different. It used a formula of 1+((n*n)/2) to compute the effective level of the damage modifier. In 1.07 and above the damage modifier corresponds directly to a shield level. Any extension marked as 1.1 or above will use the new method; older extensions will use the backward-compatible calculation.

WMD Normally, weapons do not do very much damage to stations, because a weapon's area of effect is small compared to the size of a station. The WMD modifier specifies the percentage of the weapon's damage that will affect the station:

  • 1 = 4%
  • 2 = 10%
  • 3 = 20%
  • 4 = 34%
  • 5 = 52%
  • 6 = 74%
  • 7 = 100%

See Also

modding/xml/damage_descriptor.1349754722.txt.gz · Last modified: 2014/12/27 04:40 (external edit)