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 bonus
Actor type Internal Game MiniZDoomLogoIcon.png (ZDoom)
DoomEd Number None Class Name BasicArmorBonus

Classes: InventoryArmorBasicArmorBonus

BasicArmorBonus are armor items that add points to the player's current armor. The base class BasicArmorBonus is never used directly. It is always the base class for predefined items (like Doom's armor bonus) or for items defined in DECORATE.

BasicArmorBonus sets the INVENTORY.AUTOACTIVATE and INVENTORY.ALWAYSPICKUP flags by default. However, if you want to define an item that doesn't use these settings you can clear them again.

DECORATE definition

ACTOR BasicArmorBonus : Armor native
  Inventory.MaxAmount 0
  Armor.SavePercent 33.335


BasicArmorBonus uses 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.SavePercent percentage
The percentage of dealt 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.MaxSaveAmount amount
Sets the maximum amount of armor you can reach by picking up this item.
  • Armor.SaveAmount amount
The amount of armor that this item gives.
  • Armor.MaxBonus amount
The amount of armor you obtain additionally to your save amount value.
  • Armor.MaxBonusMax amount
The maximum additional save amount you can obtain with the armor.


actor 2xArmorBonus : BasicArmorBonus 11009
  armor.maxsaveamount 250
  armor.savepercent 50
  armor.saveamount 2
  inventory.icon "ABO2A0"
    ABO2 AB 3
    ABO2 C 6
    ABO2 B 3

Examples: BasicMaxArmorBonus (Skulltag Imported)

actor MaxArmorBonus : BasicArmorBonus 2015
  spawnid 176
  radius 20
  height 16
  inventory.pickupmessage "Picked up a max armor bonus."
  inventory.icon "ARM1A0"
  armor.savepercent 33.33333
  armor.saveamount 1
  armor.maxsaveamount 200
  armor.maxbonus 1
  armor.maxbonusmax 50