From ZDoom Wiki
Jump to navigation Jump to search
Note: Wait! Stop! Before you copy this actor's definition into your mod, remember the following things:
  1. You do not need to copy that actor, since it is already defined.
  2. In fact, it's not just useless, it's actually harmful as it can cause problems.
  3. If you want to modify it, or use a modified version, using inheritance is the way to go.
  4. The actor definitions here are put on the wiki for reference purpose only. Learn from them, don't copy them.
  5. There is only one exception: if what you want is changing Ammo capacity, you need to create a new type from Ammo.
Basic armor pickup
Actor type Internal Game MiniZDoomLogoIcon.png (ZDoom)
DoomEd Number None Class Name BasicArmorPickup

Classes: InventoryArmorBasicArmorPickup

BasicArmorPickups are armor items that replace any existing armor with themselves if the player's armor points are less than this item provides. The base class BasicArmorPickup is never used directly. It is always the base class for predefined items (like Doom's green armor) or for items defined in DECORATE. BasicArmorPickup items can be placed in the inventory. If that is done they will activate automatically when the previous armor has worn off.

BasicArmorPickup sets the INVENTORY.AUTOACTIVATE flag by default. However, if you want to define an item that doesn't automatically activate you can clear this flag again.

DECORATE definition

ACTOR BasicArmorPickup : Armor native
  Inventory.MaxAmount 0


BasicArmorPickups use the basic Inventory properties to define their behavior as inventory items. They also define a few new properties to define their behavior as armor.

  • Armor.SaveAmount amount
The amount of armor that this item gives.
  • Armor.SavePercent percentage
The percentage of damage that the armor absorbs.
Percentage is specified as a floating point value between 0.0 and 100.0 which is converted internally to a floating point value between 0.0 and 1.0
  • Armor.MaxFullAbsorb amount
The amount of damage that this armor will fully absorb per tic.
  • Armor.MaxAbsorb amount
The maximum amount of damage (after adjustment) that this armor will absorb per tic.

In addition, the DamageFactor property can be used to make protective armors (or potentially, cursed armors). The armor first absorbs damage normally, as determined by its SavePercent, MaxAbsorb and MaxFullAbsorb properties, and the damage factor is applied to the remaining damage. In doing so, the damage factor does not protect the armor itself, but only the wearer.


This armor will absorb the first 50 damage dealt at 100%, and will absorb 75% of the remaining damage done:

actor RedArmor : BasicArmorPickup 92
  inventory.pickupmessage "Picked up the HyperArmor!"
  inventory.icon "ARM5A0"
  armor.saveamount 300
  armor.savepercent 75
  armor.maxfullabsorb 50
    ARM5 A 6
    ARM5 B 7 bright

For example, if the player wearing this had 300% armor and 100% health, and was hit with an attack totalling 70 damage, the armor would take the first 50, leaving 20 left. Of that 20, the armor would take an additional 15 damage, and the player would take only 5 damage. After the attack, he would have 235% armor and 95% health left.

This armor will absorb at a 50% rate, but will only absorb up to 25 damage per tic:

actor WeakArmor : BasicArmorPickup 97
  inventory.pickupmessage "Picked up some mediocre armor."
  inventory.icon "ARM7A0"
  armor.saveamount 75
  armor.savepercent 50
  armor.maxabsorb 25
    ARM7 A 6
    ARM7 B 7 bright

For example, if the player wearing this had 75% armor and 100% health, and was hit with an attack totalling 70 damage, the armor would absorb 25 and the player would take the remaining 45 damage. After such an attack he would have 50% armor and 55% health.

If, however, he were to take only 30 damage, the armor would absorb 50% of it (15) and the health would take the other 15; even though the armor didn't reach its maxabsorb value, the savepercent is only 50.

actor PyroArmor : BasicArmorPickup 102
  Inventory.PickupMessage "Picked up a fire-resistant armor."
  Inventory.Icon "ARM9A0"
  DamageFactor "Fire", 0.0
  Armor.SaveAmount 150
  Armor.SavePercent 75

For example, if the player wearing wearing this had 150% armor and 100% health, and was hit by an attack inflicting 80 fire damage, the armor would absorb 75% of the damage normally (so 60 points), and since the remaining 20 points of damage are of the "fire" type against which it protects completely, the player would lose no health. After the attack, he would therefore have 90% armor and 100% health. A second identical attack would leave him with armor 30% and health 100%; and after a third attack the armor would be entirely depleted absorbing the first 30 points of damage and would no longer protect him against the 50 remaining points of the attack, he would thus be left with armor 0% and health 50%.