DeHackEd / BEX Reference/Weapon Block

This block allows editing of player weapon characteristics.

Back to DeHackEd / BEX Reference

Syntax

A brief explanation of the syntax description:

Items in angle brackets (< >) are required.

Items in square brackets ([ ]) are optional.

All fields in the block are optional. Fields not provided will not be changed.

  Weapon <weapon number>
  Ammo type = <ammo number>
  Deselect frame = <frame number>
  Select frame = <frame number>
  Bobbing frame = <frame number>
  Shooting frame = <frame number>
  Firing frame = <frame number>
  # The fields below are Eternity extensions
  Ammo per shot = <number>
  MBF21 Bits = <number or flag set>

Explanation of special information:

weapon number is a weapon type number, which must be one of the following:

  Number  Weapon type
  ------------------------
  0       Fist
  1       Pistol
  2       Shotgun
  3       Chaingun
  4       Rocket Launcher
  5       Plasma Rifle
  6       BFG 9000
  7       Chainsaw
  8       Super Shotgun

ammo number is an ammo type number, which must be one of the following:

  Number  Ammo type
  -----------------
  0       Bullets
  1       Shells
  2       Cells
  3       Rockets
  5       None

Fields

Ammo type = <number>

The type number, as given above, of the ammo type used by this weapon. Note that 4 is not a valid ammo type; do not use it. Also, in Eternity, any weapon can be safely given ammo type 5, none. In DOOM, giving any weapon other than the fist or chainsaw this type would cause the shotgun's max ammo to decrease on every use.

Deselect frame = <frame number>

A weapon enters this frame when the player changes to another weapon or dies.

Select frame = <frame number>

A weapon enters this frame when the player changes to it.

Bobbing frame = <frame number>

A weapon stays in this frame when the player is walking around without firing.

Shooting frame = <frame number>

A weapon enters this frame when the player hits the fire key.

Firing frame = <frame number>

This frame is used to display muzzle flashes when a weapon is fired.

Ammo per shot = <number>

This field is an Eternity extension which allows editing of the amount of ammo a weapon must have to be fired and uses on each shot (there is no point to these values being separate). Unless enabled through explicit use of this field in DeHackEd, this value is not used by the game engine, for compatibility reasons.

MBF21 Bits = <number or flag set>

Optional flags to set for this weapon. It's either a sum or list of flag names separated by |, comma or +:

• NOTHRUST (1): weapon won't push enemies
• SILENT (2): weapon won't alert enemies
• NOAUTOFIRE (4): weapon won't autofire in A_WeaponReady
• FLEEMELEE (8): weapon causes monsters to backpedal if player gets close and MBF settings enable that
• AUTOSWITCHFROM (16): change away from this weapon if ammo for a better one is found (like it happens with fist in DOOM)
• NOAUTOSWITCHTO (32): cannot be automatically switched to