DRL Wiki - User contributions [en]

User:Rabinowitz

2013-09-01T16:52:13Z

Rabinowitz:

We had two shell-box, seventy-five energy cells, high-powered railgun, a spitter full of acid, and a whole galaxy of multicolored mod packs... and also green armor, blue armor, red armor, two nuclear plasma rifle and dozen of large med-packs. Not that we needed all that for the trip, but once you get locked into a serious stuff collection, the tendency is to push it as far as you can.

The only thing that really worried me was the nuclear plasma rifles. There is nothing in the world more helpless and irresponsible and depraved than a doomguy waiting for weapon recharge, and I knew we'd get into that rotten stuff pretty soon.

Modding:Constants

2013-07-18T16:42:01Z

Rabinowitz:

Constants and Enumerations are common in any game and DoomRL is no exception. Internally, as most programmers are aware, these are integers. But to modders they are all important magic values, looked up here.

== Engine Enums ==

==== ItemType ====

Every item has a type that determines how the engine treats it.

{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TItemType'''
|-
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_NONE
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_RANGED
|-
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_NRANGED
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_ARMOR
|-
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_MELEE
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_AMMO
|-
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_PACK
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_POWER
|-
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_BOOTS
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_TELE
|-
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_LEVER
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_AMMOPACK
|}

==== BodyTarget ====

Sources of damage must specify a body target to determine which sources of armor are used. Inherent armor bonuses always apply.

{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TBodyTarget'''
|-
|style="vertical-align:top; padding-right: 2ex;"|TARGET_INTERNAL
|Protection from boots and armor will be ignored.
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|TARGET_TORSO
|Protection from armor counts but protection from boots does not.
|-
|style="vertical-align:top; padding-right: 2ex;"|TARGET_FEET
|Protection from boots counts but protection from armor does not.
|}

==== EqSlot ====

It is preferred to use the (equivalent) [[#Equip Slots|slot]] constants.

{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TEqSlot'''
|-
|style="vertical-align:top; padding-right: 2ex;"|EFTORSO
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EFWEAPON
|-
|style="vertical-align:top; padding-right: 2ex;"|EFBOOTS
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EFWEAPON2
|}

==== StatusEffect ====

[[Modding:Affects|Affects]] specify one of these status effects that will apply a color scheme to all the tiles on the HUD.

{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TStatusEffect'''
|-
|style="vertical-align:top; padding-right: 2ex;"|STATUSNORMAL
|No affects
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|STATUSINVERT
|Berserk (sic!)
|-
|style="vertical-align:top; padding-right: 2ex;"|STATUSRED
|Invincibility (sic!)
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|STATUSGREEN
|Environsuit
|-
|style="vertical-align:top; padding-right: 2ex;"|STATUSBLUE
|Light-Amp Goggle effect
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|STATUSMAGENTA
|Unused
|-
|style="vertical-align:top; padding-right: 2ex;"|STATUSYELLOW
|Unused
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|STATUSGRAY
|Unused
|-
|style="vertical-align:top; padding-right: 2ex;"|STATUSWHITE
|Unused
|}

==== DamageType ====

Sources of damage usually specify a damage type that determines how the damage regards protection, resistances, gibbing, and other things. For details on the differences between the damage types, look [[Damage type|here]].

{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TDamageType'''
|-
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_BULLET 
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_MELEE 
|-
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_SHARPNEL [sic] 
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_ACID 
|-
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_FIRE 
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_PLASMA 
|-
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_SPLASMA 
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_IGNOREARMOR 
|}

==== AltFire ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TAltFire'''
|-
|style="vertical-align:top; padding-right: 2ex;"|ALT_NONE
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ALT_CHAIN
|-
|style="vertical-align:top; padding-right: 2ex;"|ALT_THROW
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ALT_SCRIPT
|-
|style="vertical-align:top; padding-right: 2ex;"|ALT_AIMED
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ALT_SINGLE
|}

==== AltReload ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TAltReload'''
|-
|style="vertical-align:top; padding-right: 2ex;"|RELOAD_NONE
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|RELOAD_SCRIPT
|-
|style="vertical-align:top; padding-right: 2ex;"|RELOAD_FULL
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|RELOAD_DUAL
|-
|style="vertical-align:top; padding-right: 2ex;"|RELOAD_SINGLE
|}

==== ExplosionFlag ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=3 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TExplosionFlag'''
|-
|style="vertical-align:top; padding-right: 2ex;"|EFSELFHALF
|Deals half damage to the active being.
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EFSELFKNOCKBACK
|Gives extra knockback to the active being.
|-
|style="vertical-align:top; padding-right: 2ex;"|EFSELFSAFE
|Deals no damage to the active being.
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EFAFTERBLINK
|Blinks the screen after the explosion finishes.
|-
|style="vertical-align:top; padding-right: 2ex;"|EFCHAIN
|Causes secondary explosions (as the [[BFG 9000]]).
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EFHALFKNOCK
|Causes half the usual knockback.
|-
|style="vertical-align:top; padding-right: 2ex;"|EFNOKNOCK
|Doesn't cause knockback.
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EFRANDOMCONTENT
|Transmutes some cells in the explosion to the explosion's content cell; the rules is to transmute when damage is greater than 20.
|-
|style="vertical-align:top; padding-right: 2ex;"|EFNODISTANCEDROP
|
|}

====Level Flag====
{{Template:Level_Flags}}

====Light Flag====
{{Template:Light_Flags}}

== Constants ==

==== Maximums ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Maximums'''
|-
|style="vertical-align:top; padding-right: 2ex;"|MAXX || 78
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|MAXY || 20
|-
|style="vertical-align:top; padding-right: 2ex;"|BOSS_LEVEL || 25
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|MAXDEPTH || 26
|-
|style="vertical-align:top; padding-right: 2ex;"|MAXAFFECT || 12
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|MAX_INV_SIZE || 22
|-
|style="vertical-align:top; padding-right: 2ex;"|MAX_EQ_SIZE || 4
|}

==== Cellsets ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Cellsets'''
|-
|style="vertical-align:top; padding-right: 2ex;"|CELLSET_WALLS
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|CELLSET_FLOORS
|-
|style="vertical-align:top; padding-right: 2ex;"|CELLSET_CORPSES
|}

==== Challenges ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Challenges'''
|-
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_BERSERK
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_MARKSMANSHIP
|-
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_SHOTGUNNERY
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_LIGHTTRAVEL
|-
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_IMPATIENCE
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_HASTE
|-
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_PURITY
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_REDALERT
|-
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_CARNAGE
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_MASOCHISM
|-
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_100
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_PACIFISM
|-
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_HUMANITY
|}

==== Difficulty ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Difficulty'''
|-
|style="vertical-align:top; padding-right: 2ex;"|DIFF_EASY
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|DIFF_MEDIUM
|-
|style="vertical-align:top; padding-right: 2ex;"|DIFF_HARD
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|DIFF_VERYHARD
|-
|style="vertical-align:top; padding-right: 2ex;"|DIFF_NIGHTMARE
|}

==== PlayerRank ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''PlayerRank'''
|-
|style="vertical-align:top; padding-right: 2ex;"|RANKEXP
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|RANKSKILL
|}

==== Player Statistics ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Player Statistics'''
|-
|style="vertical-align:top; padding-right: 2ex;"|RANK_KILLTOTAL
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|RANK_KILLMELEE
|-
|style="vertical-align:top; padding-right: 2ex;"|RANK_KILLPISTOL
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|RANK_LEVEL
|-
|style="vertical-align:top; padding-right: 2ex;"|RANK_BADGE
|}

==== Equip Slots ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Equip Slots'''
|-
|style="vertical-align:top; padding-right: 2ex;"|SLOT_ARMOR
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|SLOT_WEAPON
|-
|style="vertical-align:top; padding-right: 2ex;"|SLOT_BOOTS
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|SLOT_PREPARED
|}

==== Colors ====
Usually, it is possible to specify a foreground color and a background color. Since DoomRL uses 4 bit color, the lowest 4 bits determine the foreground color, and the next 4 bits determine the background color (zero is black). Occasionally, one of these may conflict with one of the special color constants. See [[Modding:Color]] for details.

Also, note that the exact color the end-user sees may depend on his system settings.
For the basic 16 colors, the valkyrie string coloring escape is noted.
{{Template:Color}}
{{Template:Special_Color}}

== Flags ==

==== Item Flags ====
{{Template:Item_Flags}}

==== Being Flags ====
{{Template:Being_Flags}}

Some flags have no effect on non-player beings. Most trait flags are that way.

==== Cell Flags ====
{{Template:Cell_Flags}}

==== Generic Flags ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=3 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Generic Flags'''
|-
|style="vertical-align:top; padding-right: 2ex;"|F_OVERLAY
|This flag is related to the graphical version.
|}

==== Empty Flags ====
Empty flags are used with various functions to control the selection of random coords.

{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Empty Flags'''
|-
|style="vertical-align:top; padding-right: 2ex;"|EF_NOITEMS
|Excludes cells that contain an item.
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EF_NOBEINGS
|Excludes cells that contain a being.
|-
|style="vertical-align:top; padding-right: 2ex;"|EF_NOBLOCK
|Excludes cells that block movement (CF_BLOCKMOVE).
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EF_NOVISION
|Excludes cells that block vision (CF_BLOCKLOS).
|-
|style="vertical-align:top; padding-right: 2ex;"|EF_NOSTAIRS
|Excludes stairs (cells with an OnExit hook).
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EF_NOTELE
|Excludes cells with a teleporter (an item with ITEMTYPE_TELE).
|-
|style="vertical-align:top; padding-right: 2ex;"|EF_NOHARM
|Excludes hazardous cells (CF_HAZARD).
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EF_NOSAFE
|Excludes cells that are too near to the player (currently the threshold is less than or equal to distance of 5).
|-
|style="vertical-align:top; padding-right: 2ex;"|EF_NOSPAWN
|Excludes cells with LF_NOSPAWN.
|}

Template:Light Flags (0.9.9.7)

2013-07-18T16:30:56Z

Rabinowitz:

{{drltable|Light Flags|2|{{Table2Col
|es=background: #333;
|c1=font-family:monospace; text-align:right; vertical-align:top; padding:0px 2px;
|c2=padding:0px 2px;
|LFEXPLORED|This flag is set for explored cells. It can be modified to create computer map-like effects or Angel of Darkness-like effects.
|LFVISIBLE|This flag is set for cells in the player's current LOS. This flag is automatically recalculated on every player action. It may be useful to manually modify this flag if LOS needs to be updated more often.
|LFLIGHTED|This flag is always set on the same cells as LFVISIBLE; both flags must be set for a cell to be visible.
|LFDAMAGE|This is a bookkeeping flag for shotgun area-of-effect. Cells are set with this flag if they are calculated as in the shotgun blast but haven't yet been processed.
|LFFRESH|This is a bookkeeping flag for explosions. New corpses are set with this flag to keep them from being immediately destroyed. This flag can also be set to make any cell indestructible, but it may be cleared by the engine.
|LFPERMANENT|This flag marks a cell as being indestructible.
|LFCORNER|This flag only exists in debug builds of DoomRL. It identifies a cell that is visible but that enemies will not return fire from, ie, corner shooting.
|LFBLOOD|This flag marks a cell as being bloody. Bloody cells can only have cosmetic differences.
|LFNOSPAWN|
|LFMARKER1|
|LFMARKER2|
|}}
}}

Modding:Constants

2013-07-18T16:23:07Z

Rabinowitz:

Constants and Enumerations are common in any game and DoomRL is no exception. Internally, as most programmers are aware, these are integers. But to modders they are all important magic values, looked up here.

== Engine Enums ==

==== ItemType ====

Every item has a type that determines how the engine treats it.

{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TItemType'''
|-
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_NONE
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_RANGED
|-
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_NRANGED
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_ARMOR
|-
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_MELEE
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_AMMO
|-
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_PACK
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_POWER
|-
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_BOOTS
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_TELE
|-
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_LEVER
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_AMMOPACK
|}

==== BodyTarget ====

Sources of damage must specify a body target to determine which sources of armor are used. Inherent armor bonuses always apply.

{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TBodyTarget'''
|-
|style="vertical-align:top; padding-right: 2ex;"|TARGET_INTERNAL
|Protection from boots and armor will be ignored.
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|TARGET_TORSO
|Protection from armor counts but protection from boots does not.
|-
|style="vertical-align:top; padding-right: 2ex;"|TARGET_FEET
|Protection from boots counts but protection from armor does not.
|}

==== EqSlot ====

It is preferred to use the (equivalent) [[#Equip Slots|slot]] constants.

{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TEqSlot'''
|-
|style="vertical-align:top; padding-right: 2ex;"|EFTORSO
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EFWEAPON
|-
|style="vertical-align:top; padding-right: 2ex;"|EFBOOTS
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EFWEAPON2
|}

==== StatusEffect ====

[[Modding:Affects|Affects]] specify one of these status effects that will apply a color scheme to all the tiles on the HUD.

{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TStatusEffect'''
|-
|style="vertical-align:top; padding-right: 2ex;"|STATUSNORMAL
|No affects
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|STATUSINVERT
|Berserk (sic!)
|-
|style="vertical-align:top; padding-right: 2ex;"|STATUSRED
|Invincibility (sic!)
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|STATUSGREEN
|Environsuit
|-
|style="vertical-align:top; padding-right: 2ex;"|STATUSBLUE
|Light-Amp Goggle effect
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|STATUSMAGENTA
|Unused
|-
|style="vertical-align:top; padding-right: 2ex;"|STATUSYELLOW
|Unused
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|STATUSGRAY
|Unused
|-
|style="vertical-align:top; padding-right: 2ex;"|STATUSWHITE
|Unused
|}

==== DamageType ====

Sources of damage usually specify a damage type that determines how the damage regards protection, resistances, gibbing, and other things. For details on the differences between the damage types, look [[Damage type|here]].

{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TDamageType'''
|-
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_BULLET 
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_MELEE 
|-
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_SHARPNEL [sic] 
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_ACID 
|-
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_FIRE 
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_PLASMA 
|-
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_SPLASMA 
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_IGNOREARMOR 
|}

==== AltFire ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TAltFire'''
|-
|style="vertical-align:top; padding-right: 2ex;"|ALT_NONE
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ALT_CHAIN
|-
|style="vertical-align:top; padding-right: 2ex;"|ALT_THROW
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ALT_SCRIPT
|-
|style="vertical-align:top; padding-right: 2ex;"|ALT_AIMED
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ALT_SINGLE
|}

==== AltReload ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TAltReload'''
|-
|style="vertical-align:top; padding-right: 2ex;"|RELOAD_NONE
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|RELOAD_SCRIPT
|-
|style="vertical-align:top; padding-right: 2ex;"|RELOAD_FULL
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|RELOAD_DUAL
|-
|style="vertical-align:top; padding-right: 2ex;"|RELOAD_SINGLE
|}

==== ExplosionFlag ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=3 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TExplosionFlag'''
|-
|style="vertical-align:top; padding-right: 2ex;"|EFSELFHALF
|Deals half damage to the active being.
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EFSELFKNOCKBACK
|Gives extra knockback to the active being.
|-
|style="vertical-align:top; padding-right: 2ex;"|EFSELFSAFE
|Deals no damage to the active being.
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EFAFTERBLINK
|Blinks the screen after the explosion finishes.
|-
|style="vertical-align:top; padding-right: 2ex;"|EFCHAIN
|Causes secondary explosions (as the [[BFG 9000]]).
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EFHALFKNOCK
|Causes half the usual knockback.
|-
|style="vertical-align:top; padding-right: 2ex;"|EFNOKNOCK
|Doesn't cause knockback.
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EFRANDOMCONTENT
|Transmutes some cells in the explosion to the explosion's content cell; the rules is to transmute when damage is greater than 20.
|}

====Level Flag====
{{Template:Level_Flags}}

====Light Flag====
{{Template:Light_Flags}}

== Constants ==

==== Maximums ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Maximums'''
|-
|style="vertical-align:top; padding-right: 2ex;"|MAXX || 78
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|MAXY || 20
|-
|style="vertical-align:top; padding-right: 2ex;"|BOSS_LEVEL || 25
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|MAXDEPTH || 26
|-
|style="vertical-align:top; padding-right: 2ex;"|MAXAFFECT || 5
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|MAX_INV_SIZE || 22
|-
|style="vertical-align:top; padding-right: 2ex;"|MAX_EQ_SIZE || 4
|}

==== Cellsets ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Cellsets'''
|-
|style="vertical-align:top; padding-right: 2ex;"|CELLSET_WALLS
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|CELLSET_FLOORS
|-
|style="vertical-align:top; padding-right: 2ex;"|CELLSET_CORPSES
|}

==== Challenges ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Challenges'''
|-
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_BERSERK
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_MARKSMANSHIP
|-
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_SHOTGUNNERY
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_LIGHTTRAVEL
|-
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_IMPATIENCE
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_HASTE
|-
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_PURITY
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_REDALERT
|-
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_CARNAGE
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_MASOCHISM
|-
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_100
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_PACIFISM
|-
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_HUMANITY
|}

==== Difficulty ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Difficulty'''
|-
|style="vertical-align:top; padding-right: 2ex;"|DIFF_EASY
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|DIFF_MEDIUM
|-
|style="vertical-align:top; padding-right: 2ex;"|DIFF_HARD
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|DIFF_VERYHARD
|-
|style="vertical-align:top; padding-right: 2ex;"|DIFF_NIGHTMARE
|}

==== PlayerRank ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''PlayerRank'''
|-
|style="vertical-align:top; padding-right: 2ex;"|RANKEXP
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|RANKSKILL
|}

==== Player Statistics ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Player Statistics'''
|-
|style="vertical-align:top; padding-right: 2ex;"|RANK_KILLTOTAL
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|RANK_KILLMELEE
|-
|style="vertical-align:top; padding-right: 2ex;"|RANK_KILLPISTOL
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|RANK_LEVEL
|-
|style="vertical-align:top; padding-right: 2ex;"|RANK_BADGE
|}

==== Equip Slots ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Equip Slots'''
|-
|style="vertical-align:top; padding-right: 2ex;"|SLOT_ARMOR
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|SLOT_WEAPON
|-
|style="vertical-align:top; padding-right: 2ex;"|SLOT_BOOTS
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|SLOT_PREPARED
|}

==== Colors ====
Usually, it is possible to specify a foreground color and a background color. Since DoomRL uses 4 bit color, the lowest 4 bits determine the foreground color, and the next 4 bits determine the background color (zero is black). Occasionally, one of these may conflict with one of the special color constants. See [[Modding:Color]] for details.

Also, note that the exact color the end-user sees may depend on his system settings.
For the basic 16 colors, the valkyrie string coloring escape is noted.
{{Template:Color}}
{{Template:Special_Color}}

== Flags ==

==== Item Flags ====
{{Template:Item_Flags}}

==== Being Flags ====
{{Template:Being_Flags}}

Some flags have no effect on non-player beings. Most trait flags are that way.

==== Cell Flags ====
{{Template:Cell_Flags}}

==== Generic Flags ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=3 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Generic Flags'''
|-
|style="vertical-align:top; padding-right: 2ex;"|F_OVERLAY
|This flag is related to the graphical version.
|}

==== Empty Flags ====
Empty flags are used with various functions to control the selection of random coords.

{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Empty Flags'''
|-
|style="vertical-align:top; padding-right: 2ex;"|EF_NOITEMS
|Excludes cells that contain an item.
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EF_NOBEINGS
|Excludes cells that contain a being.
|-
|style="vertical-align:top; padding-right: 2ex;"|EF_NOBLOCK
|Excludes cells that block movement (CF_BLOCKMOVE).
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EF_NOVISION
|Excludes cells that block vision (CF_BLOCKLOS).
|-
|style="vertical-align:top; padding-right: 2ex;"|EF_NOSTAIRS
|Excludes stairs (cells with an OnExit hook).
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EF_NOTELE
|Excludes cells with a teleporter (an item with ITEMTYPE_TELE).
|-
|style="vertical-align:top; padding-right: 2ex;"|EF_NOHARM
|Excludes hazardous cells (CF_HAZARD).
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EF_NOSAFE
|Excludes cells that are too near to the player (currently the threshold is less than or equal to distance of 5).
|-
|style="vertical-align:top; padding-right: 2ex;"|EF_NOSPAWN
|Excludes cells with LF_NOSPAWN.
|}

Modding:Cell

2013-07-18T16:21:08Z

Rabinowitz:

Cells are what make up the game world. You walk over them, open them, travel down their stairs, and blow up their barrels. Unlinke [[Modding:Being|beings]] and [[Modding:Item|items]], cells aren't instantiated. All cells of a given type are exactly the same except for hp and light flags both of which must be accessed through the [[Modding:Level#API|Level API]].

== Prototype ==
Once a cell is registered, changing the lua object will have no effect on how the cell operates (although it can affect some of the APIs). The exception to this is that hooks can be redefined (although which hooks are present can't be changed). Cell prototypes are declared by passing a table with the desired properties and hooks to the global Cells function. Required properties are underlined. Cells prototypes are stored in a global table called cells that can be indexed by string id or numeric id.

{|class="wikitable" style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
! colspan="3" style="background: darkred; color: yellow; font-size: 120%; text-align: center"|Cell Prototype
{{Table3Col
|es=background: #333;
|c1=font-weight:bold; text-align:right; vertical-align:top; padding:0px 2px;
|c2=vertical-align:top; padding:0px 2px;
|c3=padding:0px 2px;
|'''string'''|name|This is the name of the cell that is displayed in game messages.
|'''string'''|id|This is the string id that is used to reference the cell prototype internally. (A numeric id called nid is generated automatically.) The default is the first word of the name in all lowercase.
|'''string'''|ascii|This should be a single character string. It is used to display cells on the map.
|'''string'''|asciilow|If the ascii property is not once of the standard visible ASCII characters, then asciilow should be one of these standard characters to accomodate players that don't have support for an extended character selection. Whether or not to use asciilow is configurable by the player in config.lua.
|'''integer'''|sprite|This indicates the sprite used to represent the cell in the graphical version. Use 0 to indicate no sprite.
|[[Modding:Constants#Colors|Color]]|color|This is the color used to draw the cell when it is in the player's line-of-sight. The default is LIGHTGRAY.
|[[Modding:Constants#Colors|Color]]|color_dark|This is the color used to draw the cell when it has been explored, but is not in the player's line-of-sight. The default is DARKGRAY.
|'''string'''|color_id|If this is defined, then for the purposes of user color configuration, this is the cell's ID. Use this to force several cells to have the same color even if the user tries to redefine them.
|'''integer'''|effect|This is a multi-purpose cell property. Currently it is only used to specify the corresponding being ID for corpses (as 100 plus the being ID). As most corpses are [[Modding:Being#Prototype|generated automatically]], most modders won't need to worry about this. The default is 0.
|'''integer'''|armor|This is the amount of armor the cell has. All damage to the cell is reduced by this value (regardless of damage type, although some damage types may not affect the cell at all; see CF_FRAGILE). This can reduce damage to 0. If the cell's armor is 0, then it cannot be destroyed by damage. The default is 0.
|'''integer'''|hp|This is the initial amount of hp for the cell. If the cell is damaged, the hp for that particular cell (not the prototype) is reduced, and the cell isn't destroyed until it drops to 0. Cells with 0 hp must still be damaged to be destroyed. Be careful: changing cells after the beginning of the level doesn't usually update cells' current hp. The default is 0.
|[[Modding:Constants#Flags|Cell Flag '''list''']]|flags|The flags in this list will be included in the cell's flag set. A property called flag_set is automatically created containing these flags in set format. The default is an empty list.
|[[Modding:Cell|Cell ID]]|bloodto|If defined, then the cell will transmute to the given new cell when it is affected by blood. This must be a string id.
|[[Modding:Cell|Cell ID]]|destroyto|If the cell is destroyed, it will transmute to the given new cell. This must be a string id. The default is "floor".
|[[Modding:Constants#Cellsets|Cellset]]|set|The cellsets are groupings for cells. They aren't used very much. Most notably, beings will only leave corpses on cells in CELLSET_FLOORS. By default, the cell won't be included in a set.
|}}
|}

== Cell Flags ==
{{Template:Cell_Flags}}

== Engine Hooks ==
Although these hooks should be defined with a coord as the first argument, they are immediately translated into a new function that has x and y as its first two arguments. This is important when replacing the hooks after the fact or calling the hooks manually. For all hooks, the first argument is the coord of the cell that caused the hook.

{|class="wikitable" style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
! colspan="2" style="background: darkred; color: yellow; font-size: 120%; text-align: center"|Cell Hooks
{{Table2Col
|es=background: #333;
|c1=font-weight:bold; text-align:right; vertical-align:top; padding:0px 2px;
|c2=padding:0px 2px;
|'''void'''|[[#cell_OnEnter|OnEnter]]([[Modding:Coord|Coord]] c, [[Modding:Being|Being]] enterer)
|'''void'''|[[#cell_OnExit|OnExit]]([[Modding:Coord|Coord]] c)
|'''void'''|[[#cell_OnAct|OnAct]]([[Modding:Coord|Coord]] c, [[Modding:Being|Being]] actor)
|'''string'''|[[#cell_OnDescribe|OnDescribe]]([[Modding:Coord|Coord]] c)
|'''void'''|[[#cell_OnDestroy|OnDestroy]]([[Modding:Coord|Coord]] c)
|}}
|}

{{Anchor|cell_OnEnter}}
;OnEnter([[Modding:Coord|Coord]] c, [[Modding:Being|Being]] enterer)
:This hooks is called at the beginning of a being's turn if it is standing on the cell. (This triggers even if the being hasn't moved since its last turn.)
----
{{Anchor|cell_OnExit}}
;OnExit([[Modding:Coord|Coord]] c)
:This hook is called if the player uses the descend stairs action on the cell. That action is only allowed if this hook is defined. This hook also allows saving which is designed to work it the hook moves the player to the next level.
----
{{Anchor|cell_OnAct}}
;OnAct([[Modding:Coord|Coord]] c, [[Modding:Being|Being]] actor)
:This hook is called when a being opens or closes a cell. Opening and closing must be allowed by the CF_OPENABLE and CF_CLOSEABLE flags respectively.
----
{{Anchor|cell_OnDescribe}}
;OnDescribe([[Modding:Coord|Coord]] c) → '''string'''
:If this hook is defined, then it is used instead of the cell name for in game messages.
----
{{Anchor|cell_OnDestroy}}
;OnDestroy([[Modding:Coord|Coord]] c)
:This hook is called after a cell is destroyed. (The hook for the previous cell is used even though the cell has already been transmuted to the destroyto value.)

Template:Cell Flags

2013-07-18T16:13:29Z

Rabinowitz: Redirected page to Template:Cell Flags (0.9.9.7)

#REDIRECT [[Template:Cell_Flags_(0.9.9.7)]]

Template:Cell Flags (0.9.9.7)

2013-07-18T16:12:47Z

Rabinowitz: Created page with "{{drltable|Cell Flags|2|{{Table2Col |es=background: #333; |c1=font-family:monospace; text-align:right; vertical-align:top; padding:0px 2px; |c2=padding:0px 2px; |CF_BLOCK..."

{{drltable|Cell Flags|2|{{Table2Col
|es=background: #333;
|c1=font-family:monospace; text-align:right; vertical-align:top; padding:0px 2px;
|c2=padding:0px 2px;
|CF_BLOCKMOVE|Cells with this flag block movement and projectiles.
|CF_BLOCKLOS|Cells with this flag block vision.
|CF_CORPSE|This flag is set for autogenerated corpses. Only cells with this flag can be ressurected. The being created by resurrection can be specified by setting the cell's effect parameter to 100 + being.id. Note that the "corpse" cell does not have this flag. To include this cell, use Level.is_corpse.
|CF_NOCHANGE|Currently, this flag is only checked by the map powerups. The map powerups reveal cells with this flag (as well as CF_BLOCKMOVE cells).
|CF_NORUN|The run command (not the run tactic) will stop the player before he steps on a cell with this flag.
|CF_PUSHABLE|Cells with this flag can be pushed (like barrels in DoomRL). Pushing is mostly hard-coded.
|CF_FRAGILE|Cells with this flag can be destroyed by any damage type (assuming they have HP or armor) whereas cells cannot usually be damaged by bullet, melee, shrapnel, or piercing damage.
|CF_HAZARD|This flag should be set for cells that are dangerous to step on. The AI will usually avoid these tiles. This flag is also used with the EF_NOHARM empty flag.
|CF_OVERLAY|This flag is related to the graphical version. Overlays are drawn OVER a base tile.
|CF_MULTISPRITE|This flag is related to the graphical version. Cells which have rotations (walls being the main example) need this flag.
|CF_STICKWALL|This flag is related to the graphical version. When a multisprite wall is calculating its rotations it takes stickwalls into account. That way wall-like cells (such as doors) will be attached to the multisprite walls correctly.
|CF_LIQUID|This flag is used to mark liquid cells (water, acid, lava). Currently, it is only checked by Level.flood which will flood over CELLSET_FLOORS cells and CF_LIQUID cells.
|CF_OPENABLE|This flag indicates that the cell can be opened. What happens when the cells is opened is determined by the cell's OnAct hook.
|CF_CLOSABLE|As CF_OPENABLE, but for the close command.
|CF_RUNSTOP|Cells with this flag will stop the player's run when the player is orthogonally adjacent. Contrast with CF_NORUN.
|CF_NUKABLE|Cells with this flag will be destroyed be a nuke even if they are normally not destructible.
|CF_CRITICAL|Cells with this flag should usually not be altered or destroyed be the game. It is currently only checked by the flooding level event. Stairs have this flag.
|CF_HIGHLIGHT|This flag determines whether the light or dark color variant is used when a StatusEffect overlay is being applied.
|CF_BLOODY|When a being walks on one of these cells, its feet won't become less bloody. (See CF_BLOODY.)
|CF_VBLOODY|When a being walks on one of these cells, its feet will become bloody and it will temporarily leave a trail of blood.
|CF_STAIRS|Stairs are marked with this flag. (New stairs cells should include this.)
|CF_RAISABLE|
|}}
}}

Modding:Item

2013-07-18T16:06:21Z

Rabinowitz:

DoomRL has many kinds of items. Weapons, powerups, levers, and other things are all items. Items inherit from the [[Modding:Thing|Thing]] class which handles some basic properties in common with beings.

== Prototype ==
New items are created from item prototypes. Think of an item prototype as a recipe for creating new items. There can be multiple pistols, but they all came from the same prototype. Prototypes are declared by passing a table with the desired properties to the Items function. The available properties depend on the item type. [[#Engine Hooks|Engine hooks]] may also be included in the prototype. Mostly, the prototype's properties just describe items' initial properties (occasionally with different names). Items' properties can also mostly be changed after they are instantiated. Required fields are underlined. Sometimes required fields can safely be omitted, but this will generate a message in the log file. All item prototypes are stored in a global table called items. This table can be indexed by id or nid.

{{drltable|Item Prototype|3|{{Table3Col
|es=background: #333;
|c1=font-weight:bold; text-align:right; vertical-align:top; padding:0px 2px;
|c2=vertical-align:top; padding:0px 2px;
|c3=padding:0px 2px;
|{{modarg|string}}|name|This is the item's name.
|{{modarg|string}}|id|This is the item's sid. It must be distinct from other string ids. (The numeric id is automatically generated and stored in the nid field of the prototype.) It defaults to the first word of the name in all lowercase.
|{{modarg|value list}}|overlay|This describes of color transformation of the item's sprite. It is only used in the graphical version. This will create overlay_red, overlay_blue, overlay_green, and overlay_alpha attributes for the prototype.
|{{modarg|Color}}|color|This is the item's color. The default is LIGHTGRAY.
|{{modarg|string}}|color_id|For the purpose of custom color bindings, this id will be used for the item. Multiple items (like levers) can have the same color_id to prevent them from being distinguished.
|{{modarg|integer}}|level|This is an [[Item Generation|item generation]] parameter. The default is 0.
|{{modarg|integer}}|weight|This is an [[Item Generation|item generation]] parameter.
|{{modarg|integer}}|sprite|This is the item's sprite. This field is only relevant to the graphical version; use 0 for no sprite.
|{{modarg|value list}}|coscolor|Some sprites (such as armor and boots) are color-neutral to begin: ''coscolor'' determines the color of the sprite in these cases. The list must be written in this form: {red,green,blue,alpha}, where all of these values range from 0.0 to 1.0.
|{{modarg|value list}}|glow|Creates a customized "glow" effect around the sprite. See ''coscolor'' for table specifications.
|{{modarg|Item Flag List}}|flags|The flags in this list will automatically be included in the item's flag set. The default is an empty list. Some flags may be added automatically. The prototype will automatically be given a flagSet property containing the flags in set format.
|{{modarg|ItemSet ID}}|set|If included, this item will belong to the given item set. This will modify the item's OnEquip and OnRemove hooks.
|{{modarg|string}}|firstmsg|If included, this message will be displayed when the an item with this prototype is picked up for the first time. This will modify the item's OnFirstPickup hook.
|{{modarg|integer}}|res_bullet|This is the item's res_bullet. The default is 0.
|{{modarg|integer}}|res_melee|This is the item's res_melee. The default is 0.
|{{modarg|integer}}|res_shrapnel|This is the item's res_shrapnel. The default is 0.
|{{modarg|integer}}|res_acid|This is the item's res_acid. The default is 0.
|{{modarg|integer}}|res_fire|This is the item's res_fire. The default is 0.
|{{modarg|integer}}|res_plasma|This is the item's res_plasma. The default is 0.
|{{modarg|ItemType}}|type|This is the item's itype. It also determines which other properties can be used in the prototype.
|}}
}}

=== Armor or Boots ===
These are the fields used by ITEMTYPE_ARMOR and ITEMTYPE_BOOTS.

{{drltable|Armor or Boots Prototype|3|{{Table3Col
|es=background: #333;
|c1=font-weight:bold; text-align:right; vertical-align:top; padding:0px 2px;
|c2=vertical-align:top; padding:0px 2px;
|c3=padding:0px 2px;
|{{modarg|string}}|desc|This is the armor's description that is displayed in the inventory screen.
|{{modarg|integer}}|armor|This is the armor's armor property.
|{{modarg|integer}}|durability|This is the armor's maxdurability as well as its initial durability. The default is 100. (This should still be 100 for armors with no durability, as no durability is achieved by a flag.)
|{{modarg|integer}}|knockmod|This is the armor's knockmod. The default is 0.
|{{modarg|integer}}|movemod|This is the armor's movemod. The default is 0.
|{{modarg|string}}|ascii|This is the armor's picture. It should be a length one string. The default is "[" for body armor and ";" for boots.
|}}
}}

=== Consumable ===
These are the fields used by ITEMTYPE_PACK. This includes mods and relics.

{{drltable|Consumable Prototype|3|{{Table3Col
|es=background: #333;
|c1=font-weight:bold; text-align:right; vertical-align:top; padding:0px 2px;
|c2=vertical-align:top; padding:0px 2px;
|c3=padding:0px 2px;
|{{modarg|string}}|desc|This is the pack's description that is displayed in the inventory screen.
|{{modarg|string}}|mod_letter|This is the shorthand letter by which the pack will be recognized as a mod. Do not fill this value unless this item is meant to be a mod pack.
|{{modarg|function}}|OnUse|Packs must provide an OnUse hook.
|{{modarg|string}}|ascii|This is the pack's picture. It should be a length one string. The default is "+".
|}}
}}

=== Powerup ===
These are the fields used by ITEMTYPE_POWER.

{{drltable|Powerup Prototype|3|{{Table3Col
|es=background: #333;
|c1=font-weight:bold; text-align:right; vertical-align:top; padding:0px 2px;
|c2=vertical-align:top; padding:0px 2px;
|c3=padding:0px 2px;
|{{modarg|function}}|OnPickup|Powerups must provide an OnPickup hook.
|{{modarg|string}}|ascii|This is the powerup's picture. It should be a length one string. The default is "^".
|}}
}}

=== Ammo ===
These are the fields used by ITEMTYPE_AMMO.

{{drltable|Ammo Prototype|3|{{Table3Col
|es=background: #333;
|c1=font-weight:bold; text-align:right; vertical-align:top; padding:0px 2px;
|c2=vertical-align:top; padding:0px 2px;
|c3=padding:0px 2px;
|{{modarg|string}}|desc|This is the ammo's description that is displayed in the inventory screen.
|{{modarg|integer}}|ammo|This is the ammo's initial ammo property.
|{{modarg|integer}}|ammomax|This is the ammo's ammomax property.
|{{modarg|string}}|ascii|This is the ammo's picture. It should be a length one string. The default is "|".
|}}
}}

=== Ammo Pack ===
These are the fields used by ITEMTYPE_AMMOPACK.

{{drltable|Ammo Pack Prototype|3|{{Table3Col
|es=background: #333;
|c1=font-weight:bold; text-align:right; vertical-align:top; padding:0px 2px;
|c2=vertical-align:top; padding:0px 2px;
|c3=padding:0px 2px;
|{{modarg|string}}|desc|This is the ammo pack's description that is displayed in the inventory screen.
|{{modarg|integer}}|ammo|This is the ammo pack's initial ammo property.
|{{modarg|integer}}|ammomax|This is the ammo pack's ammomax property.
|{{modarg|string}}|ammo_id|This is the ammo pack's ammoid property.
|{{modarg|string}}|ascii|This is the ammo pack's picture. It should be a length one string. The default is "!".
|}}
}}

=== Ranged Weapon ===
These fields are used by ITEMTYPE_RANGED.

{{drltable|Ranged Weapon Prototype|3|{{Table3Col
|es=background: #333;
|c1=font-weight:bold; text-align:right; vertical-align:top; padding:0px 2px;
|c2=vertical-align:top; padding:0px 2px;
|c3=padding:0px 2px;
|{{modarg|string}}|desc|This is the weapon's description that is displayed in the inventory screen.
|{{modarg|string}}|damage|This should be a string like "2d4"; the weapon's damage_dice and damage_sides will be parsed from this.
|{{modarg|DamageType}}|damagetype|This is the weapon's damagetype.
|{{modarg|string}}|psprite|This is the sprite used to represent the player when this weapon is equipped. It is only relevant in the graphical version.
|{{modarg|string}}|group|This is the weapon's group for purposes of kill counting. The used weapon groups are "weapon-melee", "weapon-pistol", "weapon-shotgun", "weapon-chain", "weapon-rocket", "weapon-plasma", and "weapon-bfg". The default is "weapon-other".
|{{modarg|string}}|ammo_id|This is the weapon's ammoID.
|{{modarg|integer}}|fire|This is the weapon's usetime. The default is 10.
|{{modarg|integer}}|acc|This is the weapon's acc. The default is 0.
|{{modarg|integer}}|ammomax|This is the weapon's ammomax and the weapon's initial ammo.
|{{modarg|integer}}|radius|This is the weapon's blastradius. The default is 0.
|{{modarg|integer}}|shots|This is the weapon's shots. The default is 0 (which will still give one shot).
|{{modarg|integer}}|shotcost|This is the weapon's shotcost. The default is 0 (which will still require one ammo).
|{{modarg|AltFire}}|altfire|This is the weapon's altfire. The default is ALT_NONE.
|{{modarg|AltReload}}|altreload|This is the weapon's altreload. The default is RELOAD_NONE.
|{{modarg|string}}|altfirename|This is the name the game uses for the weapon's alternate fire mode. Most of the AltFire constants provide defaults.
|{{modarg|string}}|altreloadname|This is the name the game uses for the weapon's alternate reload mode. Most of the AltReload constants provide defaults.
|{{modarg|string}}|sound_id|The sound_id will be used to look up sounds if there are no sounds defined for the weapon's actual id. By convention, this is set as the usual wielder's id when applicable.
|{{modarg|Missile ID}}|overcharge|This field is currently unused.
|{{modarg|Missile ID}} or {{modarg|Missile Prototype}}|missile|This is the weapon's missile. (It will be translated into an nid. To use a shotgun missile, the weapon must have the IF_SHOTGUN flag.) If this property is a table, it will be used to declare a new missile with the same id as the weapon.
|{{modarg|string}}|ascii|This is the weapon's picture. It should be a length one string. The default is "}".
|}}
}}

=== Natural Ranged Weapon ===
These fields are used by ITEMTYPE_NRANGED. Natural ranged weapons are usually defined inline in a {{modarg|Being}} definition.

{{drltable|Natural Ranged Weapon Prototype|3|{{Table3Col
|es=background: #333;
|c1=font-weight:bold; text-align:right; vertical-align:top; padding:0px 2px;
|c2=vertical-align:top; padding:0px 2px;
|c3=padding:0px 2px;
|{{modarg|string}}|damage|This should be a string like "2d4"; the weapon's damage_dice and damage_sides will be parsed from this.
|{{modarg|DamageType}}|damagetype|This is the weapon's damagetype.
|{{modarg|string}}|group|This is the weapon's group for purposes of kill counting. The used weapon groups are "weapon-melee", "weapon-pistol", "weapon-shotgun", "weapon-chain", "weapon-rocket", "weapon-plasma", and "weapon-bfg". The default is "weapon-other".
|{{modarg|integer}}|fire|This is the weapon's usetime. The default is 10.
|{{modarg|integer}}|acc|This is the weapon's acc. The default is 0.
|{{modarg|integer}}|radius|This is the weapon's blastradius. The default is 0.
|{{modarg|integer}}|shots|This is the weapon's shots. The default is 0 (which will still give one shot).
|{{modarg|string}}|sound_id|The sound_id will be used to look up sounds if there are no sounds defined for the weapon's actual id. By convention, a natural weapon's soundID is the usual wielder's id.
|{{modarg|Missile ID}} or {{modarg|Missile Prototype}}|missile|This is the weapon's missile. (It will be translated into an nid. To use a shotgun missile, the weapon must have the IF_SHOTGUN flag.) If this property is a table, it will be used to declare a new missile with the same id as the weapon.
|{{modarg|string}}|ascii|This is the weapon's picture. It should be a length one string. The default is "?".
|}}
}}

=== Melee Weapon ===
These fields are used by ITEMTYPE_MELEE.

{{drltable|Melee Weapon Prototype|3|{{Table3Col
|es=background: #333;
|c1=font-weight:bold; text-align:right; vertical-align:top; padding:0px 2px;
|c2=vertical-align:top; padding:0px 2px;
|c3=padding:0px 2px;
|{{modarg|string}}|desc|This is the weapon's description that is displayed in the inventory screen.
|{{modarg|string}}|damage|This should be a string like "2d4"; the weapon's damage_dice and damage_sides will be parsed from this.
|{{modarg|DamageType}}|damagetype|This is the weapon's damagetype.
|{{modarg|string}}|psprite|This is the projectile sprite used with the weapon. It is only relevant in the graphical version.
|{{modarg|string}}|group|This is the weapon's group for purposes of kill counting. The used weapon groups are "weapon-melee", "weapon-pistol", "weapon-shotgun", "weapon-chain", "weapon-rocket", "weapon-plasma", and "weapon-bfg". The default is "weapon-other".
|{{modarg|integer}}|fire|This is the weapon's usetime. The default is 10.
|{{modarg|integer}}|acc|This is the weapon's acc. The default is 0.
|{{modarg|integer}}|shotcost|This is the weapon's shotcost. The default is 0 (which will still require one ammo).
|{{modarg|AltFire}}|altfire|This is the weapon's altfire. The default is ALT_NONE.
|{{modarg|string}}|altfirename|This is the name the game uses for the weapon's alternate fire mode. Most of the AltFire constants provide defaults.
|{{modarg|Missile ID}} or {{modarg|Missile Prototype}}|missile|This is the missile used if for the throw alternate fire mode.
|{{modarg|Item ID}}|throw_id|In the case where the melee weapon can be thrown, this is the item that appears after the item is thrown. It defaults to the item itself.
|{{modarg|string}}|ascii|This is the weapon's picture. It should be a length one string. The default is "\".
|}}
}}

=== Lever ===
These fields are used by ITEMTYPE_LEVER. DoomRL levers usually also have a target_area custom property.

{{drltable|Lever Prototype|3|{{Table3Col
|es=background: #333;
|c1=font-weight:bold; text-align:right; vertical-align:top; padding:0px 2px;
|c2=vertical-align:top; padding:0px 2px;
|c3=padding:0px 2px;
|{{modarg|string}}|desc|This is the full description of the lever used if the player has BF_LEVERSENSE2.
|{{modarg|string}}|good|This is the qualitative description of the lever used if the player has BF_LEVERSENSE1. By convention, this should be "beneficial", "neutral", or "dangerous".
|{{modarg|integer}}|fullchance|The level generation code will set the lever's target_area to the full map fullchance percent of the time. The default is 0. (To be fair, the level generation code won't generate custom levers.)
|{{modarg|string}}|warning|This message will be displayed by the level generation code if the fullchance roll succeeds.
|null|color_id|This field is required for levers. By convention, it is set to "lever".
|null|sound_id|If the particular lever doesn't have sound bindings, the game will use the sound ID to look for sound bindings. By default, this is "lever".
|{{modarg|string}}|ascii|This is the lever's picture. It should be a length one string. The default is "&".
|}}
}}

=== Teleporter ===
These fields are used by ITEMTYPE_TELE. The built-in teleport item has a custom target property. This can be set to any coord to control the destination.

{{drltable|Teleporter Prototype|3|{{Table3Col
|es=background: #333;
|c1=font-weight:bold; text-align:right; vertical-align:top; padding:0px 2px;
|c2=vertical-align:top; padding:0px 2px;
|c3=padding:0px 2px;
|{{modarg|function}}|OnEnter|This hook is required for teleporters.
|{{modarg|string}}|ascii|This is the teleporter's picture. It should be a length one string. The default is "*".
|}}
}}

=== Flags ===
{{Template:Item_Flags}}

== Engine Hooks ==
These hooks can give greater flexibility for how items work. For some item types, a hook provides the primary function. Sometimes, the engine will add to explicitly defined hooks, but this shouldn't interfere with a modder's use of the hooks. However, modders should be careful when changing hooks.
{|class="wikitable" style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
! colspan="2" style="background: darkred; color: yellow; font-size: 120%; text-align: center"|Item Hooks
{{Table2Col
|es=background: #333;
|c1=font-weight:bold; text-align:right; vertical-align:top; padding:0px 2px;
|c2=padding:0px 2px;
|{{modarg|boolean}}|[[#item_OnCreate|OnCreate]]({{modarg|Item}} self)
|{{modarg|boolean}}|[[#item_OnPickup|OnPickup]]({{modarg|Item}} self, {{modarg|Being}} getter)
|{{modarg|boolean}}|[[#item_OnFirstPickup|OnFirstPickup]]({{modarg|Item}} self, {{modarg|Being}} getter)
|{{modarg|boolean}}|[[#item_OnPickupCheck|OnPickupCheck]]({{modarg|Item}} self, {{modarg|Being}} getter)
|{{modarg|boolean}}|[[#item_OnUse|OnUse]]({{modarg|Item}} self, {{modarg|Being}} user)
|{{modarg|boolean}}|[[#item_OnUseCheck|OnUseCheck]]({{modarg|Item}} self, {{modarg|Being}} user)
|{{modarg|boolean}}|[[#item_OnReload|OnReload]]({{modarg|Item}} self, {{modarg|Being}} reloader)
|{{modarg|boolean}}|[[#item_OnAltFire|OnAltFire]]({{modarg|Item}} self, {{modarg|Being}} firer)
|{{modarg|boolean}}|[[#item_OnAltReload|OnAltReload]]({{modarg|Item}} self, {{modarg|Being}} reloader)
|{{modarg|boolean}}|[[#item_OnEquip|OnEquip]]({{modarg|Item}} self, {{modarg|Being}} equipper)
|{{modarg|boolean}}|[[#item_OnEquipTick|OnEquipTick]]({{modarg|Item}} self, {{modarg|Being}} wearer)
|{{modarg|boolean}}|[[#item_OnEquipCheck|OnEquipCheck]]({{modarg|Item}} self, {{modarg|Being}} equipper)
|{{modarg|boolean}}|[[#item_OnRemove|OnRemove]]({{modarg|Item}} self, {{modarg|Being}} wearer)
|{{modarg|boolean}}|[[#item_OnKill|OnKill]]({{modarg|Item}} self, {{modarg|Being}} dier, {{modarg|Being}} wearer)
|{{modarg|boolean}}|[[#item_OnHitBeing|OnHitBeing]]({{modarg|Item}} self, {{modarg|Being}} attacker, {{modarg|Being}} target)
|{{modarg|boolean}}|[[#item_OnEnter|OnEnter]]({{modarg|Item}} self, {{modarg|Being}} enterer)
|{{modarg|boolean}}|[[#item_OnFire|OnFire]]({{modarg|Item}} self, {{modarg|Being}} firer)
|{{modarg|boolean}}|[[#item_OnFired|OnFired]]({{modarg|Item}} self, {{modarg|Being}} firer)
|}}
|}

{{Anchor|item_OnCreate}}
;OnCreate({{modarg|Item}} self)
:This hook is called when the item is created. For ammo, beware: the game creates and destroys ammo items liberally as a normal part of ammo management.
----
{{Anchor|item_OnPickup}}
;OnPickup({{modarg|Item}} self, {{modarg|Being}} getter)
:When an item is picked up, this hook is called with the being that is picking the item up. This is most commonly used to implement powerups.
----
{{Anchor|item_OnFirstPickup}}
;OnFirstPickup({{modarg|Item}} self, {{modarg|Being}} getter)
:When an item with a given id is picked up for the first time, the function is called. This only works for items that go into the inventory.
----
{{Anchor|item_OnPickupCheck}}
;OnPickupCheck({{modarg|Item}} self, {{modarg|Being}} getter) → '''boolean'''
:When a being tries to pick up an item, this function is called with the being that is trying to pick it up. If the return value is true, then the being is allowed to pick the item up, otherwise the being can't. For the player, both cases include the item in the player's previously found items. (This can affect OnFirstPickup.)
----
{{Anchor|item_OnUse}}
;OnUse({{modarg|Item}} self, {{modarg|Being}} user) → '''boolean'''
:This hook is called when levers are used and when packs are used with the being that it using the item. For packs, if the return value is true, the item is consumed, otherwise it is left in the inventory. For levers, the return value is ignored and it is safe not to have a return value.
----
{{Anchor|item_OnUseCheck}}
;OnUseCheck({{modarg|Item}} self, {{modarg|Being}} user) → '''boolean'''
:This hook is called called before OnUse for levers and packs. If the return value is false, then the being can't use the item, otherwise it can. For levers, this can control whether the lever statistic is increased.
----
{{Anchor|item_OnReload}}
;OnReload({{modarg|Item}} self, {{modarg|Being}} reloader) → '''boolean'''
:If it is declared, this hook is called when a weapon is reloaded. If the return value is false, then the normal reload procedure is aborted. This can be used to prevent reloading or to implement a custom reloading mechanism (like for the [[Acid Spitter]]). If true is returned, the weapon is reloaded normally afterwards.
----
{{Anchor|item_OnAltFire}}
;OnAltFire({{modarg|Item}} self, {{modarg|Being}} firer) → '''boolean'''
:This hook works exactly like the OnFire hook, except it is called when the weapon's alternate fire mode is used for weapons with ALT_SCRIPT altfire.
----
{{Anchor|item_OnAltReload}}
;OnAltReload({{modarg|Item}} self, {{modarg|Being}} reloader)
:If the weapon's altreload is RELOAD_SCRIPT, then this hook is called with when the weapon's alternate reload mode is used.
----
{{Anchor|item_OnEquip}}
;OnEquip({{modarg|Item}} self, {{modarg|Being}} equipper)
:This hook is called when the item is equipped in any equipment slot. Due to a bug, equipper is the active being. This is always correct during normal play, but modders must be careful when manually equipping items with this hook.
----
{{Anchor|item_OnEquipTick}}
;OnEquipTick({{modarg|Item}} self, {{modarg|Being}} wearer)
:While this item is equipped in any slot (including the prepared slot), this function is called on each of the being's actions. (Despite the name, it probably won't be called on every tick; it depends on the being's speed.)
----
{{Anchor|item_OnEquipCheck}}
;OnEquipCheck({{modarg|Item}} self, {{modarg|Being}} equipper) → '''boolean'''
:This function is called (before OnEquip) when the player tries to equip an item. If the return value is true, then the player is allowed to equip the item; otherwise the player isn't allowed to equip the item.
----
{{Anchor|item_OnRemove}}
;OnRemove({{modarg|Item}} self, {{modarg|Being}} wearer)
:This hook is called when a being unequips the item, or when the item is otherwise removed from the being's equipment. This includes armor being destroyed by damage. Like OnEquip, this is called with the active being which can cause problems especially if this hook is called for armor destruction.
----
{{Anchor|item_OnKill}}
;OnKill({{modarg|Item}} self, {{modarg|Being}} dier, {{modarg|Being}} wearer)
:When a being dies, this hook is called on all of the active being's equipment. This includes the prepared slot. (Weapons can check what slot they are in inside of this hook.)
----
{{Anchor|item_OnHitBeing}}
;OnHitBeing({{modarg|Item}} self, {{modarg|Being}} attacker, {{modarg|Being}} target) → '''boolean'''
:For weapons with no blastradius, this hook is called whenever a being is hit with the weapon. This hook is called before applying damage. If the return value is true, damage is applied as usual. Otherwise, the damage phase is skipped.
----
{{Anchor|item_OnEnter}}
;OnEnter({{modarg|Item}} self, {{modarg|Being}} enterer)
:This function is called whenever a being enters a cell that has the item lying on the floor. For the player, this supresses the usual "There is an item lying here" message. This is used in DoomRL to implement teleports.
----
{{Anchor|item_OnFire}}
;OnFire({{modarg|Item}} self, {{modarg|Being}} firer) → '''boolean'''
:This hook is called when a weapon is fired. This only works for normal firing, not alternative firing (see OnAltFire). This hook is called before a target is selected. If the return value is true, then the rest of the normal firing operation is aborted. If the return value is false, then it continues as usual.
----
{{Anchor|item_OnFired}}
;OnFired({{modarg|Item}} self, {{modarg|Being}} firer)
:This hook is called after a weapon is fired. This is after the entire usual firing procedure including damage, etc. Currently, this only works for the player.

== Properties ==
Items also have all the [[Modding:Thing|Thing]] properties in addition to those listed below. For items, the meaning of the resistance fields vary depending on the item type. For armor and boots, the resistances are applied only to attacks to the corresponding target. For other equipment, the resistance applies to all attacks. For non-equipment, the resistances aren't used. Also, some properties are only valid for armor, and some are only valid for weapons. For these purposes, armor are items with itype ITEMTYPE_ARMOR and ITEMTYPE_BOOTS and weapons are items with itype ITEMTYPE_AMMO, ITEMTYPE_MELEE, ITEMTYPE_NRANGED, ITEMTYPE_RANGED, and ITEMTYPE_AMMOPACK. Properties of the incorrect type are always indexable, but they may share a memory address with properties of the opposite type, so modders should only use this feature very carefully. The type of such properties is noted. Also, the meaning of many fields is slightly different depending on the itype; these differences are also described.

{{drltable|Item|3|{{Table3Col
|es=background: #333;
|c1=font-weight:bold; text-align:right; vertical-align:top; padding:0px 2px;
|c2=vertical-align:top; padding:0px 2px;
|c3=padding:0px 2px;
|{{modarg|ItemType}}|itype|This determines the basic features of the item. ITEMTYPE_NONE has no features; it can't be picked up or used. ITEMTYPE_RANGED can be picked up and wielded as a ranged weapon. ITEMTYPE_NRANGED is like ITEMTYPE_RANGED, but it isn't designed to exist on the map. ITEMTYPE_ARMOR can be picked up and equipped as armor. ITEMTYPE_MELEE can be picked up and wielded as a melee weapon. ITEMTYPE_AMMO is always a new ammo type that can be picked up and stacked. ITEMTYPE_PACK items can be picked up and used. ITEMTYPE_POWER items are consumed when they are picked up. ITEMTYPE_BOOTS can be picked up and worn as boots. ITEMTYPE_TELE have no special features, but by convention they interact with OnEnter. ITEMTYPE_LEVER have special description routines, and they can be used while on the floor. ITEMTYPE_AMMOPACK can be picked up and wielded in the prepared slot. They provide reloading benefits. While it is possible to change an item's itype, this should almost never be done. If it is done, care must be taken to account for overlapping weapon and armor properties.
|{{modarg|byte}}|armor|For armor and boots, this is the amount of [[protection]] provided at full durability. Weapons in the main slot may also provide a (universal) protection bonus with this field.
|{{modarg|word}}|durability|For armor and boots, this is the current amount of durability of the item. This property is armor-specific.
|{{modarg|word}}|maxdurability|For armor and boots, this is the maximum amount of durability. Most effects won't raise the durability above maxdurability. This property is armor-specific.
|{{modarg|integer}}|movemod|For armor and boots, this percentage movement speed modifier is applied while the item is equipped. This property is armor-specific.
|{{modarg|integer}}|knockmod|For armor and boots, this percentage [[knockback]] modifier is applied while the item is equipped. This property is armor-specific.
|[[Modding:Item|Item ID]]|ammoid|This must always be a number id. For ranged weapons, this is the item id of the kind of ammo the weapon uses. For ammo packs, this is the kind of ammo provided by the pack. This property is weapon-specific.
|{{modarg|word}}|ammo|For ranged weapons, this is the amount of currently-loaded ammo. For ammo packs and ammo stacks, this is the amount of ammo inside. This property is weapon-specific.
|{{modarg|word}}|ammomax|For ranged weapons, this is the size of the magazine. For ammo stacks, this is the maximum stack size (unaffected by BF_BACKPACK). For ammo packs, this is the initial amount of ammo. This property is weapon-specific.
|{{modarg|word}}|acc|For ranged and melee weapons, this is an [[accuracy]] modifier applied to attacks with the weapon. This property is weapon-specific.
|{{modarg|word}}|damage_sides|For weapons, this is the number of dice rolled for damage (e.g. the X of XdY). This property is weapon-specific.
|{{modarg|word}}|damage_dice|For weapons, this is the number of sides on each die rolled for damage (e.g. the Y of XdY). This property is weapon-specific.
|{{modarg|integer}}|damage_add|For weapons, this is a flat bonus added to all damage rolls. This property is weapon-specific.
|{{modarg|Missile ID}}|missile|This must always be a number id. For ranged weapons, this is the missile used by the weapon. For melee weapons, this is the missile used by the throw alternate fire mode (if any). This property is weapon-specific.
|{{modarg|byte}}|blastradius|This is the [[Distance|radius]] of the explosion caused by a ranged weapon. This should be 0 for weapons with no explosion. This property is weapon-specific.
|{{modarg|byte}}|shots|This is the number of shots fired by a rapid-fire ranged weapon. This should be 0 (not 1) for single-shot weapons. This property is weapon-specific.
|{{modarg|byte}}|shotcost|This is the amount of ammo consumed by each shot with a ranged weapon. This should be 0 (not 1) for weapons that take only one ammo per shot. This property is weapon-specific.
|{{modarg|byte}}|reloadtime|This is the number of 0.1s intervals it takes (without modifiers) to reload a ranged weapon. This property is weapon-specific.
|{{modarg|byte}}|usetime|This is the number of 0.1s intervals it takes (without modifiers) to fire/use a weapon. This property is weapon-specific.
|{{modarg|DamageType}}|damagetype|This is the [[Damage type|type]] of the damage caused by a weapon. This property is weapon-specific.
|{{modarg|AltFire}}|altfire|This is the alternate fire mode of a weapon. For ALT_SCRIPT, the details depend on the OnAltFire hook. This property is weapon-specific.
|{{modarg|AltReload}}|altreload|This is the alternate reload mode of a ranged weapon. For RELOAD_SCRIPT, the details depend on the OnAltReload hook. This property is weapon-specific.
|{{modarg|string}}|desc|This is the string used to describe the item in the inventory list. For the description in the inventory sidebar, use .proto.desc. This property is read-only.
|{{modarg|Item Prototype}}|__proto|This is the item's prototype. You can access item prototype fields using this (e.g., item.__proto.color).
|}}
}}
== API ==

The [[Modding:Thing#API|Thing API]] can also be used with items.
{|class="wikitable" style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
! colspan="2" style="background: darkred; color: yellow; font-size: 120%; text-align: center"|Item Interface
{{Table2Col
|es=background: #333;
|c1=font-weight:bold; text-align:right; vertical-align:top; padding:0px 2px;
|c2=padding:0px 2px;
|{{modarg|Item}}|{{moddef|list|new|dot||Item ID|iid}}
|{{modarg|boolean}}|{{moddef|list|add_mod|cln||string|modletter}}
|{{modarg|boolean}}|{{moddef|list|can_mod|cln||string|modletter}}
|{{modarg|integer}}|{{moddef|list|get_mod|cln||string|modletter}}
|{{modarg|boolean}}|{{moddef|list|clear_mods|cln}}
|{{modarg|boolean}}|{{moddef|list|is_damaged|cln}}
|{{modarg|boolean}}|{{moddef|list|fix|cln||integer|amount}}
|{{modarg|table}}|{{moddef|list|get_mods|cln}}
|{{modarg|table}}|{{moddef|list|get_mod|ids|cln}}
|{{modarg|boolean}}|{{moddef|list|can_overcharge|cln}}
|{{modarg|boolean}}|{{moddef|list|check_mod_array|cln||string|nextmod|integer|techbonus}}
|}}
|}

{{moddef|desc|new|dot|Item|Item ID|iid}}
:This returns a newly allocated item create from the specified prototype. This item doesn't exist in the game yet; it must be dropped on the level, added to an inventory, or equipped.
----
{{moddef|desc|add_mod|cln|boolean|string|modletter}}
:Adds a mod to the item's mod list and sets the IF_MODIFIED flag. This does not apply any affects of the mod, it is only a primitive operation for accessing the mod list. ''modletter'' should be a single uppercase letter representing the mod. This will check modding restrictions (as [[#item_can_mod|can_mod]]) and return true on success, false on failure.
----
{{moddef|desc|can_mod|cln|boolean|string|modletter}}
:Determines if the given mod can be added to the item. ''modletter'' should be a single uppercase letter representing the mod. This will always use the player's techbonus. It also accounts for limits on the number of mods of a given type and various modability item flags.
----
{{moddef|desc|get_mod|cln|integer|string|modletter}}
:Counts the number of the given mod that have already been added to the item. ''modletter'' should be a single uppercase letter representing the mod.
----
{{moddef|desc|clear_mods|cln|boolean}}
:Clears the counts of all mods for the item. The does not undo the affects of the mods nor does it change any flags (including IF_MODIFIED).
----
{{moddef|desc|is_damaged|cln|boolean}}
:This determines if the item's durability is less than its maxdurability. For items with IF_NOREPAIR, this function always returns false. (So, in effect this function determines if the item needs to be repaired.)
----
{{moddef|desc|fix|cln|boolean|integer|amount}}
:This will increase the item's durability by amount, respecting maxdurability. It returns true is the item is no longer is_damaged. ''amount'' is optional; by default the item is completely repaired.
----
{{moddef|desc|get_mods|cln|table}}
:This will return a table that maps single character mod letters to the corresponding amount of mods that have been applied to the item. Mod letters that have not been applied are not included as keys.
----
{{moddef|list|get_mod|ids|cln|table}}
:As get_mods, but the table returned gives all mods in terms of their sID.
----
{{moddef|desc|can_overcharge|cln|boolean}}
:This will determine if the item can be overcharged. To be overcharged, an item can't already by overcharged (IF_DESTROY), and must be fully loaded. The ui part of overcharging is included. On success, IF_DESTROY and IF_NOUNLOAD are set, but other affects must be applied by the caller.
----
{{moddef|desc|check_mod_array|cln|boolean|string|nextmod|integer|techbonus}}
:This will check if the mod indicated by ''nextmod'' (the single uppercase character representing the mod) could form an assembly (given the provided techbonus). If so, the assembly is created on the item (if the player confirms the ui message) with all associated side effects. Returns true only if the assembly is actually created.

Template:Item Flags

2013-07-18T15:59:24Z

Rabinowitz: Redirected page to Template:Item Flags (0.9.9.7)

#REDIRECT [[Template:Item Flags (0.9.9.7)]]

Template:Item Flags (0.9.9.7)

2013-07-18T15:58:44Z

Rabinowitz: Created page with "{{drltable|Item Flags|2|{{Table2Col |es=background: #333; |c1=font-family:monospace; text-align:right; vertical-align:top; padding:0px 2px; |c2=padding:0px 2px; |IF_CHAMB..."

{{drltable|Item Flags|2|{{Table2Col
|es=background: #333;
|c1=font-family:monospace; text-align:right; vertical-align:top; padding:0px 2px;
|c2=padding:0px 2px;
|IF_CHAMBEREMPTY|For IF_PUMPACTION weapons, this flag indicates whether ammo is in the chamber or not.
|IF_UNIQUE|This flag is set for unique items. Unique items add a player history message when picked up as well as doing a screen blink. Unique items are also not destroyable.
|IF_EXOTIC|This flag is set for exotic items. This is used by the game to compile the special items list.
|IF_MODIFIED|This flag is automatically set for items that have been modded.
|IF_HALFKNOCK|If a weapon with this flag is wielded, all knockback against the wielder will be halved.
|IF_GLOBE|This is a marker flag for items that are disallowed in Angel of Masochism.
|IF_CURSED|Items with this flag cannot be unequipped.
|IF_RECHARGE|Items with this flag regenerate ammo or durability as with a [[Nano Pack]].
|IF_CLEAVE|Items with this flag give the wielder the benefits of the [[Traits#Blademaster|Blademaster]] trait (as [[Butcher's Cleaver]]).
|IF_NOAMMO|Items with this flag don't consume ammo when fired. For the player, a weapon still must have ammo loaded to be fired.
|IF_NECROCHARGE|Items with this flag recharge as with IF_RECHARGE, but reduce the weilder's health by 1 for each point of recharge (as with [[Necroarmor]]).
|IF_PUMPACTION|Ranged weapons with this flag must be pumped after each shot as with the combat shotgun.
|IF_SINGLERELOAD|Ranged weapons with this flag only reload one ammo at a time (as with the missile launcher) instead of all at once.
|IF_PISTOL|This flag indicates whether the weapon counts as a pistol for the purposes of the [[Traits#Son of a Gun|Son of a Gun]] and [[Traits#Dualgunner|Dualgunner]] traits. (For kill counting, the weapon group is used instead.)
|IF_SHOTGUN|This flag causes a weapon's missile to be treated as a shotgun id rather than a missile id. Also, this flag is used to decide if the [[Traits#Shottyman|Shottyman]] trait should count the weapon as a shotgun. (For kill counting, the weapon group is used instead.)
|IF_SPREAD|Ranged weapons with this flag fire three shots at once (as the [[tristar blaster]] and [[mancubus]] natural weapon). In 0.9.9.4, this flag is a bit buggy.
|IF_SCATTER|For ranged weapons with this flag, each shot is aimed at a different cell near the real target (as with the [[BFG 10K]]).
|IF_MODABLE|Allows a unique item to be fully modded.
|IF_SINGLEMOD|Restricts the number of allowed mods on the item to one. (For unique items, this must be used along with IF_MODABLE.)
|IF_DUALSHOTGUN|For multi-shot weapons, this flag eliminates all delay between shots and causes the firing sound to play only once.
|IF_AIHEALPACK|This flag allows the default AI to pick up and use the item.
|IF_NOUNLOAD|Ranged weapons with this flag cannot be unloaded.
|IF_NUKERESIST|Items with this flag will not be destroyed by nuking.
|IF_NODROP|Items with this flag will not be dropped when the carrier/wearer dies.
|IF_AUTOHIT|Weapons with this flag never miss (as with items modified by a sniper weapon pack).
|IF_SETITEM|This flag is automatically set for items that specify a set.
|IF_NODURABILITY|Armors and boots with this flag have no durability (as with items modified by an Onyx Armor Pack).
|IF_NODESTROY|Armors with this flag cannot be destroyed by damage. Also, items on the ground with this flag will not be destroyed by explosions.
|IF_NONMODABLE|Items with this flag cannot be modded.
|IF_NOREPAIR|Armors and boots with this flag cannot be repaired by normal methods (ie item:fix). Directly setting item.durability bypasses this prohibition. Usually set for shields.
|IF_ASSEMBLED|This flag is automatically set on assemblies. Items with this flag cannot be used for the base of any other assembly.
|IF_DESTROY|Weapons with this flag will be destroyed after firing (with a default message). The flag is used for overcharged weapons.
|IF_BLADE|Weapons with this flag are considered blades for the purpose of activating the flags used for [[Traits#Malicious Blades|Malicious Blades]].
|IF_DESTRUCTIVE|Weapons with this flag deal double damage to cells (if they can hurt cells, see [[Modding:Cell|CF_FRAGILE]].)
|IF_ROCKET|Any weapon with this flag defined as a rocket launcher.
|IF_NODEGRADE|Armor's or boots' resistances aren't degraded due to damage taken. Usually set for shields.
|IF_THROWDROP|Combat knife has this flag in 0.9.9.7.
|IF_FARHIT|
|IF_UNSEENHIT|
|}}
}}

Modding:Constants

2013-07-15T13:23:31Z

Rabinowitz: /* StatusEffect */

Constants and Enumerations are common in any game and DoomRL is no exception. Internally, as most programmers are aware, these are integers. But to modders they are all important magic values, looked up here.

== Engine Enums ==

==== ItemType ====

Every item has a type that determines how the engine treats it.

{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TItemType'''
|-
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_NONE
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_RANGED
|-
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_NRANGED
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_ARMOR
|-
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_MELEE
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_AMMO
|-
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_PACK
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_POWER
|-
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_BOOTS
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_TELE
|-
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_LEVER
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_AMMOPACK
|}

==== BodyTarget ====

Sources of damage must specify a body target to determine which sources of armor are used. Inherent armor bonuses always apply.

{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TBodyTarget'''
|-
|style="vertical-align:top; padding-right: 2ex;"|TARGET_INTERNAL
|Protection from boots and armor will be ignored.
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|TARGET_TORSO
|Protection from armor counts but protection from boots does not.
|-
|style="vertical-align:top; padding-right: 2ex;"|TARGET_FEET
|Protection from boots counts but protection from armor does not.
|}

==== EqSlot ====

It is preferred to use the (equivalent) [[#Equip Slots|slot]] constants.

{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TEqSlot'''
|-
|style="vertical-align:top; padding-right: 2ex;"|EFTORSO
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EFWEAPON
|-
|style="vertical-align:top; padding-right: 2ex;"|EFBOOTS
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EFWEAPON2
|}

==== StatusEffect ====

[[Modding:Affects|Affects]] specify one of these status effects that will apply a color scheme to all the tiles on the HUD.

{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TStatusEffect'''
|-
|style="vertical-align:top; padding-right: 2ex;"|STATUSNORMAL
|No affects
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|STATUSINVERT
|Berserk (sic!)
|-
|style="vertical-align:top; padding-right: 2ex;"|STATUSRED
|Invincibility (sic!)
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|STATUSGREEN
|Environsuit
|-
|style="vertical-align:top; padding-right: 2ex;"|STATUSBLUE
|Light-Amp Goggle effect
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|STATUSMAGENTA
|Unused
|-
|style="vertical-align:top; padding-right: 2ex;"|STATUSYELLOW
|Unused
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|STATUSGRAY
|Unused
|-
|style="vertical-align:top; padding-right: 2ex;"|STATUSWHITE
|Unused
|}

==== DamageType ====

Sources of damage usually specify a damage type that determines how the damage regards protection, resistances, gibbing, and other things. For details on the differences between the damage types, look [[Damage type|here]].

{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TDamageType'''
|-
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_BULLET 
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_MELEE 
|-
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_SHARPNEL [sic] 
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_ACID 
|-
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_FIRE 
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_PLASMA 
|-
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_SPLASMA 
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_IGNOREARMOR 
|}

==== AltFire ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TAltFire'''
|-
|style="vertical-align:top; padding-right: 2ex;"|ALT_NONE
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ALT_CHAIN
|-
|style="vertical-align:top; padding-right: 2ex;"|ALT_THROW
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ALT_SCRIPT
|-
|style="vertical-align:top; padding-right: 2ex;"|ALT_AIMED
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ALT_SINGLE
|}

==== AltReload ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TAltReload'''
|-
|style="vertical-align:top; padding-right: 2ex;"|RELOAD_NONE
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|RELOAD_SCRIPT
|-
|style="vertical-align:top; padding-right: 2ex;"|RELOAD_FULL
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|RELOAD_DUAL
|-
|style="vertical-align:top; padding-right: 2ex;"|RELOAD_SINGLE
|}

==== ExplosionFlag ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=3 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TExplosionFlag'''
|-
|style="vertical-align:top; padding-right: 2ex;"|EFSELFHALF
|Deals half damage to the active being.
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EFSELFKNOCKBACK
|Gives extra knockback to the active being.
|-
|style="vertical-align:top; padding-right: 2ex;"|EFSELFSAFE
|Deals no damage to the active being.
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EFAFTERBLINK
|Blinks the screen after the explosion finishes.
|-
|style="vertical-align:top; padding-right: 2ex;"|EFCHAIN
|Causes secondary explosions (as the [[BFG 9000]]).
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EFHALFKNOCK
|Causes half the usual knockback.
|-
|style="vertical-align:top; padding-right: 2ex;"|EFNOKNOCK
|Doesn't cause knockback.
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EFRANDOMCONTENT
|Transmutes some cells in the explosion to the explosion's content cell; the rules is to transmute when damage is greater than 20.
|}

====Level Flag====
{{Template:Level_Flags}}

====Light Flag====
{{Template:Light_Flags}}

== Constants ==

==== Maximums ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Maximums'''
|-
|style="vertical-align:top; padding-right: 2ex;"|MAXX || 78
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|MAXY || 20
|-
|style="vertical-align:top; padding-right: 2ex;"|BOSS_LEVEL || 25
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|MAXDEPTH || 26
|-
|style="vertical-align:top; padding-right: 2ex;"|MAXAFFECT || 5
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|MAX_INV_SIZE || 22
|-
|style="vertical-align:top; padding-right: 2ex;"|MAX_EQ_SIZE || 4
|}

==== Cellsets ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Cellsets'''
|-
|style="vertical-align:top; padding-right: 2ex;"|CELLSET_WALLS
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|CELLSET_FLOORS
|-
|style="vertical-align:top; padding-right: 2ex;"|CELLSET_CORPSES
|}

==== Challenges ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Challenges'''
|-
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_BERSERK
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_MARKSMANSHIP
|-
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_SHOTGUNNERY
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_LIGHTTRAVEL
|-
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_IMPATIENCE
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_HASTE
|-
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_PURITY
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_REDALERT
|-
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_CARNAGE
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_MASOCHISM
|-
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_100
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_PACIFISM
|-
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_HUMANITY
|}

==== Difficulty ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Difficulty'''
|-
|style="vertical-align:top; padding-right: 2ex;"|DIFF_EASY
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|DIFF_MEDIUM
|-
|style="vertical-align:top; padding-right: 2ex;"|DIFF_HARD
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|DIFF_VERYHARD
|-
|style="vertical-align:top; padding-right: 2ex;"|DIFF_NIGHTMARE
|}

==== PlayerRank ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''PlayerRank'''
|-
|style="vertical-align:top; padding-right: 2ex;"|RANKEXP
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|RANKSKILL
|}

==== Player Statistics ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Player Statistics'''
|-
|style="vertical-align:top; padding-right: 2ex;"|RANK_KILLTOTAL
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|RANK_KILLMELEE
|-
|style="vertical-align:top; padding-right: 2ex;"|RANK_KILLPISTOL
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|RANK_LEVEL
|-
|style="vertical-align:top; padding-right: 2ex;"|RANK_BADGE
|}

==== Equip Slots ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Equip Slots'''
|-
|style="vertical-align:top; padding-right: 2ex;"|SLOT_ARMOR
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|SLOT_WEAPON
|-
|style="vertical-align:top; padding-right: 2ex;"|SLOT_BOOTS
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|SLOT_PREPARED
|}

==== Colors ====
Usually, it is possible to specify a foreground color and a background color. Since DoomRL uses 4 bit color, the lowest 4 bits determine the foreground color, and the next 4 bits determine the background color (zero is black). Occasionally, one of these may conflict with one of the special color constants. See [[Modding:Color]] for details.

Also, note that the exact color the end-user sees may depend on his system settings.
For the basic 16 colors, the valkyrie string coloring escape is noted.
{{Template:Color}}
{{Template:Special_Color}}

== Flags ==

==== Being Flags ====
{{Template:Being_Flags}}

Some flags have no effect on non-player beings. Most trait flags are that way.

==== Generic Flags ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=3 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Generic Flags'''
|-
|style="vertical-align:top; padding-right: 2ex;"|F_OVERLAY
|This flag is related to the graphical version.
|}

==== Empty Flags ====
Empty flags are used with various functions to control the selection of random coords.

{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Empty Flags'''
|-
|style="vertical-align:top; padding-right: 2ex;"|EF_NOITEMS
|Excludes cells that contain an item.
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EF_NOBEINGS
|Excludes cells that contain a being.
|-
|style="vertical-align:top; padding-right: 2ex;"|EF_NOBLOCK
|Excludes cells that block movement (CF_BLOCKMOVE).
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EF_NOVISION
|Excludes cells that block vision (CF_BLOCKLOS).
|-
|style="vertical-align:top; padding-right: 2ex;"|EF_NOSTAIRS
|Excludes stairs (cells with an OnExit hook).
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EF_NOTELE
|Excludes cells with a teleporter (an item with ITEMTYPE_TELE).
|-
|style="vertical-align:top; padding-right: 2ex;"|EF_NOHARM
|Excludes hazardous cells (CF_HAZARD).
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EF_NOSAFE
|Excludes cells that are too near to the player (currently the threshold is less than or equal to distance of 5).
|-
|style="vertical-align:top; padding-right: 2ex;"|EF_NOSPAWN
|Excludes cells with LF_NOSPAWN.
|}

Modding:being API (0.9.9.7)

2013-07-13T00:59:58Z

Rabinowitz: being:alt_fire

''This page is currently under construction.''

== API ==

Please note that the type "integer" indicates an numeric value without a decimal part. It does not indicate the range of acceptable values.

An argument name in [square brackets] is an optional one. The function description will indicate how the function operates if it is omitted.

The [[Modding:Thing#API|Thing API]] can also be used with beings.

=== Being API Function List ===

{|class="wikitable" style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
! colspan="2" style="background: darkred; color: yellow; font-size: 120%; text-align: center"|Being Interface
{{Table2Col
|es=background: #333;
|c1=font-weight:bold; text-align:right; vertical-align:top; padding:0px 2px;
|c2=padding:0px 2px;
|{{modarg|Being}}|{{moddef|list|new|dot||BeingID|id}}
|{{modarg|void}}|{{moddef|list|kill|cln||boolean|[overkill]}}
|{{modarg|void}}|{{moddef|list|ressurect|cln||integer|range}}
|{{modarg|void}}|{{moddef|list|apply_damage|cln||integer|amount|BodyTarget|target|DamageType|[type]}}
|{{modarg|void}}|{{moddef|list|get_name|cln||boolean|[known]|boolean|[capitalize]}}
|{{modarg|table}}|{{moddef|list|inv_items|cln}}
|{{modarg|Item}}|{{moddef|list|get_eq_item|cln||EquipSlot|slot}}
|{{modarg|void}}|{{moddef|list|set_eq_item|cln||EquipSlot|slot|Item|item}}
|{{modarg|boolean}}|{{moddef|list|add_inv_item|cln||Item|item}}
|{{modarg|void}}|{{moddef|list|play_sound|cln||SoundID|sound}}
|{{modarg|integer}}|{{moddef|list|get_total_resistance|cln||ResistType|resist|BodyTarget|[target]}}
|{{modarg|boolean}}|{{moddef|list|quick_swap|cln}}
|{{modarg|boolean}}|{{moddef|list|pickup|cln}}
|{{modarg|boolean}}|{{moddef|list|unload|cln||Item|item}}
|{{modarg|boolean}}|{{moddef|list|drop|cln||Item|item}}
|{{modarg|boolean}}|{{moddef|list|use|cln||Item|item}}
|{{modarg|boolean}}|{{moddef|list|wear|cln||Item|item}}
|{{modarg|boolean}}|{{moddef|list|attack|cln||Being|target}}
|{{modarg|boolean}}|{{moddef|list|attack|cln||Coord|target}}
|{{modarg|boolean}}|{{moddef|list|fire|cln||Coord|target|Item|weapon}}
|{{modarg|boolean}}|{{moddef|list|alt_fire|cln||Coord|target|Item|weapon}}
|{{modarg|boolean}}|{{moddef|list|reload|cln}}
|{{modarg|boolean}}|{{moddef|list|alt_reload|cln}}
|{{modarg|integer}}, {{modarg|Coord}}|{{moddef|list|direct_seek|cln||Coord|dest}}
|{{modarg|void}}|{{moddef|list|relocate|cln||Coord|dest}}
|{{modarg|boolean}}|{{moddef|list|path_find|cln||Coord|dest|integer|cutoff|integer|maximum}}
|{{modarg|integer}}, {{modarg|Coord}} or {{modarg|boolean}}|{{moddef|list|path_next|cln}}
|{{modarg|Coord}}|{{moddef|list|flock_target|cln||integer|range|integer|mind|integer|maxd}}
|{{modarg|void}}|{{moddef|list|msg|cln||string|msg_player|string|msg_being}}
|{{modarg|Item}}|{{moddef|list|select_slot_by_letter|cln||string|letter}}
|{{modarg|void}}|{{moddef|list|phase|cln||CellID|[cell]}}
|{{modarg|void}}|{{moddef|list|spawn|cln||BeingID|monster}}
|{{modarg|boolean}}|{{moddef|list|act|cln||Coord|coord}}
|{{modarg|boolean}}|{{moddef|list|eye_contact|cln||Coord|other}}
|{{modarg|boolean}}|{{moddef|list|eye_contact|cln||Thing|other}}
|{{modarg|boolean}}|{{moddef|list|in_sight|cln||Coord|other}}
|{{modarg|boolean}}|{{moddef|list|in_sight|cln||Thing|other}}
|{{modarg|boolean}}|{{moddef|list|is_player|cln}}
|{{modarg|integer}}|{{moddef|list|set_items|cln||SetID|set}}
|{{modarg|void}}|{{moddef|list|nuke|cln||integer|[time]}}
|{{modarg|Item}}, {{modarg|boolean}}|{{moddef|list|pick_mod_item|cln||string|modletter|integer|techbonus}}
|}}
|}

=== Being API Function Descriptions ===
;{{moddef|desc|new|dot|Being|BeingID|id}}
Creates a new being object from the specified blueprint.
:''id'': The ID of the being to create.
:'''Returns''': A reference to the new being object.
----
;{{moddef|desc|kill|cln||boolean|[overkill]}}
Kills the being.
:''overkill'': ''Optional.'' If ''True'', the being will be gibbed (extra blood, inventory will not drop, and a corpse will not be placed). If ''False'' the being will be killed normally. If omitted, the being will be killed normally.
----
;{{moddef|desc|ressurect|cln||integer|range}}
Resurrects the nearest eligble corpse in sight of the calling being. Handles all message output.
:''range'': The maximum distance (in terms of movement) that a corpse can be in order to be eligble for resurrection.
NOTE: The function name is a misspelling.
----
;{{moddef|desc|apply_damage|cln||integer|amount|BodyTarget|target|DamageType|[type]}}
Deals damage to the being.
:''amount'': The amount of damage the attack does. This is not necessarily the amount of HP the being will lose; the being's resistance and armor may apply against this value.
:''target'': One of TARGET_INTERNAL, TARGET_TORSO, or TARGET_FEET. TARGET_INTERNAL only uses the target's internal armor and resistances (equipment, for the most part, will be ignored). TARGET_TORSO uses the item in the armor slot to help reduce the damage, and TARGET_FEET uses the item in the boots slot to help reduce the damage.
:''DamageType'': ''Optional.'' One of the named constants starting with "DAMAGE_". Indicates the type of damage being dealt, which influences the properties and effects the damage has on the target. If omitted, DAMAGE_BULLET will be used.
----
;{{moddef|desc|get_name|cln||boolean|[known]|boolean|[capitalize]}}
Returns the name of the being, with the appropriate preposition.
:''known'': ''Optional.'' If ''true'', the being will not use an article (a, an, or the) when getting the name string. If ''false'', an article (a, an, or the) will be appended to the front of the name. If omitted, the default is to use an article. BF_UNIQUENAME determines when "the" is used instead of "a" or "an".
:''capitalize'': ''Optional.'' If ''true'', the name of the being will be capitalized. If ''false'', it will not be adjusted. If omitted, the default is to not adjust.
----
;{{moddef|desc|inv_items|cln|table}}
Gets an iterator over the items in the being's inventory.
:'''Returns''': A table containing references to each item in the being's inventory.
----
;{{moddef|desc|get_eq_item|cln|Item|EquipSlot|slot}}
Retrieves the item in the indicated equipment slot. Equivalent to "being.eq.''slotname''", where ''slotname'' is "weapon", "armor", "boots", or "prepared".
:''slot'': One of SLOT_WEAPON, SLOT_ARMOR, SLOT_BOOTS, or SLOT_PREPARED.
:'''Returns''': A reference to the item equipped in the indicated slot.
----
;{{moddef|desc|set_eq_item|cln||EquipSlot|slot|Item|item}}
Equips an item to the being. Equivalent to "being.eq.''slotname'' = ''item''", where slotname is "weapon", "armor", "boots", or "prepared".
:''slot'': One of SLOT_WEAPON, SLOT_ARMOR, SLOT_BOOTS, or SLOT_PREPARED.
:''item'': The item to equip to the slot. If there is a different item in the slot already, it will be destroyed. If nil, the equipped item is destroyed.
----
;{{moddef|desc|add_inv_item|cln||Item|item}}
Adds an item to the being's inventory.
:''item'': The item to add.
:'''Returns''': ''True'' if the item was added. ''False'' if the being's inventory is full.
----
;{{moddef|desc|play_sound|cln||SoundID|sound}}
Plays a sound at the being's location.
:''sound'': The sound to play.
----
;{{moddef|desc|get_total_resistance|cln|integer|ResistType|resist|BodyTarget|[target]}}
Gets the total resistance for being, given the resistance type and target.
:''resist'': The resistance to get the value for.
:''target'': ''Optional.'' One of TARGET_INTERNAL, TARGET_TORSO, or TARGET_FEET. TARGET_INTERNAL only uses the target's internal resistance (equipment, for the most part, will be ignored). TARGET_TORSO uses the item in the armor slot to calculate resistance, and TARGET_FEET uses the item in the boots slot to calculate resistance. If omitted, TARGET_TORSO is used.
----
;{{moddef|desc|quick_swap|cln|boolean}}
Switches the weapon in the "weapon" slot with the one in the "prepared" slot. Expends energy on success.
:'''Returns''': ''True'' if the swap worked. ''False'' if it failed.
----
;{{moddef|desc|pickup|cln|boolean}}
Attempts to pickup the item at the being's current location. Expends energy on success.
:'''Returns''': ''True'' if the pickup succeeded, ''False'' if it failed.
----
;{{moddef|desc|unload|cln|boolean|Item|item}}
Attempts to unload the indicated item. Expends energy on success.
:''item'': The item to try to unload.
:'''Returns''': ''True'' if the unloading succeeded, ''False'' if it failed.
----
;{{moddef|desc|drop|cln|boolean|Item|item}}
Attempts to drop an item. Expends energy on success.
:''item'': The item to try to drop.
:'''Returns''': ''True'' if the drop succeeded, ''False'' if it failed.
----
;{{moddef|desc|use|cln|boolean|Item|item}}
Attempts to use an item. Expends energy on success.
:''item'': The item to try to use.
:'''Returns''': ''True'' if the use succeeded. ''False'' if it failed.
----
;{{moddef|desc|wear|cln|boolean|Item|item}}
Attempts to equip an item. Expends energy on success.
:''item'': The item to try to wear.
:'''Returns''': ''True'' if the item was worn. ''False'' if the command failed.
----
;{{moddef|desc|attack|cln|boolean|Being|target}}
;{{moddef|desc|attack|cln|boolean|Coord|target}}
Attempts to attack something. Expends energy on success.
:''target'': A being or a location to attack.
:'''Returns''': ''True'' if the attack was attempted. ''False'' if the being couldn't attack.
----
;{{moddef|desc|fire|cln|boolean|Coord|target|Item|weapon}}
Attempts to fire a weapon at something. Expends energy on success.
:''target'': The location to fire at.
:''weapon'': The item to fire at the location with.
:'''Returns''': ''True'' if the weapon was fired. ''False'' if it failed.
----
;{{moddef|desc|alt_fire|cln|boolean|Coord|target|Item|weapon}}
Attempts to fire a weapon using its alternate fire mode.
:''target'': The location to fire at.
:''weapon'': The item to fire at the location with.
:'''Returns''': ''True'' if the weapon was fired. ''False'' if it failed.
----
;{{moddef|desc|reload|cln|boolean}}
Attempts to reload the equipped weapon.
:'''Returns''': ''True'' if the weapon was loaded with at least 1 ammo. ''False'' if the weapon didn't get any ammo put in it at all.
----
;{{moddef|desc|alt_reload|cln|boolean}}
Attemptes to reload the equipped weapon using its alternate reload.
:'''Returns''': ''True'' if the weapon was loaded with at least 1 ammo. ''False'' if the weapon didn't get any ammo put in it at all.
----
;{{moddef|desc|direct_seek|cln|integer, Coord|Coord|dest}}
Attempts to move directly toward a location. Expends energy only on a successful move. The being will try moving around objects in its way. It will only move at most 1 space for each time this is called.
:''dest'': The location to attempt to move toward.
:'''Returns''': An integer, representing the result of the move, and a Coord, holding the previous location of the being. The integer can be 0 (MOVEOK), 1 (MOVEBLOCK), 2 (MOVEDOOR), or 3 (MOVEBEING). 0 means the move was successful, and energy was expended. 1 means there was a wall in the way. 2 means there was door or other CF_OPENABLE cell in the way. 3 means a being was in the way.
----
;{{moddef|desc|relocate|cln||Coord|dest}}
Moves the being to the indicated location, with animations.
:''dest'': The location to move the being to.
----
;{{moddef|desc|path_find|cln|boolean|Coord|dest|integer|cutoff|integer|maximum}}
Search for a path to the indicated location. Pathfinding is a time intensive procedure, use conservatively.
:''dest'': The location to find a path to.
:''cutoff'': A path finding parameter. The search is aborted if this number of positions are checked without getting closer to the target destination. DoomRL uses 10 for normal enemies and 40 for bosses. Larger values may cause the algorithm to take longer.
:''maximum'': A path finding parameter. The search is aborted if this number of positions are checked without reaching the target. DoomRL uses 40 for normal enemies and 200 for bosses. Larger values may cause the algorithm to take longer.
:'''Returns''': ''True'' if a path was found, ''False'' if not.
----
;{{moddef|desc|path_next|cln|integer, Coord}} or '''boolean'''
Moves the being to the next space on the found path.
:'''Returns''': If there is a valid path, an integer, representing the result of the move, and a Coord, holding the previous location of the being, are returned. The integer can be 0 (MOVEOK), 1 (MOVEBLOCK), 2 (MOVEDOOR), or 3 (MOVEBEING). 0 means the move was successful, and energy was expended. 1 means there was a wall in the way. 2 means there was door or other CF_OPENABLE cell in the way. 3 means a being was in the way. If there was no valid path to move along, the boolean value ''False'' is returned instead.
----
;{{moddef|desc|flock_target|cln|Coord|integer|range|integer|mind|integer|maxd}}
Assigns a coord based on other beings of the same type.
:''range'': The distance to check.
:''mind'': Matching beings will try to keep this much distance between them.
:''maxd'': Matching beings will try to be at least this close to each other.
:'''Returns''': A coordinate. If the beings are ''mind'' away or closer, the coordinate will be away from the closest matching being. If the beings are ''maxd'' away or farther, the coordinate will be the location of the closest being. Otherwise, the coordinate is a random position within ''range''.
----
;{{moddef|desc|msg|cln||string|msg_player|string|msg_being}}
Prints a message depending on the status of the subject of the message.
:''msg_player'': ''Optional.'' If the calling being is the player, this message will be printed. If omitted, no message is printed if called by the player.
:''msg_being'': ''Optional.'' If the calling being is not the player, but is in the player's vision, this message will be printed. If omitted, no message is printed if called by a visible non-player being.
----
;{{moddef|desc|select_slot_by_letter|cln|Item|string|letter}}
Gets the slot based on the character entered.
:''letter'': A single character string.
:'''Returns''': If letter is "a", the item in the armor slot is returned. If letter is "b", the item in the boots slot is returned. If letter is "w", the item in the weapon slot is returned. If letter is "p", the item in the prepared slot is returned. Otherwise, nil is returned.
----
;{{moddef|desc|phase|cln||CellID|[cell]}}
Teleports the being to a new cell.
:''cell'': ''Optional.'' A cell id to search for. If multiple cells of that id are on the level, one is picked at random. If omitted, any cell empty of beings, items, stairs, walls, hazardous terrain, or LFNOSPAWN can be selected.
----
;{{moddef|desc|spawn|cln||BeingID|monster}}
Summons monsters around this being. Monsters summoned this way grant no experience to the player (that is, BF_NOEXP is set on the spawned beings).
:''monster'': The ID of the being to spawn.
----
;{{moddef|desc|act|cln|boolean|Coord|coord}}
Makes the being interact with the indicated location.
:''coord'': The location to interact with.
:'''Returns''': ''True'' if the action was successful, ''False'' if not.
----
;{{moddef|desc|eye_contact|cln|boolean|Coord|other}}
;{{moddef|desc|eye_contact|cln|boolean|Thing|other}}
Checks if something is visible from this being's location.
:''other'': A Coord, Being, or Item whose position will be checked.
:'''Returns''': ''True'' if the being can see the checked object or location, ''False'' if not.
----
;{{moddef|desc|in_sight|cln|boolean|Coord|other}}
;{{moddef|desc|in_sight|cln|boolean|Thing|other}}
Checks to see if something can be from the being's location. If the being is the player, the player's vision algorithm is used. Otherwise, the being's eye_contact algorithm is used.
:''other'': A Coord, Being, or Item whose position will be checked.
:'''Returns''': ''True'' if the object is visible, ''False'' if not.
----
;{{moddef|desc|is_player|cln|boolean}}
Returns whether this being is the player or not.
:'''Returns''': ''True'' if this being is the player. ''False'' if it is not.
----
;{{moddef|desc|set_items|cln|integer|SetID|set}}
Gets the number of items worn by the being that are part of a set.
:''set'': The set to check.
:'''Returns''': The number of items of that set worn by this being.
----
;{{moddef|desc|nuke|cln||integer|[time]}}
Creates a nuke under the being and sets the nuke timer.
:''time'': ''Optional.'' The number of game turns the the nuke will go off in. If omitted, the default is 1.
----
;{{moddef|desc|pick_mod_item|cln|Item, boolean|string|modletter|integer|techbonus}}
Performs the choice, check, and attachment of a mod to an item. Only the player can call this function.
:''modletter'': The letter representing the mod being attached. Standard DoomRL mod letters are:
Agility: A Tech: T Bulk: B Power: P
Sniper: S Firestorm: F Nano: N Onyx: O
Custom modpacks should use different letters.
:''techbonus'': The number of points of tech bonus the being has. DoomRL uses the Whizkid level for this number.
:'''Returns''': An Item and a boolean. The Item returned is the resulting item after being modded with the mod pack, unless an assembly (mod array) was matched and accepted. The boolean value is ''True'' if the modding was successful or ''False'' if it was not. If the boolean value is ''False'' or the Item was turned into an assembly, Nil is returned instead of the item.
----

Modding:Constants

2013-07-05T11:04:35Z

Rabinowitz: /* StatusEffect */

Constants and Enumerations are common in any game and DoomRL is no exception. Internally, as most programmers are aware, these are integers. But to modders they are all important magic values, looked up here.

== Engine Enums ==

==== ItemType ====

Every item has a type that determines how the engine treats it.

{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TItemType'''
|-
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_NONE
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_RANGED
|-
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_NRANGED
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_ARMOR
|-
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_MELEE
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_AMMO
|-
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_PACK
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_POWER
|-
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_BOOTS
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_TELE
|-
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_LEVER
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_AMMOPACK
|}

==== BodyTarget ====

Sources of damage must specify a body target to determine which sources of armor are used. Inherent armor bonuses always apply.

{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TBodyTarget'''
|-
|style="vertical-align:top; padding-right: 2ex;"|TARGET_INTERNAL
|Protection from boots and armor will be ignored.
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|TARGET_TORSO
|Protection from armor counts but protection from boots does not.
|-
|style="vertical-align:top; padding-right: 2ex;"|TARGET_FEET
|Protection from boots counts but protection from armor does not.
|}

==== EqSlot ====

It is preferred to use the (equivalent) [[#Equip Slots|slot]] constants.

{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TEqSlot'''
|-
|style="vertical-align:top; padding-right: 2ex;"|EFTORSO
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EFWEAPON
|-
|style="vertical-align:top; padding-right: 2ex;"|EFBOOTS
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EFWEAPON2
|}

==== StatusEffect ====

[[Modding:Affects|Affects]] specify one of these status effects that will apply a color scheme to all the tiles on the HUD.

{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TStatusEffect'''
|-
|style="vertical-align:top; padding-right: 2ex;"|STATUSNORMAL
|No affects
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|STATUSINVERT
|Berserk (sic!)
|-
|style="vertical-align:top; padding-right: 2ex;"|STATUSRED
|Invincibility (sic!)
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|STATUSGREEN
|Environsuit
|}

==== DamageType ====

Sources of damage usually specify a damage type that determines how the damage regards protection, resistances, gibbing, and other things. For details on the differences between the damage types, look [[Damage type|here]].

{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TDamageType'''
|-
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_BULLET 
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_MELEE 
|-
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_SHARPNEL [sic] 
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_ACID 
|-
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_FIRE 
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_PLASMA 
|-
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_SPLASMA 
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_IGNOREARMOR 
|}

==== AltFire ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TAltFire'''
|-
|style="vertical-align:top; padding-right: 2ex;"|ALT_NONE
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ALT_CHAIN
|-
|style="vertical-align:top; padding-right: 2ex;"|ALT_THROW
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ALT_SCRIPT
|-
|style="vertical-align:top; padding-right: 2ex;"|ALT_AIMED
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ALT_SINGLE
|}

==== AltReload ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TAltReload'''
|-
|style="vertical-align:top; padding-right: 2ex;"|RELOAD_NONE
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|RELOAD_SCRIPT
|-
|style="vertical-align:top; padding-right: 2ex;"|RELOAD_FULL
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|RELOAD_DUAL
|-
|style="vertical-align:top; padding-right: 2ex;"|RELOAD_SINGLE
|}

==== ExplosionFlag ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=3 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TExplosionFlag'''
|-
|style="vertical-align:top; padding-right: 2ex;"|EFSELFHALF
|Deals half damage to the active being.
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EFSELFKNOCKBACK
|Gives extra knockback to the active being.
|-
|style="vertical-align:top; padding-right: 2ex;"|EFSELFSAFE
|Deals no damage to the active being.
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EFAFTERBLINK
|Blinks the screen after the explosion finishes.
|-
|style="vertical-align:top; padding-right: 2ex;"|EFCHAIN
|Causes secondary explosions (as the [[BFG 9000]]).
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EFHALFKNOCK
|Causes half the usual knockback.
|-
|style="vertical-align:top; padding-right: 2ex;"|EFNOKNOCK
|Doesn't cause knockback.
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EFRANDOMCONTENT
|Transmutes some cells in the explosion to the explosion's content cell; the rules is to transmute when damage is greater than 20.
|}

====Level Flag====
{{Template:Level_Flags}}

====Light Flag====
{{Template:Light_Flags}}

== Constants ==

==== Maximums ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Maximums'''
|-
|style="vertical-align:top; padding-right: 2ex;"|MAXX || 78
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|MAXY || 20
|-
|style="vertical-align:top; padding-right: 2ex;"|BOSS_LEVEL || 25
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|MAXDEPTH || 26
|-
|style="vertical-align:top; padding-right: 2ex;"|MAXAFFECT || 5
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|MAX_INV_SIZE || 22
|-
|style="vertical-align:top; padding-right: 2ex;"|MAX_EQ_SIZE || 4
|}

==== Cellsets ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Cellsets'''
|-
|style="vertical-align:top; padding-right: 2ex;"|CELLSET_WALLS
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|CELLSET_FLOORS
|-
|style="vertical-align:top; padding-right: 2ex;"|CELLSET_CORPSES
|}

==== Challenges ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Challenges'''
|-
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_BERSERK
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_MARKSMANSHIP
|-
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_SHOTGUNNERY
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_LIGHTTRAVEL
|-
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_IMPATIENCE
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_HASTE
|-
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_PURITY
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_REDALERT
|-
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_CARNAGE
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_MASOCHISM
|-
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_100
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_PACIFISM
|-
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_HUMANITY
|}

==== Difficulty ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Difficulty'''
|-
|style="vertical-align:top; padding-right: 2ex;"|DIFF_EASY
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|DIFF_MEDIUM
|-
|style="vertical-align:top; padding-right: 2ex;"|DIFF_HARD
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|DIFF_VERYHARD
|-
|style="vertical-align:top; padding-right: 2ex;"|DIFF_NIGHTMARE
|}

==== PlayerRank ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''PlayerRank'''
|-
|style="vertical-align:top; padding-right: 2ex;"|RANKEXP
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|RANKSKILL
|}

==== Player Statistics ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Player Statistics'''
|-
|style="vertical-align:top; padding-right: 2ex;"|RANK_KILLTOTAL
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|RANK_KILLMELEE
|-
|style="vertical-align:top; padding-right: 2ex;"|RANK_KILLPISTOL
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|RANK_LEVEL
|-
|style="vertical-align:top; padding-right: 2ex;"|RANK_BADGE
|}

==== Equip Slots ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Equip Slots'''
|-
|style="vertical-align:top; padding-right: 2ex;"|SLOT_ARMOR
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|SLOT_WEAPON
|-
|style="vertical-align:top; padding-right: 2ex;"|SLOT_BOOTS
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|SLOT_PREPARED
|}

==== Colors ====
Usually, it is possible to specify a foreground color and a background color. Since DoomRL uses 4 bit color, the lowest 4 bits determine the foreground color, and the next 4 bits determine the background color (zero is black). Occasionally, one of these may conflict with one of the special color constants. See [[Modding:Color]] for details.

Also, note that the exact color the end-user sees may depend on his system settings.
For the basic 16 colors, the valkyrie string coloring escape is noted.
{{Template:Color}}
{{Template:Special_Color}}

== Flags ==

==== Being Flags ====
{{Template:Being_Flags}}

Some flags have no effect on non-player beings. Most trait flags are that way.

==== Generic Flags ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=3 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Generic Flags'''
|-
|style="vertical-align:top; padding-right: 2ex;"|F_OVERLAY
|This flag is related to the graphical version.
|}

==== Empty Flags ====
Empty flags are used with various functions to control the selection of random coords.

{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Empty Flags'''
|-
|style="vertical-align:top; padding-right: 2ex;"|EF_NOITEMS
|Excludes cells that contain an item.
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EF_NOBEINGS
|Excludes cells that contain a being.
|-
|style="vertical-align:top; padding-right: 2ex;"|EF_NOBLOCK
|Excludes cells that block movement (CF_BLOCKMOVE).
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EF_NOVISION
|Excludes cells that block vision (CF_BLOCKLOS).
|-
|style="vertical-align:top; padding-right: 2ex;"|EF_NOSTAIRS
|Excludes stairs (cells with an OnExit hook).
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EF_NOTELE
|Excludes cells with a teleporter (an item with ITEMTYPE_TELE).
|-
|style="vertical-align:top; padding-right: 2ex;"|EF_NOHARM
|Excludes hazardous cells (CF_HAZARD).
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EF_NOSAFE
|Excludes cells that are too near to the player (currently the threshold is less than or equal to distance of 5).
|-
|style="vertical-align:top; padding-right: 2ex;"|EF_NOSPAWN
|Excludes cells with LF_NOSPAWN.
|}

Modding:Constants

2013-07-04T11:45:50Z

Rabinowitz: /* AltFire */ there is no ALT_WHIRLWIND in 0996 and 0997 releases

Constants and Enumerations are common in any game and DoomRL is no exception. Internally, as most programmers are aware, these are integers. But to modders they are all important magic values, looked up here.

== Engine Enums ==

==== ItemType ====

Every item has a type that determines how the engine treats it.

{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TItemType'''
|-
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_NONE
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_RANGED
|-
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_NRANGED
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_ARMOR
|-
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_MELEE
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_AMMO
|-
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_PACK
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_POWER
|-
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_BOOTS
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_TELE
|-
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_LEVER
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_AMMOPACK
|}

==== BodyTarget ====

Sources of damage must specify a body target to determine which sources of armor are used. Inherent armor bonuses always apply.

{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TBodyTarget'''
|-
|style="vertical-align:top; padding-right: 2ex;"|TARGET_INTERNAL
|Protection from boots and armor will be ignored.
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|TARGET_TORSO
|Protection from armor counts but protection from boots does not.
|-
|style="vertical-align:top; padding-right: 2ex;"|TARGET_FEET
|Protection from boots counts but protection from armor does not.
|}

==== EqSlot ====

It is preferred to use the (equivalent) [[#Equip Slots|slot]] constants.

{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TEqSlot'''
|-
|style="vertical-align:top; padding-right: 2ex;"|EFTORSO
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EFWEAPON
|-
|style="vertical-align:top; padding-right: 2ex;"|EFBOOTS
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EFWEAPON2
|}

==== StatusEffect ====

[[Modding:Affects|Affects]] specify one of these status effects that will apply a color scheme to all the tiles on the HUD.

{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TStatusEffect'''
|-
|style="vertical-align:top; padding-right: 2ex;"|STATUSNORMAL
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|STATUSINVERT
|-
|style="vertical-align:top; padding-right: 2ex;"|STATUSRED
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|STATUSGREEN
|}

==== DamageType ====

Sources of damage usually specify a damage type that determines how the damage regards protection, resistances, gibbing, and other things. For details on the differences between the damage types, look [[Damage type|here]].

{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TDamageType'''
|-
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_BULLET 
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_MELEE 
|-
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_SHARPNEL [sic] 
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_ACID 
|-
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_FIRE 
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_PLASMA 
|-
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_SPLASMA 
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_IGNOREARMOR 
|}

==== AltFire ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TAltFire'''
|-
|style="vertical-align:top; padding-right: 2ex;"|ALT_NONE
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ALT_CHAIN
|-
|style="vertical-align:top; padding-right: 2ex;"|ALT_THROW
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ALT_SCRIPT
|-
|style="vertical-align:top; padding-right: 2ex;"|ALT_AIMED
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ALT_SINGLE
|}

==== AltReload ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TAltReload'''
|-
|style="vertical-align:top; padding-right: 2ex;"|RELOAD_NONE
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|RELOAD_SCRIPT
|-
|style="vertical-align:top; padding-right: 2ex;"|RELOAD_FULL
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|RELOAD_DUAL
|-
|style="vertical-align:top; padding-right: 2ex;"|RELOAD_SINGLE
|}

==== ExplosionFlag ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=3 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TExplosionFlag'''
|-
|style="vertical-align:top; padding-right: 2ex;"|EFSELFHALF
|Deals half damage to the active being.
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EFSELFKNOCKBACK
|Gives extra knockback to the active being.
|-
|style="vertical-align:top; padding-right: 2ex;"|EFSELFSAFE
|Deals no damage to the active being.
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EFAFTERBLINK
|Blinks the screen after the explosion finishes.
|-
|style="vertical-align:top; padding-right: 2ex;"|EFCHAIN
|Causes secondary explosions (as the [[BFG 9000]]).
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EFHALFKNOCK
|Causes half the usual knockback.
|-
|style="vertical-align:top; padding-right: 2ex;"|EFNOKNOCK
|Doesn't cause knockback.
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EFRANDOMCONTENT
|Transmutes some cells in the explosion to the explosion's content cell; the rules is to transmute when damage is greater than 20.
|}

====Level Flag====
{{Template:Level_Flags}}

====Light Flag====
{{Template:Light_Flags}}

== Constants ==

==== Maximums ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Maximums'''
|-
|style="vertical-align:top; padding-right: 2ex;"|MAXX || 78
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|MAXY || 20
|-
|style="vertical-align:top; padding-right: 2ex;"|BOSS_LEVEL || 25
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|MAXDEPTH || 26
|-
|style="vertical-align:top; padding-right: 2ex;"|MAXAFFECT || 5
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|MAX_INV_SIZE || 22
|-
|style="vertical-align:top; padding-right: 2ex;"|MAX_EQ_SIZE || 4
|}

==== Cellsets ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Cellsets'''
|-
|style="vertical-align:top; padding-right: 2ex;"|CELLSET_WALLS
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|CELLSET_FLOORS
|-
|style="vertical-align:top; padding-right: 2ex;"|CELLSET_CORPSES
|}

==== Challenges ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Challenges'''
|-
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_BERSERK
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_MARKSMANSHIP
|-
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_SHOTGUNNERY
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_LIGHTTRAVEL
|-
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_IMPATIENCE
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_HASTE
|-
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_PURITY
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_REDALERT
|-
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_CARNAGE
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_MASOCHISM
|-
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_100
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_PACIFISM
|-
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_HUMANITY
|}

==== Difficulty ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Difficulty'''
|-
|style="vertical-align:top; padding-right: 2ex;"|DIFF_EASY
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|DIFF_MEDIUM
|-
|style="vertical-align:top; padding-right: 2ex;"|DIFF_HARD
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|DIFF_VERYHARD
|-
|style="vertical-align:top; padding-right: 2ex;"|DIFF_NIGHTMARE
|}

==== PlayerRank ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''PlayerRank'''
|-
|style="vertical-align:top; padding-right: 2ex;"|RANKEXP
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|RANKSKILL
|}

==== Player Statistics ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Player Statistics'''
|-
|style="vertical-align:top; padding-right: 2ex;"|RANK_KILLTOTAL
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|RANK_KILLMELEE
|-
|style="vertical-align:top; padding-right: 2ex;"|RANK_KILLPISTOL
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|RANK_LEVEL
|-
|style="vertical-align:top; padding-right: 2ex;"|RANK_BADGE
|}

==== Equip Slots ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Equip Slots'''
|-
|style="vertical-align:top; padding-right: 2ex;"|SLOT_ARMOR
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|SLOT_WEAPON
|-
|style="vertical-align:top; padding-right: 2ex;"|SLOT_BOOTS
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|SLOT_PREPARED
|}

==== Colors ====
Usually, it is possible to specify a foreground color and a background color. Since DoomRL uses 4 bit color, the lowest 4 bits determine the foreground color, and the next 4 bits determine the background color (zero is black). Occasionally, one of these may conflict with one of the special color constants. See [[Modding:Color]] for details.

Also, note that the exact color the end-user sees may depend on his system settings.
For the basic 16 colors, the valkyrie string coloring escape is noted.
{{Template:Color}}
{{Template:Special_Color}}

== Flags ==

==== Being Flags ====
{{Template:Being_Flags}}

Some flags have no effect on non-player beings. Most trait flags are that way.

==== Generic Flags ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=3 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Generic Flags'''
|-
|style="vertical-align:top; padding-right: 2ex;"|F_OVERLAY
|This flag is related to the graphical version.
|}

==== Empty Flags ====
Empty flags are used with various functions to control the selection of random coords.

{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Empty Flags'''
|-
|style="vertical-align:top; padding-right: 2ex;"|EF_NOITEMS
|Excludes cells that contain an item.
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EF_NOBEINGS
|Excludes cells that contain a being.
|-
|style="vertical-align:top; padding-right: 2ex;"|EF_NOBLOCK
|Excludes cells that block movement (CF_BLOCKMOVE).
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EF_NOVISION
|Excludes cells that block vision (CF_BLOCKLOS).
|-
|style="vertical-align:top; padding-right: 2ex;"|EF_NOSTAIRS
|Excludes stairs (cells with an OnExit hook).
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EF_NOTELE
|Excludes cells with a teleporter (an item with ITEMTYPE_TELE).
|-
|style="vertical-align:top; padding-right: 2ex;"|EF_NOHARM
|Excludes hazardous cells (CF_HAZARD).
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EF_NOSAFE
|Excludes cells that are too near to the player (currently the threshold is less than or equal to distance of 5).
|-
|style="vertical-align:top; padding-right: 2ex;"|EF_NOSPAWN
|Excludes cells with LF_NOSPAWN.
|}

Nightmare arch-vile

2013-07-03T21:42:07Z

Rabinowitz: 0997

{{infostrat switch}}
{{Monsters|
monster_name=Nightmare arch-vile|
monster_looks=V|
monster_hp=150|
monster_ac=3|
monster_acc=+4 melee, N/A ranged (see below)|
monster_melee=1d3+8 = 9-11 = 10 avg|
monster_projectile=25d1 = 25 (always): [[damage type#fire|fire damage]], [[explosions|radius]] 1|
monster_speed = 180%|
monster_dlvl=90+|
monster_xp=1220|
monster_inventory=None|
monster_pickup=No|
monster_doors=Yes|
monster_atkchance=60|
monster_abilities=Ranged attack is instant: it always hits its target tile and has no projectile. Resurrects dead monsters (33% chance per action).|
monster_description=''Oh God... *WHY* do they come in the nightmare version too?''|
monster_other=Avoids player as much as possible, but will use its melee attack when in range.}}

Modding:Item

2013-07-02T12:53:03Z

Rabinowitz: /* Flags */

DoomRL has many kinds of items. Weapons, powerups, levers, and other things are all items. Items inherit from the [[Modding:Thing|Thing]] class which handles some basic properties in common with beings.

== Prototype ==
New items are created from item prototypes. Think of an item prototype as a recipe for creating new items. There can be multiple pistols, but they all came from the same prototype. Prototypes are declared by passing a table with the desired properties to the Items function. The available properties depend on the item type. [[#Engine Hooks|Engine hooks]] may also be included in the prototype. Mostly, the prototype's properties just describe items' initial properties (occasionally with different names). Items' properties can also mostly be changed after they are instantiated. Required fields are underlined. Sometimes required fields can safely be omitted, but this will generate a message in the log file. All item prototypes are stored in a global table called items. This table can be indexed by id or nid.

{{drltable|Item Prototype|3|{{Table3Col
|es=background: #333;
|c1=font-weight:bold; text-align:right; vertical-align:top; padding:0px 2px;
|c2=vertical-align:top; padding:0px 2px;
|c3=padding:0px 2px;
|{{modarg|string}}|name|This is the item's name.
|{{modarg|string}}|id|This is the item's sid. It must be distinct from other string ids. (The numeric id is automatically generated and stored in the nid field of the prototype.) It defaults to the first word of the name in all lowercase.
|{{modarg|value list}}|overlay|This describes of color transformation of the item's sprite. It is only used in the graphical version. This will create overlay_red, overlay_blue, overlay_green, and overlay_alpha attributes for the prototype.
|{{modarg|Color}}|color|This is the item's color. The default is LIGHTGRAY.
|{{modarg|string}}|color_id|For the purpose of custom color bindings, this id will be used for the item. Multiple items (like levers) can have the same color_id to prevent them from being distinguished.
|{{modarg|integer}}|level|This is an [[Item Generation|item generation]] parameter. The default is 0.
|{{modarg|integer}}|weight|This is an [[Item Generation|item generation]] parameter.
|{{modarg|integer}}|sprite|This is the item's sprite. This field is only relevant to the graphical version; use 0 for no sprite.
|{{modarg|value list}}|coscolor|Some sprites (such as armor and boots) are color-neutral to begin: ''coscolor'' determines the color of the sprite in these cases. The list must be written in this form: {red,green,blue,alpha}, where all of these values range from 0.0 to 1.0.
|{{modarg|value list}}|glow|Creates a customized "glow" effect around the sprite. See ''coscolor'' for table specifications.
|{{modarg|Item Flag List}}|flags|The flags in this list will automatically be included in the item's flag set. The default is an empty list. Some flags may be added automatically. The prototype will automatically be given a flagSet property containing the flags in set format.
|{{modarg|ItemSet ID}}|set|If included, this item will belong to the given item set. This will modify the item's OnEquip and OnRemove hooks.
|{{modarg|string}}|firstmsg|If included, this message will be displayed when the an item with this prototype is picked up for the first time. This will modify the item's OnFirstPickup hook.
|{{modarg|integer}}|res_bullet|This is the item's res_bullet. The default is 0.
|{{modarg|integer}}|res_melee|This is the item's res_melee. The default is 0.
|{{modarg|integer}}|res_shrapnel|This is the item's res_shrapnel. The default is 0.
|{{modarg|integer}}|res_acid|This is the item's res_acid. The default is 0.
|{{modarg|integer}}|res_fire|This is the item's res_fire. The default is 0.
|{{modarg|integer}}|res_plasma|This is the item's res_plasma. The default is 0.
|{{modarg|ItemType}}|type|This is the item's itype. It also determines which other properties can be used in the prototype.
|}}
}}

=== Armor or Boots ===
These are the fields used by ITEMTYPE_ARMOR and ITEMTYPE_BOOTS.

{{drltable|Armor or Boots Prototype|3|{{Table3Col
|es=background: #333;
|c1=font-weight:bold; text-align:right; vertical-align:top; padding:0px 2px;
|c2=vertical-align:top; padding:0px 2px;
|c3=padding:0px 2px;
|{{modarg|string}}|desc|This is the armor's description that is displayed in the inventory screen.
|{{modarg|integer}}|armor|This is the armor's armor property.
|{{modarg|integer}}|durability|This is the armor's maxdurability as well as its initial durability. The default is 100. (This should still be 100 for armors with no durability, as no durability is achieved by a flag.)
|{{modarg|integer}}|knockmod|This is the armor's knockmod. The default is 0.
|{{modarg|integer}}|movemod|This is the armor's movemod. The default is 0.
|{{modarg|string}}|ascii|This is the armor's picture. It should be a length one string. The default is "[" for body armor and ";" for boots.
|}}
}}

=== Consumable ===
These are the fields used by ITEMTYPE_PACK. This includes mods and relics.

{{drltable|Consumable Prototype|3|{{Table3Col
|es=background: #333;
|c1=font-weight:bold; text-align:right; vertical-align:top; padding:0px 2px;
|c2=vertical-align:top; padding:0px 2px;
|c3=padding:0px 2px;
|{{modarg|string}}|desc|This is the pack's description that is displayed in the inventory screen.
|{{modarg|string}}|mod_letter|This is the shorthand letter by which the pack will be recognized as a mod. Do not fill this value unless this item is meant to be a mod pack.
|{{modarg|function}}|OnUse|Packs must provide an OnUse hook.
|{{modarg|string}}|ascii|This is the pack's picture. It should be a length one string. The default is "+".
|}}
}}

=== Powerup ===
These are the fields used by ITEMTYPE_POWER.

{{drltable|Powerup Prototype|3|{{Table3Col
|es=background: #333;
|c1=font-weight:bold; text-align:right; vertical-align:top; padding:0px 2px;
|c2=vertical-align:top; padding:0px 2px;
|c3=padding:0px 2px;
|{{modarg|function}}|OnPickup|Powerups must provide an OnPickup hook.
|{{modarg|string}}|ascii|This is the powerup's picture. It should be a length one string. The default is "^".
|}}
}}

=== Ammo ===
These are the fields used by ITEMTYPE_AMMO.

{{drltable|Ammo Prototype|3|{{Table3Col
|es=background: #333;
|c1=font-weight:bold; text-align:right; vertical-align:top; padding:0px 2px;
|c2=vertical-align:top; padding:0px 2px;
|c3=padding:0px 2px;
|{{modarg|string}}|desc|This is the ammo's description that is displayed in the inventory screen.
|{{modarg|integer}}|ammo|This is the ammo's initial ammo property.
|{{modarg|integer}}|ammomax|This is the ammo's ammomax property.
|{{modarg|string}}|ascii|This is the ammo's picture. It should be a length one string. The default is "|".
|}}
}}

=== Ammo Pack ===
These are the fields used by ITEMTYPE_AMMOPACK.

{{drltable|Ammo Pack Prototype|3|{{Table3Col
|es=background: #333;
|c1=font-weight:bold; text-align:right; vertical-align:top; padding:0px 2px;
|c2=vertical-align:top; padding:0px 2px;
|c3=padding:0px 2px;
|{{modarg|string}}|desc|This is the ammo pack's description that is displayed in the inventory screen.
|{{modarg|integer}}|ammo|This is the ammo pack's initial ammo property.
|{{modarg|integer}}|ammomax|This is the ammo pack's ammomax property.
|{{modarg|string}}|ammo_id|This is the ammo pack's ammoid property.
|{{modarg|string}}|ascii|This is the ammo pack's picture. It should be a length one string. The default is "!".
|}}
}}

=== Ranged Weapon ===
These fields are used by ITEMTYPE_RANGED.

{{drltable|Ranged Weapon Prototype|3|{{Table3Col
|es=background: #333;
|c1=font-weight:bold; text-align:right; vertical-align:top; padding:0px 2px;
|c2=vertical-align:top; padding:0px 2px;
|c3=padding:0px 2px;
|{{modarg|string}}|desc|This is the weapon's description that is displayed in the inventory screen.
|{{modarg|string}}|damage|This should be a string like "2d4"; the weapon's damage_dice and damage_sides will be parsed from this.
|{{modarg|DamageType}}|damagetype|This is the weapon's damagetype.
|{{modarg|string}}|psprite|This is the sprite used to represent the player when this weapon is equipped. It is only relevant in the graphical version.
|{{modarg|string}}|group|This is the weapon's group for purposes of kill counting. The used weapon groups are "weapon-melee", "weapon-pistol", "weapon-shotgun", "weapon-chain", "weapon-rocket", "weapon-plasma", and "weapon-bfg". The default is "weapon-other".
|{{modarg|string}}|ammo_id|This is the weapon's ammoID.
|{{modarg|integer}}|fire|This is the weapon's usetime. The default is 10.
|{{modarg|integer}}|acc|This is the weapon's acc. The default is 0.
|{{modarg|integer}}|ammomax|This is the weapon's ammomax and the weapon's initial ammo.
|{{modarg|integer}}|radius|This is the weapon's blastradius. The default is 0.
|{{modarg|integer}}|shots|This is the weapon's shots. The default is 0 (which will still give one shot).
|{{modarg|integer}}|shotcost|This is the weapon's shotcost. The default is 0 (which will still require one ammo).
|{{modarg|AltFire}}|altfire|This is the weapon's altfire. The default is ALT_NONE.
|{{modarg|AltReload}}|altreload|This is the weapon's altreload. The default is RELOAD_NONE.
|{{modarg|string}}|altfirename|This is the name the game uses for the weapon's alternate fire mode. Most of the AltFire constants provide defaults.
|{{modarg|string}}|altreloadname|This is the name the game uses for the weapon's alternate reload mode. Most of the AltReload constants provide defaults.
|{{modarg|string}}|sound_id|The sound_id will be used to look up sounds if there are no sounds defined for the weapon's actual id. By convention, this is set as the usual wielder's id when applicable.
|{{modarg|Missile ID}}|overcharge|This field is currently unused.
|{{modarg|Missile ID}} or {{modarg|Missile Prototype}}|missile|This is the weapon's missile. (It will be translated into an nid. To use a shotgun missile, the weapon must have the IF_SHOTGUN flag.) If this property is a table, it will be used to declare a new missile with the same id as the weapon.
|{{modarg|string}}|ascii|This is the weapon's picture. It should be a length one string. The default is "}".
|}}
}}

=== Natural Ranged Weapon ===
These fields are used by ITEMTYPE_NRANGED. Natural ranged weapons are usually defined inline in a {{modarg|Being}} definition.

{{drltable|Natural Ranged Weapon Prototype|3|{{Table3Col
|es=background: #333;
|c1=font-weight:bold; text-align:right; vertical-align:top; padding:0px 2px;
|c2=vertical-align:top; padding:0px 2px;
|c3=padding:0px 2px;
|{{modarg|string}}|damage|This should be a string like "2d4"; the weapon's damage_dice and damage_sides will be parsed from this.
|{{modarg|DamageType}}|damagetype|This is the weapon's damagetype.
|{{modarg|string}}|group|This is the weapon's group for purposes of kill counting. The used weapon groups are "weapon-melee", "weapon-pistol", "weapon-shotgun", "weapon-chain", "weapon-rocket", "weapon-plasma", and "weapon-bfg". The default is "weapon-other".
|{{modarg|integer}}|fire|This is the weapon's usetime. The default is 10.
|{{modarg|integer}}|acc|This is the weapon's acc. The default is 0.
|{{modarg|integer}}|radius|This is the weapon's blastradius. The default is 0.
|{{modarg|integer}}|shots|This is the weapon's shots. The default is 0 (which will still give one shot).
|{{modarg|string}}|sound_id|The sound_id will be used to look up sounds if there are no sounds defined for the weapon's actual id. By convention, a natural weapon's soundID is the usual wielder's id.
|{{modarg|Missile ID}} or {{modarg|Missile Prototype}}|missile|This is the weapon's missile. (It will be translated into an nid. To use a shotgun missile, the weapon must have the IF_SHOTGUN flag.) If this property is a table, it will be used to declare a new missile with the same id as the weapon.
|{{modarg|string}}|ascii|This is the weapon's picture. It should be a length one string. The default is "?".
|}}
}}

=== Melee Weapon ===
These fields are used by ITEMTYPE_MELEE.

{{drltable|Melee Weapon Prototype|3|{{Table3Col
|es=background: #333;
|c1=font-weight:bold; text-align:right; vertical-align:top; padding:0px 2px;
|c2=vertical-align:top; padding:0px 2px;
|c3=padding:0px 2px;
|{{modarg|string}}|desc|This is the weapon's description that is displayed in the inventory screen.
|{{modarg|string}}|damage|This should be a string like "2d4"; the weapon's damage_dice and damage_sides will be parsed from this.
|{{modarg|DamageType}}|damagetype|This is the weapon's damagetype.
|{{modarg|string}}|psprite|This is the projectile sprite used with the weapon. It is only relevant in the graphical version.
|{{modarg|string}}|group|This is the weapon's group for purposes of kill counting. The used weapon groups are "weapon-melee", "weapon-pistol", "weapon-shotgun", "weapon-chain", "weapon-rocket", "weapon-plasma", and "weapon-bfg". The default is "weapon-other".
|{{modarg|integer}}|fire|This is the weapon's usetime. The default is 10.
|{{modarg|integer}}|acc|This is the weapon's acc. The default is 0.
|{{modarg|integer}}|shotcost|This is the weapon's shotcost. The default is 0 (which will still require one ammo).
|{{modarg|AltFire}}|altfire|This is the weapon's altfire. The default is ALT_NONE.
|{{modarg|string}}|altfirename|This is the name the game uses for the weapon's alternate fire mode. Most of the AltFire constants provide defaults.
|{{modarg|Missile ID}} or {{modarg|Missile Prototype}}|missile|This is the missile used if for the throw alternate fire mode.
|{{modarg|Item ID}}|throw_id|In the case where the melee weapon can be thrown, this is the item that appears after the item is thrown. It defaults to the item itself.
|{{modarg|string}}|ascii|This is the weapon's picture. It should be a length one string. The default is "\".
|}}
}}

=== Lever ===
These fields are used by ITEMTYPE_LEVER. DoomRL levers usually also have a target_area custom property.

{{drltable|Lever Prototype|3|{{Table3Col
|es=background: #333;
|c1=font-weight:bold; text-align:right; vertical-align:top; padding:0px 2px;
|c2=vertical-align:top; padding:0px 2px;
|c3=padding:0px 2px;
|{{modarg|string}}|desc|This is the full description of the lever used if the player has BF_LEVERSENSE2.
|{{modarg|string}}|good|This is the qualitative description of the lever used if the player has BF_LEVERSENSE1. By convention, this should be "beneficial", "neutral", or "dangerous".
|{{modarg|integer}}|fullchance|The level generation code will set the lever's target_area to the full map fullchance percent of the time. The default is 0. (To be fair, the level generation code won't generate custom levers.)
|{{modarg|string}}|warning|This message will be displayed by the level generation code if the fullchance roll succeeds.
|null|color_id|This field is required for levers. By convention, it is set to "lever".
|null|sound_id|If the particular lever doesn't have sound bindings, the game will use the sound ID to look for sound bindings. By default, this is "lever".
|{{modarg|string}}|ascii|This is the lever's picture. It should be a length one string. The default is "&".
|}}
}}

=== Teleporter ===
These fields are used by ITEMTYPE_TELE. The built-in teleport item has a custom target property. This can be set to any coord to control the destination.

{{drltable|Teleporter Prototype|3|{{Table3Col
|es=background: #333;
|c1=font-weight:bold; text-align:right; vertical-align:top; padding:0px 2px;
|c2=vertical-align:top; padding:0px 2px;
|c3=padding:0px 2px;
|{{modarg|function}}|OnEnter|This hook is required for teleporters.
|{{modarg|string}}|ascii|This is the teleporter's picture. It should be a length one string. The default is "*".
|}}
}}

=== Flags ===
{{drltable|Item Flags|2|{{Table2Col
|es=background: #333;
|c1=font-family:monospace; text-align:right; vertical-align:top; padding:0px 2px;
|c2=padding:0px 2px;
|IF_CHAMBEREMPTY|For IF_PUMPACTION weapons, this flag indicates whether ammo is in the chamber or not.
|IF_UNIQUE|This flag is set for unique items. Unique items add a player history message when picked up as well as doing a screen blink. Unique items are also not destroyable.
|IF_EXOTIC|This flag is set for exotic items. This is used by the game to compile the special items list.
|IF_MODIFIED|This flag is automatically set for items that have been modded.
|IF_HALFKNOCK|If a weapon with this flag is wielded, all knockback against the wielder will be halved.
|IF_GLOBE|This is a marker flag for items that are disallowed in Angel of Masochism.
|IF_CURSED|Items with this flag cannot be unequipped.
|IF_RECHARGE|Items with this flag regenerate ammo or durability as with a [[Nano Pack]].
|IF_CLEAVE|Items with this flag give the wielder the benefits of the [[Traits#Blademaster|Blademaster]] trait (as [[Butcher's Cleaver]]).
|IF_NOAMMO|Items with this flag don't consume ammo when fired. For the player, a weapon still must have ammo loaded to be fired.
|IF_NECROCHARGE|Items with this flag recharge as with IF_RECHARGE, but reduce the weilder's health by 1 for each point of recharge (as with [[Necroarmor]]).
|IF_PUMPACTION|Ranged weapons with this flag must be pumped after each shot as with the combat shotgun.
|IF_SINGLERELOAD|Ranged weapons with this flag only reload one ammo at a time (as with the missile launcher) instead of all at once.
|IF_PISTOL|This flag indicates whether the weapon counts as a pistol for the purposes of the [[Traits#Son of a Gun|Son of a Gun]] and [[Traits#Dualgunner|Dualgunner]] traits. (For kill counting, the weapon group is used instead.)
|IF_SHOTGUN|This flag causes a weapon's missile to be treated as a shotgun id rather than a missile id. Also, this flag is used to decide if the [[Traits#Shottyman|Shottyman]] trait should count the weapon as a shotgun. (For kill counting, the weapon group is used instead.)
|IF_SPREAD|Ranged weapons with this flag fire three shots at once (as the [[tristar blaster]] and [[mancubus]] natural weapon). In 0.9.9.4, this flag is a bit buggy.
|IF_SCATTER|For ranged weapons with this flag, each shot is aimed at a different cell near the real target (as with the [[BFG 10K]]).
|IF_MODABLE|Allows a unique item to be fully modded.
|IF_SINGLEMOD|Restricts the number of allowed mods on the item to one. (For unique items, this must be used along with IF_MODABLE.)
|IF_DUALSHOTGUN|For multi-shot weapons, this flag eliminates all delay between shots and causes the firing sound to play only once.
|IF_AIHEALPACK|This flag allows the default AI to pick up and use the item.
|IF_NOUNLOAD|Ranged weapons with this flag cannot be unloaded.
|IF_NUKERESIST|Items with this flag will not be destroyed by nuking.
|IF_NODROP|Items with this flag will not be dropped when the carrier/wearer dies.
|IF_AUTOHIT|Weapons with this flag never miss (as with items modified by a sniper weapon pack).
|IF_SETITEM|This flag is automatically set for items that specify a set.
|IF_NODURABILITY|Armors and boots with this flag have no durability (as with items modified by an Onyx Armor Pack).
|IF_NODESTROY|Armors with this flag cannot be destroyed by damage. Also, items on the ground with this flag will not be destroyed by explosions.
|IF_NONMODABLE|Items with this flag cannot be modded.
|IF_NOREPAIR|Armors and boots with this flag cannot be repaired by normal methods (ie item:fix). Directly setting item.durability bypasses this prohibition.
|IF_ASSEMBLED|This flag is automatically set on assemblies. Items with this flag cannot be used for the base of any other assembly.
|IF_DESTROY|Weapons with this flag will be destroyed after firing (with a default message). The flag is used for overcharged weapons.
|IF_BLADE|Weapons with this flag are considered blades for the purpose of activating the flags used for [[Traits#Malicious Blades|Malicious Blades]].
|IF_DESTRUCTIVE|Weapons with this flag deal double damage to cells (if they can hurt cells, see [[Modding:Cell|CF_FRAGILE]].)
|IF_ROCKET|
|IF_FARHIT|
|IF_UNSEENHIT|
|IF_NODEGRADE|
|IF_THROWDROP|
|}}
}}

== Engine Hooks ==
These hooks can give greater flexibility for how items work. For some item types, a hook provides the primary function. Sometimes, the engine will add to explicitly defined hooks, but this shouldn't interfere with a modder's use of the hooks. However, modders should be careful when changing hooks.
{|class="wikitable" style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
! colspan="2" style="background: darkred; color: yellow; font-size: 120%; text-align: center"|Item Hooks
{{Table2Col
|es=background: #333;
|c1=font-weight:bold; text-align:right; vertical-align:top; padding:0px 2px;
|c2=padding:0px 2px;
|{{modarg|boolean}}|[[#item_OnCreate|OnCreate]]({{modarg|Item}} self)
|{{modarg|boolean}}|[[#item_OnPickup|OnPickup]]({{modarg|Item}} self, {{modarg|Being}} getter)
|{{modarg|boolean}}|[[#item_OnFirstPickup|OnFirstPickup]]({{modarg|Item}} self, {{modarg|Being}} getter)
|{{modarg|boolean}}|[[#item_OnPickupCheck|OnPickupCheck]]({{modarg|Item}} self, {{modarg|Being}} getter)
|{{modarg|boolean}}|[[#item_OnUse|OnUse]]({{modarg|Item}} self, {{modarg|Being}} user)
|{{modarg|boolean}}|[[#item_OnUseCheck|OnUseCheck]]({{modarg|Item}} self, {{modarg|Being}} user)
|{{modarg|boolean}}|[[#item_OnReload|OnReload]]({{modarg|Item}} self, {{modarg|Being}} reloader)
|{{modarg|boolean}}|[[#item_OnAltFire|OnAltFire]]({{modarg|Item}} self, {{modarg|Being}} firer)
|{{modarg|boolean}}|[[#item_OnAltReload|OnAltReload]]({{modarg|Item}} self, {{modarg|Being}} reloader)
|{{modarg|boolean}}|[[#item_OnEquip|OnEquip]]({{modarg|Item}} self, {{modarg|Being}} equipper)
|{{modarg|boolean}}|[[#item_OnEquipTick|OnEquipTick]]({{modarg|Item}} self, {{modarg|Being}} wearer)
|{{modarg|boolean}}|[[#item_OnEquipCheck|OnEquipCheck]]({{modarg|Item}} self, {{modarg|Being}} equipper)
|{{modarg|boolean}}|[[#item_OnRemove|OnRemove]]({{modarg|Item}} self, {{modarg|Being}} wearer)
|{{modarg|boolean}}|[[#item_OnKill|OnKill]]({{modarg|Item}} self, {{modarg|Being}} dier, {{modarg|Being}} wearer)
|{{modarg|boolean}}|[[#item_OnHitBeing|OnHitBeing]]({{modarg|Item}} self, {{modarg|Being}} attacker, {{modarg|Being}} target)
|{{modarg|boolean}}|[[#item_OnEnter|OnEnter]]({{modarg|Item}} self, {{modarg|Being}} enterer)
|{{modarg|boolean}}|[[#item_OnFire|OnFire]]({{modarg|Item}} self, {{modarg|Being}} firer)
|{{modarg|boolean}}|[[#item_OnFired|OnFired]]({{modarg|Item}} self, {{modarg|Being}} firer)
|}}
|}

{{Anchor|item_OnCreate}}
;OnCreate({{modarg|Item}} self)
:This hook is called when the item is created. For ammo, beware: the game creates and destroys ammo items liberally as a normal part of ammo management.
----
{{Anchor|item_OnPickup}}
;OnPickup({{modarg|Item}} self, {{modarg|Being}} getter)
:When an item is picked up, this hook is called with the being that is picking the item up. This is most commonly used to implement powerups.
----
{{Anchor|item_OnFirstPickup}}
;OnFirstPickup({{modarg|Item}} self, {{modarg|Being}} getter)
:When an item with a given id is picked up for the first time, the function is called. This only works for items that go into the inventory.
----
{{Anchor|item_OnPickupCheck}}
;OnPickupCheck({{modarg|Item}} self, {{modarg|Being}} getter) → '''boolean'''
:When a being tries to pick up an item, this function is called with the being that is trying to pick it up. If the return value is true, then the being is allowed to pick the item up, otherwise the being can't. For the player, both cases include the item in the player's previously found items. (This can affect OnFirstPickup.)
----
{{Anchor|item_OnUse}}
;OnUse({{modarg|Item}} self, {{modarg|Being}} user) → '''boolean'''
:This hook is called when levers are used and when packs are used with the being that it using the item. For packs, if the return value is true, the item is consumed, otherwise it is left in the inventory. For levers, the return value is ignored and it is safe not to have a return value.
----
{{Anchor|item_OnUseCheck}}
;OnUseCheck({{modarg|Item}} self, {{modarg|Being}} user) → '''boolean'''
:This hook is called called before OnUse for levers and packs. If the return value is false, then the being can't use the item, otherwise it can. For levers, this can control whether the lever statistic is increased.
----
{{Anchor|item_OnReload}}
;OnReload({{modarg|Item}} self, {{modarg|Being}} reloader) → '''boolean'''
:If it is declared, this hook is called when a weapon is reloaded. If the return value is false, then the normal reload procedure is aborted. This can be used to prevent reloading or to implement a custom reloading mechanism (like for the [[Acid Spitter]]). If true is returned, the weapon is reloaded normally afterwards.
----
{{Anchor|item_OnAltFire}}
;OnAltFire({{modarg|Item}} self, {{modarg|Being}} firer) → '''boolean'''
:This hook works exactly like the OnFire hook, except it is called when the weapon's alternate fire mode is used for weapons with ALT_SCRIPT altfire.
----
{{Anchor|item_OnAltReload}}
;OnAltReload({{modarg|Item}} self, {{modarg|Being}} reloader)
:If the weapon's altreload is RELOAD_SCRIPT, then this hook is called with when the weapon's alternate reload mode is used.
----
{{Anchor|item_OnEquip}}
;OnEquip({{modarg|Item}} self, {{modarg|Being}} equipper)
:This hook is called when the item is equipped in any equipment slot. Due to a bug, equipper is the active being. This is always correct during normal play, but modders must be careful when manually equipping items with this hook.
----
{{Anchor|item_OnEquipTick}}
;OnEquipTick({{modarg|Item}} self, {{modarg|Being}} wearer)
:While this item is equipped in any slot (including the prepared slot), this function is called on each of the being's actions. (Despite the name, it probably won't be called on every tick; it depends on the being's speed.)
----
{{Anchor|item_OnEquipCheck}}
;OnEquipCheck({{modarg|Item}} self, {{modarg|Being}} equipper) → '''boolean'''
:This function is called (before OnEquip) when the player tries to equip an item. If the return value is true, then the player is allowed to equip the item; otherwise the player isn't allowed to equip the item.
----
{{Anchor|item_OnRemove}}
;OnRemove({{modarg|Item}} self, {{modarg|Being}} wearer)
:This hook is called when a being unequips the item, or when the item is otherwise removed from the being's equipment. This includes armor being destroyed by damage. Like OnEquip, this is called with the active being which can cause problems especially if this hook is called for armor destruction.
----
{{Anchor|item_OnKill}}
;OnKill({{modarg|Item}} self, {{modarg|Being}} dier, {{modarg|Being}} wearer)
:When a being dies, this hook is called on all of the active being's equipment. This includes the prepared slot. (Weapons can check what slot they are in inside of this hook.)
----
{{Anchor|item_OnHitBeing}}
;OnHitBeing({{modarg|Item}} self, {{modarg|Being}} attacker, {{modarg|Being}} target) → '''boolean'''
:For weapons with no blastradius, this hook is called whenever a being is hit with the weapon. This hook is called before applying damage. If the return value is true, damage is applied as usual. Otherwise, the damage phase is skipped.
----
{{Anchor|item_OnEnter}}
;OnEnter({{modarg|Item}} self, {{modarg|Being}} enterer)
:This function is called whenever a being enters a cell that has the item lying on the floor. For the player, this supresses the usual "There is an item lying here" message. This is used in DoomRL to implement teleports.
----
{{Anchor|item_OnFire}}
;OnFire({{modarg|Item}} self, {{modarg|Being}} firer) → '''boolean'''
:This hook is called when a weapon is fired. This only works for normal firing, not alternative firing (see OnAltFire). This hook is called before a target is selected. If the return value is true, then the rest of the normal firing operation is aborted. If the return value is false, then it continues as usual.
----
{{Anchor|item_OnFired}}
;OnFired({{modarg|Item}} self, {{modarg|Being}} firer)
:This hook is called after a weapon is fired. This is after the entire usual firing procedure including damage, etc. Currently, this only works for the player.

== Properties ==
Items also have all the [[Modding:Thing|Thing]] properties in addition to those listed below. For items, the meaning of the resistance fields vary depending on the item type. For armor and boots, the resistances are applied only to attacks to the corresponding target. For other equipment, the resistance applies to all attacks. For non-equipment, the resistances aren't used. Also, some properties are only valid for armor, and some are only valid for weapons. For these purposes, armor are items with itype ITEMTYPE_ARMOR and ITEMTYPE_BOOTS and weapons are items with itype ITEMTYPE_AMMO, ITEMTYPE_MELEE, ITEMTYPE_NRANGED, ITEMTYPE_RANGED, and ITEMTYPE_AMMOPACK. Properties of the incorrect type are always indexable, but they may share a memory address with properties of the opposite type, so modders should only use this feature very carefully. The type of such properties is noted. Also, the meaning of many fields is slightly different depending on the itype; these differences are also described.

{{drltable|Item|3|{{Table3Col
|es=background: #333;
|c1=font-weight:bold; text-align:right; vertical-align:top; padding:0px 2px;
|c2=vertical-align:top; padding:0px 2px;
|c3=padding:0px 2px;
|{{modarg|ItemType}}|itype|This determines the basic features of the item. ITEMTYPE_NONE has no features; it can't be picked up or used. ITEMTYPE_RANGED can be picked up and wielded as a ranged weapon. ITEMTYPE_NRANGED is like ITEMTYPE_RANGED, but it isn't designed to exist on the map. ITEMTYPE_ARMOR can be picked up and equipped as armor. ITEMTYPE_MELEE can be picked up and wielded as a melee weapon. ITEMTYPE_AMMO is always a new ammo type that can be picked up and stacked. ITEMTYPE_PACK items can be picked up and used. ITEMTYPE_POWER items are consumed when they are picked up. ITEMTYPE_BOOTS can be picked up and worn as boots. ITEMTYPE_TELE have no special features, but by convention they interact with OnEnter. ITEMTYPE_LEVER have special description routines, and they can be used while on the floor. ITEMTYPE_AMMOPACK can be picked up and wielded in the prepared slot. They provide reloading benefits. While it is possible to change an item's itype, this should almost never be done. If it is done, care must be taken to account for overlapping weapon and armor properties.
|{{modarg|byte}}|armor|For armor and boots, this is the amount of [[protection]] provided at full durability. Weapons in the main slot may also provide a (universal) protection bonus with this field.
|{{modarg|word}}|durability|For armor and boots, this is the current amount of durability of the item. This property is armor-specific.
|{{modarg|word}}|maxdurability|For armor and boots, this is the maximum amount of durability. Most effects won't raise the durability above maxdurability. This property is armor-specific.
|{{modarg|integer}}|movemod|For armor and boots, this percentage movement speed modifier is applied while the item is equipped. This property is armor-specific.
|{{modarg|integer}}|knockmod|For armor and boots, this percentage [[knockback]] modifier is applied while the item is equipped. This property is armor-specific.
|[[Modding:Item|Item ID]]|ammoid|This must always be a number id. For ranged weapons, this is the item id of the kind of ammo the weapon uses. For ammo packs, this is the kind of ammo provided by the pack. This property is weapon-specific.
|{{modarg|word}}|ammo|For ranged weapons, this is the amount of currently-loaded ammo. For ammo packs and ammo stacks, this is the amount of ammo inside. This property is weapon-specific.
|{{modarg|word}}|ammomax|For ranged weapons, this is the size of the magazine. For ammo stacks, this is the maximum stack size (unaffected by BF_BACKPACK). For ammo packs, this is the initial amount of ammo. This property is weapon-specific.
|{{modarg|word}}|acc|For ranged and melee weapons, this is an [[accuracy]] modifier applied to attacks with the weapon. This property is weapon-specific.
|{{modarg|word}}|damage_sides|For weapons, this is the number of dice rolled for damage (e.g. the X of XdY). This property is weapon-specific.
|{{modarg|word}}|damage_dice|For weapons, this is the number of sides on each die rolled for damage (e.g. the Y of XdY). This property is weapon-specific.
|{{modarg|integer}}|damage_add|For weapons, this is a flat bonus added to all damage rolls. This property is weapon-specific.
|{{modarg|Missile ID}}|missile|This must always be a number id. For ranged weapons, this is the missile used by the weapon. For melee weapons, this is the missile used by the throw alternate fire mode (if any). This property is weapon-specific.
|{{modarg|byte}}|blastradius|This is the [[Distance|radius]] of the explosion caused by a ranged weapon. This should be 0 for weapons with no explosion. This property is weapon-specific.
|{{modarg|byte}}|shots|This is the number of shots fired by a rapid-fire ranged weapon. This should be 0 (not 1) for single-shot weapons. This property is weapon-specific.
|{{modarg|byte}}|shotcost|This is the amount of ammo consumed by each shot with a ranged weapon. This should be 0 (not 1) for weapons that take only one ammo per shot. This property is weapon-specific.
|{{modarg|byte}}|reloadtime|This is the number of 0.1s intervals it takes (without modifiers) to reload a ranged weapon. This property is weapon-specific.
|{{modarg|byte}}|usetime|This is the number of 0.1s intervals it takes (without modifiers) to fire/use a weapon. This property is weapon-specific.
|{{modarg|DamageType}}|damagetype|This is the [[Damage type|type]] of the damage caused by a weapon. This property is weapon-specific.
|{{modarg|AltFire}}|altfire|This is the alternate fire mode of a weapon. For ALT_SCRIPT, the details depend on the OnAltFire hook. This property is weapon-specific.
|{{modarg|AltReload}}|altreload|This is the alternate reload mode of a ranged weapon. For RELOAD_SCRIPT, the details depend on the OnAltReload hook. This property is weapon-specific.
|{{modarg|string}}|desc|This is the string used to describe the item in the inventory list. For the description in the inventory sidebar, use .proto.desc. This property is read-only.
|{{modarg|Item Prototype}}|__proto|This is the item's prototype. You can access item prototype fields using this (e.g., item.__proto.color).
|}}
}}
== API ==

The [[Modding:Thing#API|Thing API]] can also be used with items.
{|class="wikitable" style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
! colspan="2" style="background: darkred; color: yellow; font-size: 120%; text-align: center"|Item Interface
{{Table2Col
|es=background: #333;
|c1=font-weight:bold; text-align:right; vertical-align:top; padding:0px 2px;
|c2=padding:0px 2px;
|{{modarg|Item}}|{{moddef|list|new|dot||Item ID|iid}}
|{{modarg|boolean}}|{{moddef|list|add_mod|cln||string|modletter}}
|{{modarg|boolean}}|{{moddef|list|can_mod|cln||string|modletter}}
|{{modarg|integer}}|{{moddef|list|get_mod|cln||string|modletter}}
|{{modarg|boolean}}|{{moddef|list|clear_mods|cln}}
|{{modarg|boolean}}|{{moddef|list|is_damaged|cln}}
|{{modarg|boolean}}|{{moddef|list|fix|cln||integer|amount}}
|{{modarg|table}}|{{moddef|list|get_mods|cln}}
|{{modarg|table}}|{{moddef|list|get_mod|ids|cln}}
|{{modarg|boolean}}|{{moddef|list|can_overcharge|cln}}
|{{modarg|boolean}}|{{moddef|list|check_mod_array|cln||string|nextmod|integer|techbonus}}
|}}
|}

{{moddef|desc|new|dot|Item|Item ID|iid}}
:This returns a newly allocated item create from the specified prototype. This item doesn't exist in the game yet; it must be dropped on the level, added to an inventory, or equipped.
----
{{moddef|desc|add_mod|cln|boolean|string|modletter}}
:Adds a mod to the item's mod list and sets the IF_MODIFIED flag. This does not apply any affects of the mod, it is only a primitive operation for accessing the mod list. ''modletter'' should be a single uppercase letter representing the mod. This will check modding restrictions (as [[#item_can_mod|can_mod]]) and return true on success, false on failure.
----
{{moddef|desc|can_mod|cln|boolean|string|modletter}}
:Determines if the given mod can be added to the item. ''modletter'' should be a single uppercase letter representing the mod. This will always use the player's techbonus. It also accounts for limits on the number of mods of a given type and various modability item flags.
----
{{moddef|desc|get_mod|cln|integer|string|modletter}}
:Counts the number of the given mod that have already been added to the item. ''modletter'' should be a single uppercase letter representing the mod.
----
{{moddef|desc|clear_mods|cln|boolean}}
:Clears the counts of all mods for the item. The does not undo the affects of the mods nor does it change any flags (including IF_MODIFIED).
----
{{moddef|desc|is_damaged|cln|boolean}}
:This determines if the item's durability is less than its maxdurability. For items with IF_NOREPAIR, this function always returns false. (So, in effect this function determines if the item needs to be repaired.)
----
{{moddef|desc|fix|cln|boolean|integer|amount}}
:This will increase the item's durability by amount, respecting maxdurability. It returns true is the item is no longer is_damaged. ''amount'' is optional; by default the item is completely repaired.
----
{{moddef|desc|get_mods|cln|table}}
:This will return a table that maps single character mod letters to the corresponding amount of mods that have been applied to the item. Mod letters that have not been applied are not included as keys.
----
{{moddef|list|get_mod|ids|cln|table}}
:As get_mods, but the table returned gives all mods in terms of their sID.
----
{{moddef|desc|can_overcharge|cln|boolean}}
:This will determine if the item can be overcharged. To be overcharged, an item can't already by overcharged (IF_DESTROY), and must be fully loaded. The ui part of overcharging is included. On success, IF_DESTROY and IF_NOUNLOAD are set, but other affects must be applied by the caller.
----
{{moddef|desc|check_mod_array|cln|boolean|string|nextmod|integer|techbonus}}
:This will check if the mod indicated by ''nextmod'' (the single uppercase character representing the mod) could form an assembly (given the provided techbonus). If so, the assembly is created on the item (if the player confirms the ui message) with all associated side effects. Returns true only if the assembly is actually created.

Template:Level Flags (0.9.9.7)

2013-07-02T12:10:14Z

Rabinowitz:

{{drltable|Level Flags|2|{{Table2Col
|es=background: #333;
|c1=font-family:monospace; text-align:right; vertical-align:top; padding:0px 2px;
|c2=padding:0px 2px;
|LF_NOHOMING|Causes homing phase devices to act like normal phase devices.
|LF_UNIQUEITEM|Used by the level generation code to keep track of whether a unique item has dropped on the current level (in order to prevent multiple uniques from dropping on one level). This flag also causes a level feeling to occur indicating that a unique item is present.
|LF_BONUS|This flag is automatically set for so-called special levels like [[Halls of Carnage]]. (It is not set for those special levels like [[Hellgate]] that replace normal levels, only by those reached from red stairs.)
|LF_SCRIPT|This flag is automatically set for scripted levels, ie levels defined with the [[Modding:level blueprint|level blueprint]].
|LF_NORESPAWN|Prevents the Nightmare! respawn feature.
|LF_NUKED|This flag is automatically set when the level is nuked.
|LF_NONUKE|Causes the thermonuclear bomb to have no effect when it is used. It is not respected by other nuke effects.
|LF_ITEMSVISIBLE|Allows the player to see all items on the level (as with a [[Computer Map]]).
|LF_BEINGSVISIBLE|Allows the player to see all beings on the level (as with a [[Tracking Map]]).
|LF_RESPAWN|Causes monsters to randomly respawn as when playing the game on Nightmare!
|LF_SHARPFLUID| ???
|}}
}}

Modding:Constants

2013-07-02T11:54:12Z

Rabinowitz: /* DamageType */ DAMAGE_SPLASMA 0997

Constants and Enumerations are common in any game and DoomRL is no exception. Internally, as most programmers are aware, these are integers. But to modders they are all important magic values, looked up here.

== Engine Enums ==

==== ItemType ====

Every item has a type that determines how the engine treats it.

{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TItemType'''
|-
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_NONE
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_RANGED
|-
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_NRANGED
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_ARMOR
|-
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_MELEE
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_AMMO
|-
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_PACK
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_POWER
|-
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_BOOTS
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_TELE
|-
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_LEVER
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ITEMTYPE_AMMOPACK
|}

==== BodyTarget ====

Sources of damage must specify a body target to determine which sources of armor are used. Inherent armor bonuses always apply.

{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TBodyTarget'''
|-
|style="vertical-align:top; padding-right: 2ex;"|TARGET_INTERNAL
|Protection from boots and armor will be ignored.
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|TARGET_TORSO
|Protection from armor counts but protection from boots does not.
|-
|style="vertical-align:top; padding-right: 2ex;"|TARGET_FEET
|Protection from boots counts but protection from armor does not.
|}

==== EqSlot ====

It is preferred to use the (equivalent) [[#Equip Slots|slot]] constants.

{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TEqSlot'''
|-
|style="vertical-align:top; padding-right: 2ex;"|EFTORSO
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EFWEAPON
|-
|style="vertical-align:top; padding-right: 2ex;"|EFBOOTS
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EFWEAPON2
|}

==== StatusEffect ====

[[Modding:Affects|Affects]] specify one of these status effects that will apply a color scheme to all the tiles on the HUD.

{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TStatusEffect'''
|-
|style="vertical-align:top; padding-right: 2ex;"|STATUSNORMAL
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|STATUSINVERT
|-
|style="vertical-align:top; padding-right: 2ex;"|STATUSRED
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|STATUSGREEN
|}

==== DamageType ====

Sources of damage usually specify a damage type that determines how the damage regards protection, resistances, gibbing, and other things. For details on the differences between the damage types, look [[Damage type|here]].

{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TDamageType'''
|-
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_BULLET 
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_MELEE 
|-
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_SHARPNEL [sic] 
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_ACID 
|-
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_FIRE 
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_PLASMA 
|-
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_SPLASMA 
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|DAMAGE_IGNOREARMOR 
|}

==== AltFire ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TAltFire'''
|-
|style="vertical-align:top; padding-right: 2ex;"|ALT_NONE
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ALT_CHAIN
|-
|style="vertical-align:top; padding-right: 2ex;"|ALT_THROW
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ALT_SCRIPT
|-
|style="vertical-align:top; padding-right: 2ex;"|ALT_AIMED
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|ALT_SINGLE
|-
|style="vertical-align:top; padding-right: 2ex;"|ALT_WHIRLWIND
|}

==== AltReload ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TAltReload'''
|-
|style="vertical-align:top; padding-right: 2ex;"|RELOAD_NONE
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|RELOAD_SCRIPT
|-
|style="vertical-align:top; padding-right: 2ex;"|RELOAD_FULL
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|RELOAD_DUAL
|-
|style="vertical-align:top; padding-right: 2ex;"|RELOAD_SINGLE
|}

==== ExplosionFlag ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=3 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''TExplosionFlag'''
|-
|style="vertical-align:top; padding-right: 2ex;"|EFSELFHALF
|Deals half damage to the active being.
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EFSELFKNOCKBACK
|Gives extra knockback to the active being.
|-
|style="vertical-align:top; padding-right: 2ex;"|EFSELFSAFE
|Deals no damage to the active being.
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EFAFTERBLINK
|Blinks the screen after the explosion finishes.
|-
|style="vertical-align:top; padding-right: 2ex;"|EFCHAIN
|Causes secondary explosions (as the [[BFG 9000]]).
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EFHALFKNOCK
|Causes half the usual knockback.
|-
|style="vertical-align:top; padding-right: 2ex;"|EFNOKNOCK
|Doesn't cause knockback.
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EFRANDOMCONTENT
|Transmutes some cells in the explosion to the explosion's content cell; the rules is to transmute when damage is greater than 20.
|}

====Level Flag====
{{Template:Level_Flags}}

====Light Flag====
{{Template:Light_Flags}}

== Constants ==

==== Maximums ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Maximums'''
|-
|style="vertical-align:top; padding-right: 2ex;"|MAXX || 78
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|MAXY || 20
|-
|style="vertical-align:top; padding-right: 2ex;"|BOSS_LEVEL || 25
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|MAXDEPTH || 26
|-
|style="vertical-align:top; padding-right: 2ex;"|MAXAFFECT || 5
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|MAX_INV_SIZE || 22
|-
|style="vertical-align:top; padding-right: 2ex;"|MAX_EQ_SIZE || 4
|}

==== Cellsets ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Cellsets'''
|-
|style="vertical-align:top; padding-right: 2ex;"|CELLSET_WALLS
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|CELLSET_FLOORS
|-
|style="vertical-align:top; padding-right: 2ex;"|CELLSET_CORPSES
|}

==== Challenges ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Challenges'''
|-
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_BERSERK
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_MARKSMANSHIP
|-
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_SHOTGUNNERY
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_LIGHTTRAVEL
|-
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_IMPATIENCE
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_HASTE
|-
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_PURITY
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_REDALERT
|-
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_CARNAGE
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_MASOCHISM
|-
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_100
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_PACIFISM
|-
|style="vertical-align:top; padding-right: 2ex;"|CHALLENGE_HUMANITY
|}

==== Difficulty ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Difficulty'''
|-
|style="vertical-align:top; padding-right: 2ex;"|DIFF_EASY
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|DIFF_MEDIUM
|-
|style="vertical-align:top; padding-right: 2ex;"|DIFF_HARD
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|DIFF_VERYHARD
|-
|style="vertical-align:top; padding-right: 2ex;"|DIFF_NIGHTMARE
|}

==== PlayerRank ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''PlayerRank'''
|-
|style="vertical-align:top; padding-right: 2ex;"|RANKEXP
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|RANKSKILL
|}

==== Player Statistics ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Player Statistics'''
|-
|style="vertical-align:top; padding-right: 2ex;"|RANK_KILLTOTAL
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|RANK_KILLMELEE
|-
|style="vertical-align:top; padding-right: 2ex;"|RANK_KILLPISTOL
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|RANK_LEVEL
|-
|style="vertical-align:top; padding-right: 2ex;"|RANK_BADGE
|}

==== Equip Slots ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Equip Slots'''
|-
|style="vertical-align:top; padding-right: 2ex;"|SLOT_ARMOR
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|SLOT_WEAPON
|-
|style="vertical-align:top; padding-right: 2ex;"|SLOT_BOOTS
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|SLOT_PREPARED
|}

==== Colors ====
Usually, it is possible to specify a foreground color and a background color. Since DoomRL uses 4 bit color, the lowest 4 bits determine the foreground color, and the next 4 bits determine the background color (zero is black). Occasionally, one of these may conflict with one of the special color constants. See [[Modding:Color]] for details.

Also, note that the exact color the end-user sees may depend on his system settings.
For the basic 16 colors, the valkyrie string coloring escape is noted.
{{Template:Color}}
{{Template:Special_Color}}

== Flags ==

==== Being Flags ====
{{Template:Being_Flags}}

Some flags have no effect on non-player beings. Most trait flags are that way.

==== Generic Flags ====
{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=3 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Generic Flags'''
|-
|style="vertical-align:top; padding-right: 2ex;"|F_OVERLAY
|This flag is related to the graphical version.
|}

==== Empty Flags ====
Empty flags are used with various functions to control the selection of random coords.

{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Empty Flags'''
|-
|style="vertical-align:top; padding-right: 2ex;"|EF_NOITEMS
|Excludes cells that contain an item.
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EF_NOBEINGS
|Excludes cells that contain a being.
|-
|style="vertical-align:top; padding-right: 2ex;"|EF_NOBLOCK
|Excludes cells that block movement (CF_BLOCKMOVE).
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EF_NOVISION
|Excludes cells that block vision (CF_BLOCKLOS).
|-
|style="vertical-align:top; padding-right: 2ex;"|EF_NOSTAIRS
|Excludes stairs (cells with an OnExit hook).
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EF_NOTELE
|Excludes cells with a teleporter (an item with ITEMTYPE_TELE).
|-
|style="vertical-align:top; padding-right: 2ex;"|EF_NOHARM
|Excludes hazardous cells (CF_HAZARD).
|- style="background: #333;"
|style="vertical-align:top; padding-right: 2ex;"|EF_NOSAFE
|Excludes cells that are too near to the player (currently the threshold is less than or equal to distance of 5).
|-
|style="vertical-align:top; padding-right: 2ex;"|EF_NOSPAWN
|Excludes cells with LF_NOSPAWN.
|}

Subtle Knife

2013-07-02T00:46:09Z

Rabinowitz:

{{infostrat switch}}
{{melee weapon|
weapon_name=Subtle Knife - [[Melee_Types|Melee Family]]|
weapon_dmg=3d5/3-15|
weapon_avgdmg=9|
weapon_dmgtype=[[Damage type#BFG Plasma|BFG Plasma]]|
weapon_accuracy=+0|
weapon_afire=Invoke|
weapon_get=Random (15+)|
weapon_quote=''Looks very inconspicious.''|
weapon_looks=\|
weapon_description=''A weapon that can cut the very fabric of reality. Too bad it's only eight inches long...''|
weapon_other=Using invoke will deal 10 [[Damage type#BFG Plasma|BFG Plasma]] damage to all enemies you can see, at the cost of making you [[Tactics|tired]] and reducing your max health by 2 points. Takes 1 second to activate.
The Subtle Knife is a blade, so it can be used with [[Traits#Malicious Blades|Malicious Blades]].|
weapon_source={{Wiki|The_Subtle_Knife|His Dark Materials}}by Philip Pullman}}

Item Generation

2013-07-01T19:53:51Z

Rabinowitz: statistics

{{Technical}}

Note that this section only describes items that are dropped explicitly; in addition many monsters also carry items (usually guns and ammo). Also, some special level features (e.g. [[Room Generation#Vaults|vaults]]) can cause additional items to drop beyond what is described here.

Item placement is similar to monster placement. Every item has a minimum dlevel and a weight. Here are the levels and weights for all the items:
{|
|style="vertical-align: text-top;"|
{|class="wikitable" style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
! colspan="3" style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Common Items'''
|-
|style="text-align: left; padding-right: 1ex;"|'''Item'''
|style="text-align: left;"|'''Level'''
|style="text-align: left; padding-left: 1ex;"|'''Weight'''
{{Table3Col
|os=background: #333; padding:0px 2px;
|c1=text-align:left; vertical-align:top; padding:0px 2px;
|c2=text-align:right; vertical-align:top; padding:0px 2px; padding-left: 1ex;
|c3=text-align:right; vertical-align:top; padding:0px 2px; padding-left: 1ex;
|[[combat knife]]
|1
|640
|[[pistol]]
|1
|70
|[[shotgun]]
|2
|150
|[[combat shotgun]]
|6
|200
|[[double shotgun]]
|4
|100
|[[chaingun]]
|5
|200
|[[rocket launcher]]
|7
|200
|[[plasma rifle]]
|12
|70
|[[10mm ammo]]
|1
|500
|[[shotgun shell]]
|2
|700
|[[rocket]]
|5
|400
|[[power cell]]
|8
|200
|[[10mm ammo chain]]
|3
|60
|[[shell box]]
|4
|60
|[[rocket box]]
|7
|36
|[[power battery]]
|10
|18
|[[green armor]]
|1
|400
|[[blue armor]]
|4
|240
|[[red armor]]
|9
|150
|[[steel boots]]
|4
|240
|[[protective boots]]
|7
|150
|[[plasteel boots]]
|11
|80
|[[small med-pack]]
|1
|600
|[[large med-pack]]
|5
|400
|[[phase device]]
|5
|200
|[[homing phase device]]
|7
|100
|[[envirosuit pack]]
|5
|100
|[[thermonuclear bomb]]
|10
|40
|[[power mod pack]]
|7
|120
|[[agility mod pack]]
|6
|120
|[[bulk mod pack]]
|6
|120
|[[technical mod pack]]
|5
|120
|[[Small Health Globe]]
|1
|900
|[[Large Health Globe]]
|6
|330
|[[Supercharge Globe]]
|4
|150
|[[armor shard]]
|5
|700
|[[Megasphere]]
|16
|60
|[[Berserk Pack]]
|1
|200
|[[Invulnerability Globe]]
|7
|200
|[[Computer Map]]
|1
|200
|[[Light-Amp Goggles]]
|1
|80
|[[Tracking Map]]
|1
|80
}}
|}
|style="vertical-align: text-top;"|
{|class="wikitable" style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
! colspan="3" style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Exotic Items'''
|-
|style="text-align: left; padding-right: 1ex;"|'''Item'''
|style="text-align: left;"|'''Level'''
|style="text-align: left; padding-left: 1ex;"|'''Weight'''
{{Table3Col
|os=background: #333; padding:0px 2px;
|c1=text-align:left; vertical-align:top; padding:0px 2px;
|c2=text-align:right; vertical-align:top; padding:0px 2px; padding-left: 1ex;
|c3=text-align:right; vertical-align:top; padding:0px 2px; padding-left: 1ex;
|{{exotic link|acid-proof boots}}
|8
|5
|{{exotic link|assault shotgun}}
|6
|6
|{{exotic link|BFG 9000}}
|20
|2
|{{exotic link|blaster}}
|8
|2
|{{exotic link|blood skull}}
|5
|8
|{{exotic link|ballistic shield}}
|6
|3
|{{exotic link|ballistic vest}}
|2
|5
|{{exotic link|bullet-proof vest}}
|2
|4
|{{exotic link|chainsaw}}
|12
|3
|{{exotic link|combat pistol}}
|4
|6
|{{exotic link|combat translocator}}
|14
|3
|{{exotic link|duelist armor}}
|5
|6
|{{exotic link|energy shield}}
|8
|3
|{{exotic link|energy-shielded vest}}
|5
|3
|{{exotic link|fire skull}}
|7
|8
|{{exotic link|firestorm weapon pack}}
|10
|4
|{{exotic link|gothic armor}}
|15
|6
|{{exotic link|gothic boots}}
|10
|6
|{{exotic link|hatred skull}}
|9
|8
|{{exotic link|laser rifle}}
|12
|5
|{{exotic link|medical armor}}
|5
|6
|{{exotic link|minigun}}
|10
|6
|{{exotic link|missile launcher}}
|10
|6
|{{exotic link|Nano Pack}}
|10
|4
|{{exotic link|nuclear BFG 9000}}
|22
|2
|{{exotic link|nuclear plasma rifle}}
|15
|4
|{{exotic link|napalm launcher}}
|10
|6
|{{exotic link|onyx armor}}
|7
|4
|{{exotic link|Onyx Armor Pack}}
|10
|4
|{{exotic link|phaseshift armor}}
|10
|6
|{{exotic link|phaseshift boots}}
|8
|6
|{{exotic link|plasma shield}}
|10
|3
|{{exotic link|plasma shotgun}}
|12
|4
|{{exotic link|sniper weapon pack}}
|10
|4
|{{exotic link|super shotgun}}
|10
|5
|{{exotic link|shockwave pack}}
|5
|10
|{{exotic link|tristar blaster}}
|12
|4
}}
|}
|style="vertical-align: text-top;"|
{|class="wikitable" style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
! colspan="3" style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Unique Items'''
|-
|style="text-align: left; padding-right: 1ex;"|'''Item'''
|style="text-align: left;"|'''Level'''
|style="text-align: left; padding-left: 1ex;"|'''Weight'''
{{Table3Col
|os=background: #333; padding:0px 2px;
|c1=text-align:left; vertical-align:top; padding:0px 2px;
|c2=text-align:right; vertical-align:top; padding:0px 2px; padding-left: 1ex;
|c3=text-align:right; vertical-align:top; padding:0px 2px; padding-left: 1ex;
|{{unique link|Acid Spitter}}
|12
|3
|{{unique link|Anti-Freak Jackal}}
|10
|2
|{{unique link|Berserker Armor}}
|10
|1
|{{unique link|BFG 10K}}
|20
|1
|{{unique link|Butcher's Cleaver}}
|1
|2
|{{unique link|Charch's Null Pointer}}
|15
|1
|{{unique link|Cybernetic Armor}}
|10
|2
|{{unique link|Dragonslayer}}
|16
|1
|{{unique link|Enviroboots}}
|10
|2
|{{unique link|Frag Shotgun}}
|15
|1
|{{unique link|Grammaton Cleric Beretta}}
|6
|3
|{{unique link|Hell Staff}}
|15
|4
|{{unique link|Hellwave Pack}}
|10
|4
|{{unique link|Jackhammer}}
|12
|2
|{{unique link|Lava Armor}}
|12
|2
|{{unique link|Malek's Armor}}
|15
|3
|{{unique link|Medical Powerarmor}}
|10
|2
|{{unique link|Mega Buster}}
|15
|1
|{{unique link|Mjollnir}}
|15
|1
|{{unique link|Necroarmor}}
|10
|3
|{{unique link|Nyarlaptotep's Boots}}
|15
|3
|{{unique link|Railgun}}
|15
|2
|{{unique link|Revenant's Launcher}}
|12
|2
|{{unique link|Shielded Armor}}
|10
|2
|{{unique link|Subtle Knife}}
|15
|1
|{{unique link|Trigun}}
|8
|2
}}
|}
|}

Ignoring minimum dlevel, the total weight for exotic items is 180. Unique items have a total weight (again ignoring minimum dlevel) of 53. Any particular unique item will never drop more than once in each game. Minimum dlevels for items are NOT modified by difficulty level.

For convenience, here are the total weights for each dlevel. These allow easier calculation of the probabilities.
{|
|-
|'''dlevel'''
|'''Total Weight'''
|-
|1
|3672
|-
|2
|4531
|-
|3
|4591
|-
|4
|5387
|-
|5
|7540
|-
|6
|8322
|-
|7
|9140
|-
|8
|9358
|-
|9
|9516
|-
|10
|9646
|-
|11
|9726
|-
|12-13
|9821
|-
|14
|9824
|-
|15
|9851
|-
|16-19
|9912
|-
|20-21
|9915
|-
|22+
|9917
|}

The number of items that appear on a level is usually ceil(21 - max(25-dlevel,0)/3). The items are chosen at random using the weights as relative probabilities. At most 1 unique item can drop per level.

Lava element

2013-07-01T16:48:20Z

Rabinowitz: 0997

{{infostrat switch}}
{{Item|
item_name=Lava element|
item_looks=+|
item_get=[[The Lava Pits]]|
item_effect=Gives 9 turns of [[Effects#Invulnerable|invulnerable]].|
item_description=''A strange ball of shimmering light.''|
item_other=The lava element cannot be destroyed.}}

Lava element

2013-07-01T16:42:08Z

Rabinowitz: color

{{infostrat switch}}
{{Item|
item_name=Lava element|
item_looks=+|
item_get=[[The Lava Pits]]|
item_effect=Gives 9 turns of [[Effects#Invulnerable|invulnerable]].|
item_description=''A strange ball of shimmering light.''|
item_other=The lava element cannot be destroyed.}}

Item Generation

2013-07-01T16:23:12Z

Rabinowitz: cross-links

{{Technical}}

Note that this section only describes items that are dropped explicitly; in addition many monsters also carry items (usually guns and ammo). Also, some special level features (e.g. [[Room Generation#Vaults|vaults]]) can cause additional items to drop beyond what is described here.

Item placement is similar to monster placement. Every item has a minimum dlevel and a weight. Here are the levels and weights for all the items:
{|
|style="vertical-align: text-top;"|
{|class="wikitable" style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
! colspan="3" style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Common Items'''
|-
|style="text-align: left; padding-right: 1ex;"|'''Item'''
|style="text-align: left;"|'''Level'''
|style="text-align: left; padding-left: 1ex;"|'''Weight'''
{{Table3Col
|os=background: #333; padding:0px 2px;
|c1=text-align:left; vertical-align:top; padding:0px 2px;
|c2=text-align:right; vertical-align:top; padding:0px 2px; padding-left: 1ex;
|c3=text-align:right; vertical-align:top; padding:0px 2px; padding-left: 1ex;
|[[combat knife]]
|1
|640
|[[pistol]]
|1
|70
|[[shotgun]]
|2
|150
|[[combat shotgun]]
|6
|200
|[[double shotgun]]
|4
|100
|[[chaingun]]
|5
|200
|[[rocket launcher]]
|7
|200
|[[plasma rifle]]
|12
|70
|[[10mm ammo]]
|1
|500
|[[shotgun shell]]
|2
|700
|[[rocket]]
|5
|400
|[[power cell]]
|8
|200
|[[10mm ammo chain]]
|3
|60
|[[shell box]]
|4
|60
|[[rocket box]]
|7
|36
|[[power battery]]
|10
|18
|[[green armor]]
|1
|400
|[[blue armor]]
|4
|240
|[[red armor]]
|9
|150
|[[steel boots]]
|4
|240
|[[protective boots]]
|7
|150
|[[plasteel boots]]
|11
|80
|[[small med-pack]]
|1
|600
|[[large med-pack]]
|5
|400
|[[phase device]]
|5
|200
|[[homing phase device]]
|7
|100
|[[envirosuit pack]]
|5
|100
|[[thermonuclear bomb]]
|10
|40
|[[power mod pack]]
|7
|120
|[[agility mod pack]]
|6
|120
|[[bulk mod pack]]
|6
|120
|[[technical mod pack]]
|5
|120
|[[Small Health Globe]]
|1
|900
|[[Large Health Globe]]
|6
|330
|[[Supercharge Globe]]
|4
|150
|[[armor shard]]
|5
|700
|[[Megasphere]]
|16
|60
|[[Berserk Pack]]
|1
|200
|[[Invulnerability Globe]]
|7
|200
|[[Computer Map]]
|1
|200
|[[Light-Amp Goggles]]
|1
|80
|[[Tracking Map]]
|1
|80
}}
|}
|style="vertical-align: text-top;"|
{|class="wikitable" style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
! colspan="3" style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Exotic Items'''
|-
|style="text-align: left; padding-right: 1ex;"|'''Item'''
|style="text-align: left;"|'''Level'''
|style="text-align: left; padding-left: 1ex;"|'''Weight'''
{{Table3Col
|os=background: #333; padding:0px 2px;
|c1=text-align:left; vertical-align:top; padding:0px 2px;
|c2=text-align:right; vertical-align:top; padding:0px 2px; padding-left: 1ex;
|c3=text-align:right; vertical-align:top; padding:0px 2px; padding-left: 1ex;
|{{exotic link|acid-proof boots}}
|8
|5
|{{exotic link|assault shotgun}}
|6
|6
|{{exotic link|BFG 9000}}
|20
|2
|{{exotic link|blaster}}
|8
|2
|{{exotic link|blood skull}}
|5
|8
|{{exotic link|ballistic shield}}
|6
|3
|{{exotic link|ballistic vest}}
|2
|5
|{{exotic link|bullet-proof vest}}
|2
|4
|{{exotic link|chainsaw}}
|12
|3
|{{exotic link|combat pistol}}
|4
|6
|{{exotic link|combat translocator}}
|14
|3
|{{exotic link|duelist armor}}
|5
|6
|{{exotic link|energy shield}}
|8
|3
|{{exotic link|energy-shielded vest}}
|5
|3
|{{exotic link|fire skull}}
|7
|8
|{{exotic link|firestorm weapon pack}}
|10
|4
|{{exotic link|gothic armor}}
|15
|6
|{{exotic link|gothic boots}}
|10
|6
|{{exotic link|hatred skull}}
|9
|8
|{{exotic link|laser rifle}}
|12
|5
|{{exotic link|medical armor}}
|5
|6
|{{exotic link|minigun}}
|10
|6
|{{exotic link|missile launcher}}
|10
|6
|{{exotic link|Nano Pack}}
|10
|4
|{{exotic link|nuclear BFG 9000}}
|22
|2
|{{exotic link|nuclear plasma rifle}}
|15
|4
|{{exotic link|napalm launcher}}
|10
|6
|{{exotic link|onyx armor}}
|7
|4
|{{exotic link|Onyx Armor Pack}}
|10
|4
|{{exotic link|phaseshift armor}}
|10
|6
|{{exotic link|phaseshift boots}}
|8
|6
|{{exotic link|plasma shield}}
|10
|3
|{{exotic link|plasma shotgun}}
|12
|4
|{{exotic link|sniper weapon pack}}
|10
|4
|{{exotic link|super shotgun}}
|10
|5
|{{exotic link|shockwave pack}}
|5
|10
|{{exotic link|tristar blaster}}
|12
|4
}}
|}
|style="vertical-align: text-top;"|
{|class="wikitable" style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
! colspan="3" style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Unique Items'''
|-
|style="text-align: left; padding-right: 1ex;"|'''Item'''
|style="text-align: left;"|'''Level'''
|style="text-align: left; padding-left: 1ex;"|'''Weight'''
{{Table3Col
|os=background: #333; padding:0px 2px;
|c1=text-align:left; vertical-align:top; padding:0px 2px;
|c2=text-align:right; vertical-align:top; padding:0px 2px; padding-left: 1ex;
|c3=text-align:right; vertical-align:top; padding:0px 2px; padding-left: 1ex;
|{{unique link|Acid Spitter}}
|12
|3
|{{unique link|Anti-Freak Jackal}}
|10
|2
|{{unique link|Berserker Armor}}
|10
|1
|{{unique link|BFG 10K}}
|20
|1
|{{unique link|Butcher's Cleaver}}
|1
|2
|{{unique link|Charch's Null Pointer}}
|15
|1
|{{unique link|Cybernetic Armor}}
|10
|2
|{{unique link|Dragonslayer}}
|16
|1
|{{unique link|Enviroboots}}
|10
|2
|{{unique link|Frag Shotgun}}
|15
|1
|{{unique link|Grammaton Cleric Beretta}}
|6
|3
|{{unique link|Hell Staff}}
|15
|4
|{{unique link|Hellwave Pack}}
|10
|4
|{{unique link|Jackhammer}}
|12
|2
|{{unique link|Lava Armor}}
|12
|2
|{{unique link|Malek's Armor}}
|15
|3
|{{unique link|Medical Powerarmor}}
|10
|2
|{{unique link|Mega Buster}}
|15
|1
|{{unique link|Mjollnir}}
|15
|1
|{{unique link|Necroarmor}}
|10
|3
|{{unique link|Nyarlaptotep's Boots}}
|15
|3
|{{unique link|Railgun}}
|15
|2
|{{unique link|Revenant's Launcher}}
|12
|2
|{{unique link|Shielded Armor}}
|10
|2
|{{unique link|Subtle Knife}}
|15
|1
|{{unique link|Trigun}}
|8
|2
}}
|}
|}

Ignoring minimum dlevel, the total weight for exotic items is 174. Unique items have a total weight (again ignoring minimum dlevel) of 45. Any particular unique item will never drop more than once in each game. Minimum dlevels for items are NOT modified by difficulty level.

For convenience, here are the total weights for each dlevel. These allow easier calculation of the probabilities.
{|
|-
|'''dlevel'''
|'''Total Weight'''
|-
|1
|3592
|-
|2
|4641
|-
|3
|4701
|-
|4
|5493
|-
|5
|7646
|-
|6
|8228
|-
|7
|9196
|-
|8
|9412
|-
|9
|9420
|-
|10
|9550
|-
|11
|9632
|-
|12-13
|9725
|-
|14
|9728
|-
|15
|9747
|-
|16-19
|9808
|-
|20-21
|9811
|-
|22+
|9813
|}

The number of items that appear on a level is usually ceil(21 - max(25-dlevel,0)/3). The items are chosen at random using the weights as relative probabilities. At most 1 unique item can drop per level.

Monster Generation

2013-07-01T15:49:18Z

Rabinowitz: cross-links

{{Technical}}

Each monster has a minimum dlevel, a maximum dlevel, a weight, and a danger rating. Minimum level and maximum level determine whether the monster can appear on a floor at all. Weight indicates relative likelihood of appearing. Danger indicates (inversely) how many can be generated.

For the more all enemies that can normally spawn, here are the values.
{| style="rules: cols; border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em; text-align: right"
|colspan=5 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Monster Generation Parameters'''
|-
|style="text-align: left"|'''Monster'''
|style="text-align: left; padding-left: 1ex"|'''Minimum'''
|style="text-align: left; padding-left: 1ex"|'''Maximum'''
|style="text-align: left; padding-left: 1ex"|'''Weight'''
|style="text-align: left; padding-left: 1ex"|'''Danger'''
|- style="background: #333;"
|style="text-align: left"|[[Former human|Former Human]]
|0
|12
|10
|1
|-
|style="text-align: left"|[[Former sergeant|Former Sergeant]]
|2
|15
|10
|2
|- style="background: #333;"
|style="text-align: left"|[[Former captain|Former Captain]]
|5
|15
|10
|3
|-
|style="text-align: left"|[[Imp]]
|0
|17
|8
|2
|- style="background: #333;"
|style="text-align: left"|[[Demon]]
|4
|20
|6
|4
|-
|style="text-align: left"|[[Lost soul|Lost Soul]]
|6
|16
|10
|3
|- style="background: #333;"
|style="text-align: left"|[[Hell knight|Hell Knight]]
|9
|15
|6
|6
|-
|style="text-align: left"|[[Cacodemon]]
|10
|50
|6
|6
|- style="background: #333;"
|style="text-align: left"|[[Former commando|Former Commando]]
|12
|17
|6
|7
|-
|style="text-align: left"|[[Pain elemental|Pain Elemental]]
|10
|20
|4
|6
|- style="background: #333;"
|style="text-align: left"|[[Baron of hell|Baron of Hell]]
|12
|N/A
|6
|10
|-
|style="text-align: left"|[[Arachnotron]]
|13
|50
|4
|9
|- style="background: #333;"
|style="text-align: left"|[[Revenant]]
|13
|N/A
|5
|12
|-
|style="text-align: left"|[[Mancubus]]
|15
|N/A
|7
|12
|- style="background: #333;"
|style="text-align: left"|[[Arch-vile]]
|16
|N/A
|4
|14
|-
|style="text-align: left"|[[Nightmare imp|Nightmare Imp]]
|30
|60
|8
|6
|- style="background: #333;"
|style="text-align: left"|[[Nightmare demon|Nightmare Demon]]
|40
|N/A
|6
|7
|-
|style="text-align: left"|[[Nightmare cacodemon|Nightmare Cacodemon]]
|51
|N/A
|6
|10
|- style="background: #333;"
|style="text-align: left"|[[Nightmare arachnotron|Nightmare Arachnotron]]
|50
|N/A
|4
|12
|-
|style="text-align: left"|[[Nightmare arch-vile|Nightmare Arch-vile]]
|90
|N/A
|3
|20
|- style="background: #333;"
|style="text-align: left"|[[Elite former human|Elite Former Human]]
|40
|80
|1
|7
|-
|style="text-align: left"|[[Elite former sergeant|Elite Former Sergeant]]
|60
|90
|1
|10
|- style="background: #333;"
|style="text-align: left"|[[Elite former captain|Elite Former Captain]]
|70
|N/A
|1
|12
|-
|style="text-align: left"|[[Elite former commando|Elite Former Commando]]
|80
|N/A
|1
|14
|- style="background: #333;"
|style="text-align: left"|[[Bruiser brother|Bruiser Brother]]
|50
|N/A
|6
|14
|-
|style="text-align: left"|[[Lava elemental|Lava Elemental]]
|70
|N/A
|1
|16
|- style="background: #333;"
|style="text-align: left"|[[Shambler]]
|80
|N/A
|3
|14
|-
|style="text-align: left"|[[Agony elemental|Agony Elemental]]
|80
|N/A
|1
|20
|- style="background: #333;"
|style="text-align: left"|[[Cyberdemon]]
|80
|N/A
|1
|30
|}

Additionally, the are monster groups. Monsters groups have their own minimum and maximum levels and weights that are used instead of the values for the the individual monsters. The effective danger of a group is the sum of the dangers of its monsters.

{|style="rules: cols; border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em; text-align: right"
|colspan=4 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Monster Groups'''
|-
|style="text-align: left"|'''Monsters'''
|style="text-align: left; padding-left: 1ex"|'''Minimum'''
|style="text-align: left; padding-left: 1ex"|'''Maximum'''
|style="text-align: left; padding-left: 1ex"|'''Weight'''
|- style="background: #333;"
|style="text-align: left"|1 × former sergeant, 2-6 × former human
|7
|16
|10
|-
|style="text-align: left"|5-8 × imp
|5
|8
|10
|- style="background: #333;"
|style="text-align: left"|1 × hell knight, 2-6 × imp
|9
|12
|10
|-
|style="text-align: left"|1 × baron of hell, 4-9 × imp
|13
|21
|10
|- style="background: #333;"
|style="text-align: left"|1 × former commando, 2-6 × former sergeant
|15
|21
|10
|-
|style="text-align: left"|1 × pain elemental, 3-8 × lost soul
|13
|21
|8
|- style="background: #333;"
|style="text-align: left"|4-9 × demon
|10
|22
|4
|-
|style="text-align: left"|1 × baron of hell, 2-4 × hell knight
|20
|N/A
|4
|- style="background: #333;"
|style="text-align: left"|3-6 × arachnotron
|20
|N/A
|3
|-
|style="text-align: left"|2 × arch-vile, 4 × former captain, 4 × former sergeant, 3-6 × former human
|20
|N/A
|2
|- style="background: #333;"
|style="text-align: left"|2 × baron of hell, 2-3 × former captain, 2-3 × former sergeant
|20
|N/A
|5
|-
|style="text-align: left"|2 × arch-vile, 2-5 × mancubus
|20
|N/A
|4
|- style="background: #333;"
|style="text-align: left"|2 × arch-vile, 2-5 × revenant
|20
|N/A
|4
|-
|style="text-align: left"|2 × arch-vile, 3-9 × baron of hell
|25
|N/A
|4
|- style="background: #333;"
|style="text-align: left"|2 × arch-vile, 2-8 × former captain, 2-3 × mancubus
|25
|N/A
|2
|}

Notice that monster groups are the only way for some enemies to appear on very deep levels.

The minimum level of monsters and monster groups is modified according to difficulty level. (Other numbers are not changed.)
{|
|'''Difficulty'''
|'''Modifier'''
|-
|I'm Too Young to Die
|style="text-align: right"| -0
|-
|Hey, Not Too Rough
|style="text-align: right"| -0
|-
|Hurt Me Plenty
|style="text-align: right"| -3
|-
|Ultra-Violence
|style="text-align: right"| -6
|-
|Nightmare!
|style="text-align: right"| -6
|}

Each level is given a total danger rating depending on depth and difficulty level. Monster placement usually proceeds as follows: while the total danger of enemies placed so far is less than the danger rating of the level, pick a new monster or monster group and add it (entirely) to the level. Picking a monster or group is done using the weights as relative probabilities for all the monsters and groups with a valid dlevel range. When a monster group is picked, all its ranges are resolved uniformly and independently. Each monster is added to a random empty tile; for monster groups, each monster is added separately.

The total danger level is calculated from dlevel as follows:
{|
|'''Difficulty'''
|'''Danger'''
|-
|I'm Too Young to Die
|6 + 2.2 × dlevel
|-
|Hey, Not Too Rough
|0.6 × sqrt(500 × dlevel) = 13.4 × sqrt(dlevel)
|-
|Hurt Me Plenty
|20 × sqrt(dlevel)
|-
|Ultra-Violence
|32 × sqrt(dlevel)
|-
|Nightmare!
|40 × sqrt(devel)
|}

In addition to these monsters, certain level features (e.g. [[Generated Rooms#Vaults|vaults]]) may cause additional monsters to spawn on the level without counting against this limit.

Monster Generation

2013-07-01T15:38:15Z

Rabinowitz: update monster table to 0997

{{Technical}}

Each monster has a minimum dlevel, a maximum dlevel, a weight, and a danger rating. Minimum level and maximum level determine whether the monster can appear on a floor at all. Weight indicates relative likelihood of appearing. Danger indicates (inversely) how many can be generated.

For the more all enemies that can normally spawn, here are the values.
{| style="rules: cols; border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em; text-align: right"
|colspan=5 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Monster Generation Parameters'''
|-
|style="text-align: left"|'''Monster'''
|style="text-align: left; padding-left: 1ex"|'''Minimum'''
|style="text-align: left; padding-left: 1ex"|'''Maximum'''
|style="text-align: left; padding-left: 1ex"|'''Weight'''
|style="text-align: left; padding-left: 1ex"|'''Danger'''
|- style="background: #333;"
|style="text-align: left"|Former Human
|0
|12
|10
|1
|-
|style="text-align: left"|Former Sergeant
|2
|15
|10
|2
|- style="background: #333;"
|style="text-align: left"|Former Captain
|5
|15
|10
|3
|-
|style="text-align: left"|Imp
|0
|17
|8
|2
|- style="background: #333;"
|style="text-align: left"|Demon
|4
|20
|6
|4
|-
|style="text-align: left"|Lost Soul
|6
|16
|10
|3
|- style="background: #333;"
|style="text-align: left"|Hell Knight
|9
|15
|6
|6
|-
|style="text-align: left"|Cacodemon
|10
|50
|6
|6
|- style="background: #333;"
|style="text-align: left"|Former Commando
|12
|17
|6
|7
|-
|style="text-align: left"|Pain Elemental
|10
|20
|4
|6
|- style="background: #333;"
|style="text-align: left"|Baron of Hell
|12
|N/A
|6
|10
|-
|style="text-align: left"|Arachnotron
|13
|50
|4
|9
|- style="background: #333;"
|style="text-align: left"|Revenant
|13
|N/A
|5
|12
|-
|style="text-align: left"|Mancubus
|15
|N/A
|7
|12
|- style="background: #333;"
|style="text-align: left"|Arch-vile
|16
|N/A
|4
|14
|-
|style="text-align: left"|Nightmare Imp
|30
|60
|8
|6
|- style="background: #333;"
|style="text-align: left"|Nightmare Demon
|40
|N/A
|6
|7
|-
|style="text-align: left"|Nightmare Cacodemon
|51
|N/A
|6
|10
|- style="background: #333;"
|style="text-align: left"|Nightmare Arachnotron
|50
|N/A
|4
|12
|-
|style="text-align: left"|Nightmare Arch-vile
|90
|N/A
|3
|20
|- style="background: #333;"
|style="text-align: left"|Elite Former Human
|40
|80
|1
|7
|-
|style="text-align: left"|Elite Former Sergeant
|60
|90
|1
|10
|- style="background: #333;"
|style="text-align: left"|Elite Former Captain
|70
|N/A
|1
|12
|-
|style="text-align: left"|Elite Former Commando
|80
|N/A
|1
|14
|- style="background: #333;"
|style="text-align: left"|Bruiser Brother
|50
|N/A
|6
|14
|-
|style="text-align: left"|Lava Elemental
|70
|N/A
|1
|16
|- style="background: #333;"
|style="text-align: left"|Shambler
|80
|N/A
|3
|14
|-
|style="text-align: left"|Agony Elemental
|80
|N/A
|1
|20
|- style="background: #333;"
|style="text-align: left"|Cyberdemon
|80
|N/A
|1
|30
|}

Additionally, the are monster groups. Monsters groups have their own minimum and maximum levels and weights that are used instead of the values for the the individual monsters. The effective danger of a group is the sum of the dangers of its monsters.

{|style="rules: cols; border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em; text-align: right"
|colspan=4 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Monster Groups'''
|-
|style="text-align: left"|'''Monsters'''
|style="text-align: left; padding-left: 1ex"|'''Minimum'''
|style="text-align: left; padding-left: 1ex"|'''Maximum'''
|style="text-align: left; padding-left: 1ex"|'''Weight'''
|- style="background: #333;"
|style="text-align: left"|1 × former sergeant, 2-6 × former human
|7
|16
|10
|-
|style="text-align: left"|5-8 × imp
|5
|8
|10
|- style="background: #333;"
|style="text-align: left"|1 × hell knight, 2-6 × imp
|9
|12
|10
|-
|style="text-align: left"|1 × baron of hell, 4-9 × imp
|13
|21
|10
|- style="background: #333;"
|style="text-align: left"|1 × former commando, 2-6 × former sergeant
|15
|21
|10
|-
|style="text-align: left"|1 × pain elemental, 3-8 × lost soul
|13
|21
|8
|- style="background: #333;"
|style="text-align: left"|4-9 × demon
|10
|22
|4
|-
|style="text-align: left"|1 × baron of hell, 2-4 × hell knight
|20
|N/A
|4
|- style="background: #333;"
|style="text-align: left"|3-6 × arachnotron
|20
|N/A
|3
|-
|style="text-align: left"|2 × arch-vile, 4 × former captain, 4 × former sergeant, 3-6 × former human
|20
|N/A
|2
|- style="background: #333;"
|style="text-align: left"|2 × baron of hell, 2-3 × former captain, 2-3 × former sergeant
|20
|N/A
|5
|-
|style="text-align: left"|2 × arch-vile, 2-5 × mancubus
|20
|N/A
|4
|- style="background: #333;"
|style="text-align: left"|2 × arch-vile, 2-5 × revenant
|20
|N/A
|4
|-
|style="text-align: left"|2 × arch-vile, 3-9 × baron of hell
|25
|N/A
|4
|- style="background: #333;"
|style="text-align: left"|2 × arch-vile, 2-8 × former captain, 2-3 × mancubus
|25
|N/A
|2
|}

Notice that monster groups are the only way for some enemies to appear on very deep levels.

The minimum level of monsters and monster groups is modified according to difficulty level. (Other numbers are not changed.)
{|
|'''Difficulty'''
|'''Modifier'''
|-
|I'm Too Young to Die
|style="text-align: right"| -0
|-
|Hey, Not Too Rough
|style="text-align: right"| -0
|-
|Hurt Me Plenty
|style="text-align: right"| -3
|-
|Ultra-Violence
|style="text-align: right"| -6
|-
|Nightmare!
|style="text-align: right"| -6
|}

Each level is given a total danger rating depending on depth and difficulty level. Monster placement usually proceeds as follows: while the total danger of enemies placed so far is less than the danger rating of the level, pick a new monster or monster group and add it (entirely) to the level. Picking a monster or group is done using the weights as relative probabilities for all the monsters and groups with a valid dlevel range. When a monster group is picked, all its ranges are resolved uniformly and independently. Each monster is added to a random empty tile; for monster groups, each monster is added separately.

The total danger level is calculated from dlevel as follows:
{|
|'''Difficulty'''
|'''Danger'''
|-
|I'm Too Young to Die
|6 + 2.2 × dlevel
|-
|Hey, Not Too Rough
|0.6 × sqrt(500 × dlevel) = 13.4 × sqrt(dlevel)
|-
|Hurt Me Plenty
|20 × sqrt(dlevel)
|-
|Ultra-Violence
|32 × sqrt(dlevel)
|-
|Nightmare!
|40 × sqrt(devel)
|}

In addition to these monsters, certain level features (e.g. [[Generated Rooms#Vaults|vaults]]) may cause additional monsters to spawn on the level without counting against this limit.

Item Generation

2013-07-01T15:06:48Z

Rabinowitz: update items table to 0997

{{Technical}}

Note that this section only describes items that are dropped explicitly; in addition many monsters also carry items (usually guns and ammo). Also, some special level features (e.g. [[Room Generation#Vaults|vaults]]) can cause additional items to drop beyond what is described here.

Item placement is similar to monster placement. Every item has a minimum dlevel and a weight. Here are the levels and weights for all the items:
{|
|style="vertical-align: text-top;"|
{|class="wikitable" style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
! colspan="3" style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Common Items'''
|-
|style="text-align: left; padding-right: 1ex;"|'''Item'''
|style="text-align: left;"|'''Level'''
|style="text-align: left; padding-left: 1ex;"|'''Weight'''
{{Table3Col
|os=background: #333; padding:0px 2px;
|c1=text-align:left; vertical-align:top; padding:0px 2px;
|c2=text-align:right; vertical-align:top; padding:0px 2px; padding-left: 1ex;
|c3=text-align:right; vertical-align:top; padding:0px 2px; padding-left: 1ex;
|combat knife
|1
|640
|pistol
|1
|70
|shotgun
|2
|150
|combat shotgun
|6
|200
|double shotgun
|4
|100
|chaingun
|5
|200
|rocket launcher
|7
|200
|plasma rifle
|12
|70
|10mm ammo
|1
|500
|shotgun shell
|2
|700
|rocket
|5
|400
|power cell
|8
|200
|10mm ammo chain
|3
|60
|shell box
|4
|60
|rocket box
|7
|36
|power battery
|10
|18
|green armor
|1
|400
|blue armor
|4
|240
|red armor
|9
|150
|steel boots
|4
|240
|protective boots
|7
|150
|plasteel boots
|11
|80
|small med-pack
|1
|600
|large med-pack
|5
|400
|phase device
|5
|200
|homing phase device
|7
|100
|envirosuit pack
|5
|100
|thermonuclear bomb
|10
|40
|power mod pack
|7
|120
|agility mod pack
|6
|120
|bulk mod pack
|6
|120
|technical mod pack
|5
|120
|Small Health Globe
|1
|900
|Large Health Globe
|6
|330
|Supercharge Globe
|4
|150
|armor shard
|5
|700
|Megasphere
|16
|60
|Berserk Pack
|1
|200
|Invulnerability Globe
|7
|200
|Computer Map
|1
|200
|Light-Amp Googles
|1
|80
|Tracking Map
|1
|80
}}
|}
|style="vertical-align: text-top;"|
{|class="wikitable" style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
! colspan="3" style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Exotic Items'''
|-
|style="text-align: left; padding-right: 1ex;"|'''Item'''
|style="text-align: left;"|'''Level'''
|style="text-align: left; padding-left: 1ex;"|'''Weight'''
{{Table3Col
|os=background: #333; padding:0px 2px;
|c1=text-align:left; vertical-align:top; padding:0px 2px;
|c2=text-align:right; vertical-align:top; padding:0px 2px; padding-left: 1ex;
|c3=text-align:right; vertical-align:top; padding:0px 2px; padding-left: 1ex;
|acid-proof boots
|8
|5
|assault shotgun
|6
|6
|bfg 9000
|20
|2
|blaster
|8
|2
|blood skull
|5
|8
|ballistic shield
|6
|3
|ballistic vest
|2
|5
|bullet-proof vest
|2
|4
|chainsaw
|12
|3
|combat pistol
|4
|6
|combat translocator
|14
|3
|duelist armor
|5
|6
|energy shield
|8
|3
|energy-shielded vest
|5
|3
|fire skull
|7
|8
|firestorm weapon pack
|10
|4
|gothic armor
|15
|6
|gothic boots
|10
|6
|hatred skull
|9
|8
|laser rifle
|12
|5
|medical armor
|5
|6
|minigun
|10
|6
|missile launcher
|10
|6
|nano pack
|10
|4
|nuclear bfg 9000
|22
|2
|nuclear plasma rifle
|15
|4
|napalm launcher
|10
|6
|onyx armor
|7
|4
|onyx armor pack
|10
|4
|phaseshift armor
|10
|6
|phaseshift boots
|8
|6
|plasma shield
|10
|3
|plasma shotgun
|12
|4
|sniper weapon pack
|10
|4
|super shotgun
|10
|5
|shockwave pack
|5
|10
|tristar blaster
|12
|4
}}
|}
|style="vertical-align: text-top;"|
{|class="wikitable" style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
! colspan="3" style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Unique Items'''
|-
|style="text-align: left; padding-right: 1ex;"|'''Item'''
|style="text-align: left;"|'''Level'''
|style="text-align: left; padding-left: 1ex;"|'''Weight'''
{{Table3Col
|os=background: #333; padding:0px 2px;
|c1=text-align:left; vertical-align:top; padding:0px 2px;
|c2=text-align:right; vertical-align:top; padding:0px 2px; padding-left: 1ex;
|c3=text-align:right; vertical-align:top; padding:0px 2px; padding-left: 1ex;
|Acid Spitter
|12
|3
|Anti-Freak Jackal
|10
|2
|Berserker Armor
|10
|1
|BFG 10K
|20
|1
|Butcher's Cleaver
|1
|2
|Charch's Null Pointer
|15
|1
|Cybernetic Armor
|10
|2
|Dragonslayer
|16
|1
|Enviroboots
|10
|2
|Frag Shotgun
|15
|1
|Grammaton Cleric Beretta
|6
|3
|Hell Staff
|15
|4
|Hellwave Pack
|10
|4
|Lava Armor
|12
|2
|Megabuster
|15
|1
|Trigun
|8
|2
|Jackhammer
|12
|2
|Revenant's Launcher
|12
|2
|Railgun
|15
|2
|Malek's Armor
|15
|3
|Medical Powerarmor
|10
|2
|Mjollnir
|15
|1
|Necroarmor
|10
|3
|Nyarlaptotep's Boots
|15
|3
|Shielded Armor
|10
|2
|Subtle Knife
|15
|1
}}
|}
|}

Ignoring minimum dlevel, the total weight for exotic items is 174. Unique items have a total weight (again ignoring minimum dlevel) of 45. Any particular unique item will never drop more than once in each game. Minimum dlevels for items are NOT modified by difficulty level.

For convenience, here are the total weights for each dlevel. These allow easier calculation of the probabilities.
{|
|-
|'''dlevel'''
|'''Total Weight'''
|-
|1
|3592
|-
|2
|4641
|-
|3
|4701
|-
|4
|5493
|-
|5
|7646
|-
|6
|8228
|-
|7
|9196
|-
|8
|9412
|-
|9
|9420
|-
|10
|9550
|-
|11
|9632
|-
|12-13
|9725
|-
|14
|9728
|-
|15
|9747
|-
|16-19
|9808
|-
|20-21
|9811
|-
|22+
|9813
|}

The number of items that appear on a level is usually ceil(21 - max(25-dlevel,0)/3). The items are chosen at random using the weights as relative probabilities. At most 1 unique item can drop per level.

Modding:thing

2013-06-25T06:36:18Z

Rabinowitz: Redirected page to Modding:Thing

#REDIRECT [[Modding:Thing]]

Levels

2013-06-25T05:58:47Z

Rabinowitz:

__NOTOC__
Levels are the heart of DoomRL, and without them there would be no game. It is where the player explores, where enemies roam, where special items lie in wait. They are filled with either fortune or your own personal doom.

==Basic Objects==
All levels are made of basic objects like floors, walls, and doors.
*'''HP''': This is one of the parameters that governs how difficulty the object is to destroy. Whenever an object takes damage, it's HP is decreased. Once its HP falls to 0, it changes to a floor tile. Some objects cannot be destroyed; these are indicated as "none". Also, some objects have two versions: one that can be destroyed and one that can't.
*'''Armor''': This also makes objects harder to destroy. Whenever an object takes damage, the object's armor is subtracted from the damage before the damage is subtracted from HP. Unlike the armor of the player and his enemies, objects' armor may reduce damage to 0.
*'''Fragile''': Objects can usually only be damaged by [[Damage type#plasma|plasma]], [[Damage type#fire|fire]], or [[Damage type#acid|acid]] damage. Fragile objects can be damaged by any damage type.

{| style="rules: cols; border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=11 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Basic Objects'''
|-
|style="text-align: center; padding: 1ex; border: solid darkred; border-width: 0 1px 1px 0" width=100|'''Name'''
|style="text-align: center; padding: 1ex; border: solid darkred; border-width: 0 1px 1px 1px" width=50|'''Appearance'''
|style="text-align: center; padding: 1ex; border: solid darkred; border-width: 0 1px 1px 1px" width=50|'''HP'''
|style="text-align: center; padding: 1ex; border: solid darkred; border-width: 0 1px 1px 1px" width=50|'''Armor'''
|style="text-align: center; padding: 1ex; border: solid darkred; border-width: 0 1px 1px 1px" width=50|'''Fragile'''
|style="text-align: center; padding: 1ex; border: solid darkred; border-width: 0 0 1px 1px"|'''Special'''
|- style="background: #333;"
|style="text-align: left; padding-right: 1ex; border: solid darkred; border-width: 1px 1px 0 0"|floor
|style="text-align: center; border: solid darkred; border-width: 1px 1px 0 1px"|'''·'''
|style="text-align: center; border: solid darkred; border-width: 1px 1px 0 1px"|none
|style="text-align: center; border: solid darkred; border-width: 1px 1px 0 1px"|N/A
|style="text-align: center; border: solid darkred; border-width: 1px 1px 0 1px"|N/A
|style="text-align: center; border: solid darkred; border-width: 1px 0 0 1px"|N/A
|-
|style="text-align: left; padding-right: 1ex; border: solid darkred; border-width: 0 1px 0 0"|blood
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|'''·'''
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|none
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|N/A
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|N/A
|style="text-align: center; border: solid darkred; border-width: 0 0 0 1px"|N/A
|- style="background: #333;"
|style="text-align: left; padding-right: 1ex; border: solid darkred; border-width: 0 1px 0 0"|pool of blood
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|'''•'''
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|none
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|N/A
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|N/A
|style="text-align: center; border: solid darkred; border-width: 0 0 0 1px"|N/A
|-
|style="text-align: left; padding-right: 1ex; border: solid darkred; border-width: 0 1px 0 0"|Phobos rock
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|'''.'''
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|none
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|N/A
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|N/A
|style="text-align: center; border: solid darkred; border-width: 0 0 0 1px"|N/A
|- style="background: #333;"
|style="text-align: left; padding-right: 1ex; border: solid darkred; border-width: 0 1px 0 0"|wall, blooded wall
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|'''#''', '''#'''
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|10
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|10
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|no
|style="text-align: center; border: solid darkred; border-width: 0 0 0 1px"|N/A
|-
|style="text-align: left; padding-right: 1ex; border: solid darkred; border-width: 0 1px 0 0"|bloodstone, blooded wall
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|'''#''', '''#'''
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|15
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|10
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|no
|style="text-align: center; border: solid darkred; border-width: 0 0 0 1px"|N/A
|- style="background: #333;"
|style="text-align: left; padding-right: 1ex; border: solid darkred; border-width: 0 1px 0 0"|green wall
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|'''#'''
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|15
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|10
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|no
|style="text-align: center; border: solid darkred; border-width: 0 0 0 1px"|N/A
|-
|style="text-align: left; padding-right: 1ex; border: solid darkred; border-width: 0 1px 0 0"|crate, blooded crate
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|'''#''', '''#''', '''#'''
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|5
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|5
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|no
|style="text-align: center; border: solid darkred; border-width: 0 0 0 1px"|N/A
|- style="background: #333;"
|style="text-align: left; padding-right: 1ex; border: solid darkred; border-width: 0 1px 0 0"|ammo crate, armor crate, blooded crate
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|'''#''', '''#''', '''#'''
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|5
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|5
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|yes
|style="text-align: center; border: solid darkred; border-width: 0 0 0 1px"|When destroyed, sometimes leaves behind ammo, armor, or packs (?) depending on the crate type. Note that walls have HP, a wall's hp can be downgraded to 1HP and still be standing.
|-
|style="text-align: left; padding-right: 1ex; border: solid darkred; border-width: 0 1px 0 0"|closed door
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|'''+'''
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|6
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|4
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|yes
|style="text-align: center; border: solid darkred; border-width: 0 0 0 1px"|Can be opened.
|-style="background: #333;"
|style="text-align: left; padding-right: 1ex; border: solid darkred; border-width: 0 1px 0 0"|locked door
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|'''+'''
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|6
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|6
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|yes
|style="text-align: center; border: solid darkred; border-width: 0 0 0 1px"|N/A
|-
|style="text-align: left; padding-right: 1ex; border: solid darkred; border-width: 0 1px 0 0"|open door
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|'''/'''
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|none
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|N/A
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|N/A
|style="text-align: center; border: solid darkred; border-width: 0 0 0 1px"|Can be closed.
|- style="background: #333;"
|style="text-align: left; padding-right: 1ex; border: solid darkred; border-width: 0 1px 0 0"|[[lever]]
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|'''&'''
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|10
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|0
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|no
|style="text-align: center; border: solid darkred; border-width: 0 0 0 1px"|see link in name for details
|-
|style="text-align: left; padding-right: 1ex; border: solid darkred; border-width: 0 1px 0 0"|barrel of fuel
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|'''0'''
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|2
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|3
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|yes
|style="text-align: center; border: solid darkred; border-width: 0 0 0 1px"|Can be pushed. When destroyed, creates a radius 4 [[explosions|explosion]] dealing 5d5 [[Damage type#fire|fire damage]].
|- style="background: #333;"
|style="text-align: left; padding-right: 1ex; border: solid darkred; border-width: 0 1px 0 0"|barrel of acid
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|'''0'''
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|2
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|4
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|yes
|style="text-align: center; border: solid darkred; border-width: 0 0 0 1px"|Can be pushed. When destroyed, creates a radius 4 [[explosions|explosion]] dealing 6d6 [[Damage type#acid|acid damage]], sometimes leaving behind acid tiles.
|-
|style="text-align: left; padding-right: 1ex; border: solid darkred; border-width: 0 1px 0 0"|barrel of napalm
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|'''0'''
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|2
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|5
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|yes
|style="text-align: center; border: solid darkred; border-width: 0 0 0 1px"|Can be pushed. When destroyed, creates a radius 4 [[explosions|explosion]] dealing 7d7 [[Damage type#fire|fire damage]], sometimes (often) leaving behind lava tiles.
|}

==Random levels==
The archetypical level in DoomRL is a randomly-generated one. It is produced in such a way that no two games are particularly alike. There are many special considerations within the game engine, although many of these are technical and unimportant from a gameplay perspective.

* [[Level type]]
* [[Level feeling]]
* [[Level event]]
* [[Monster Generation]]
* [[Item Generation]]
* [[Room Generation]]
* [[Fluids]]

== Special levels ==
In stark contrast to random levels, special levels are constant and many of them appear every game. As you gain more experience playing DoomRL, these become stepping stones used as a grip against the turbulent flow of random levels.

For obvious reasons, all of these pages are considered spoilers if you wish to learn how to beat them yourself. Some are particularly spoiler-heavy, though, and are indicated as such here.

* [[Phobos Base Entry]]
* [[Hell's Arena]]
* [[The Chained Court]]
* [[Military Base]]
* [[Phobos Lab]]
* [[Phobos Anomaly]]
* [[Hell's Armory]]
* [[Deimos Lab]]
* [[The Wall]]
* [[Containment Area]]
* [[Abyssal Plains]]
* [[City of Skulls]]
* [[Halls of Carnage]]
* [[Spider's Lair]]
* [[Tower of Babel]]
* [[Unholy Cathedral]] (Spoilers!)
* [[The Vaults]]
* [[The Mortuary]] (Spoilers!)
* [[Limbo]] (Spoilers!)
* [[The Lava Pits]]
* [[Mt. Erebus]]
* [[Dis]] (Spoilers!)
* [[Hell Fortress]] (MAJOR SPOILERS!)

===Special level placement===
Some levels don't spawn on I'm Too Young To Die: Hell's Armory and Deimos Lab, Unholy Cathedral, The Vaults, The Mortuary and Limbo.

Special stairs are always placed on a random empty tile.

Special level pairs are chosen randomly - exactly one from each pair appears per game.

{|
|'''Level'''
|'''Depth'''
|-
|Hell's Arena
|2 (Phobos 2)
|-
|The Chained Court
|5 (Phobos 5)
|-
|Phobos Lab/Military Base
|7 (Phobos 7)
|-
|Hell's Armory/Deimos Lab
|9 (Deimos 1)
|-
|The Wall/Containment Area
|11 (Deimos 3)
|-
|City of Skulls/Abyssal Plains
|12 (Deimos 4)
|-
|Spider's Lair/Halls of Carnage
|14 (Deimos 6)
|-
|Unholy Cathedral
|17 (Hell 1)
|-
|The Vaults
|19 (Hell 3)
|-
|The Mortuary/Limbo
|20 (Hell 4)
|-
|The Lava Pits/Mt. Erebus
|22 (Hell 6)
|}

Cyberdemon

2013-06-22T01:07:52Z

Rabinowitz: it's called as olive; see User:Tehtmi/Map Colorizer

{{infostrat switch}}
{{Monsters|
monster_name=Cyberdemon|
monster_looks=C|
monster_hp=200+10×difficulty2 = 210, 240, 290, 360, 450|
monster_ac=4|
monster_acc=+8 melee, +12 ranged|
monster_melee=1d3+15 = 16-18 = 17 avg|
monster_projectile=Attacks with a [[rocket launcher]]: 6d6 = 6-36 = 21 avg|
monster_speed=110%|
monster_dlvl=[[Tower of Babel]], or 80 and lower on A100|
monster_xp=2720|
monster_inventory=Rocket launcher, [[rocket]] (x30)|
monster_pickup=Yes|
monster_doors=Yes|
monster_atkchance=75%|
monster_abilities=Takes no damage from [[fluids]] nor from its own attacks. Immune to [[knockback]] in the Tower of Babel.|
monster_description=''Monster and machine, combined. Equipped with a rocket launcher, this nightmare is the worst thing you can find in Hell. Or at least that is what you hope...''|
monster_other=Hunts player precisely.}}

User:Rabinowitz

2013-06-20T19:52:00Z

Rabinowitz:

User:Rabinowitz

2013-06-20T17:05:25Z

Rabinowitz: Created page with "We had two shell-box, seventy-five energy cells, high-powered railgun, an acid-spitter full of acid, and a whole galaxy of multicolored mod packs... and also green armor, blue a..."

We had two shell-box, seventy-five energy cells, high-powered railgun, an acid-spitter full of acid, and a whole galaxy of multicolored mod packs... and also green armor, blue armor, red armor, two of nuclear plasma rifle and dozen of large med-packs.

Not that we needed all that for the trip, but once you get locked into a serious stuff collection, the tendency is to push it as far as you can.

Strategy:BFG 9000

2013-06-18T20:33:49Z

Rabinowitz: fixed size clip

{{infostrat switch}}
__NOTOC__
== Main Guide (0.9.9.5) ==

=== Version Changes (0.9.9.6) ===
Nothing significant to the weapon itself.

=== General Tactics ===
Basic strategy written by [[ZicherCZ|ZicherCZ]] 16:55, February 03 2012 (GMT).

BFG9000, the ultimate in conventional DoomRL warfare, is highly efficient against practically any foe, but consumes ammunition like there's no tomorrow.

A few tips on efficient use:
* BFG is the best weapon to use against targets you want to take out really quickly. [[Arch-vile|Archviles]] (doubly so those in the Mortuary) or [[Mancubus|mancubi]] can serve as a prime example, although, more likely than not, these would require two shots to go down. If you don't mind a bit of an overkill, you can, with near-certainty, take out those nasty [[Former_commando|former commandos]] and [[Revenant|revenants]] in one shot as well. [[Cyberdemon|Cyberdemon]] will then die (on average) after 5, 6, 7, 9 and 11 shots (with growing difficulty level). For the [[Spider Mastermind|Mastermind]] and [[John_Carmack|JC]] add 1 to Cyberdemon's numbers.
* If at all possible, try to hit multiple foes at once. The explosion radius of 10 is a definite help to this.
* If you happen to find another BFG, take it to save space in your inventory.. Its clip can hold 100 plasma cells, while an inventory slot can hold only 50 (70 with [[Backpack|backpack]]).
* Bulk-modding the BFG once increases the number of shots without reloading from two to three, which can be a life-saver at times. Another bulk mod will then increase this number to four, another one to five (the exact clip sizes are 130, 169 and 220).

Experience

2013-06-18T10:24:43Z

Rabinowitz: since 0996

{{infostrat switch}}
The player earns experience whenever enemies are killed. Different enemies are worth different amounts of experience (as listed on [[Enemies|their individual pages]]). The amount of experience given by enemies is also modified depending on the [[Game Settings#Difficulty|difficulty level]].

Whenever the player's experience passes certain predetermined thresholds, he gains a level. Whenever the player gains a level, he gets to select a new [[Traits|trait]]. Once the player reaches level 25, he will no longer gain additional levels, although level 25 is nearly impossible to reach in most game modes.

{| style="rules: cols; border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em; text-align: right"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Experience Table'''
|-
|'''Level'''
|style="padding-left: 1ex"|'''Experience'''
|- style="background: #333;"
|1
|0
|-
|2
|500
|- style="background: #333;"
|3
|1500
|-
|4
|4000
|- style="background: #333;"
|5
|7000
|-
|6
|11000
|- style="background: #333;"
|7
|16000
|-
|8
|22000
|- style="background: #333;"
|9
|30000
|-
|10
|40000
|- style="background: #333;"
|11
|50000
|-
|12
|60000
|- style="background: #333;"
|13
|70000
|-
|14
|80000
|- style="background: #333;"
|15
|100000
|-
|16
|120000
|- style="background: #333;"
|17
|140000
|-
|18
|160000
|- style="background: #333;"
|19
|200000
|-
|20
|300000
|- style="background: #333;"
|21
|400000
|-
|22
|500000
|- style="background: #333;"
|23
|600000
|-
|24
|700000
|- style="background: #333;"
|25
|900000
|}

Jackhammer

2013-06-16T07:20:03Z

Rabinowitz:

{{infostrat switch}}
{{ranged weapon|
weapon_name=Jackhammer|
weapon_dmg=(8d3)x3/24-72, [[Shotguns|focused shotgun blast]]|
weapon_avgdmg=16 × 0.95 × 3 = 45.6|
weapon_accuracy=+0|
weapon_dmgtype=[[Damage type#Shrapnel|Shrapnel]]|
weapon_ftime=1.0 second|
weapon_rtime=2.5 seconds|
weapon_clip=9|
weapon_ammo=[[Shotgun shell]]|
weapon_areload=None|
weapon_afire=None|
weapon_get=Random (12+)|
weapon_quote=None|
weapon_looks=}|
weapon_description=''The Pancor Corporation Jackhammer is a 12 gauge, gas-operated automatic weapon.''|
weapon_other=works with [[Traits#Triggerhappy|Triggerhappy]]|
weapon_source={{wiki|Pancor_Jackhammer|Real Life}}}}

Modding:sID

2013-06-15T11:43:36Z

Rabinowitz: adding new monsters; nano and onyx to exotic

Objects in DoomRL have unique identifiers.

One is the ID, a number used by the engine to track the item. 
The other is the sID, a string which is used by the API to track the item, and what you define as id in most of the prototypes.

With the notable exception of defining a weapon's ammotype the sID is what the sandbox uses. You can use numerical IDs or constants that represent them; it's a legacy feature from the early sandbox days. But those aren't listed on this page, and string IDs are, so if you don't want to define your own building blocks, enjoy.

== [[Modding:Affects|Affects]] ==

{|class="wikitable" style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
! colspan="2" style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Affects'''
{{Table2Col
|es=background: #333;
|c1=text-align:right; vertical-align:top; padding:0px 2px;
|c2=vertical-align:top; padding:0px 2px;
|[[Effects#Berserk|berserk]]|berserk
|[[Effects#Invulnerable|invulnerable]]|inv
|[[Effects#Envirosuit|envirosuit]]|enviro
|[[Effects#Light-Amp|light-amp]]|light
}}
|}

== [[Modding:Being|Beings]] ==

{|class="wikitable" style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
! colspan="2" style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Beings'''
{{Table2Col
|es=background: #333;
|c1=text-align:right; vertical-align:top; padding:0px 2px;
|c2=vertical-align:top; padding:0px 2px;
|[[former human]]|former
|[[former sergeant]]|sergeant
|[[former captain]]|captain
|[[imp]]|imp
|[[demon]]|demon
|[[lost soul]]|lostsoul
|[[cacodemon]]|cacodemon
|[[hell knight]]|knight
|[[baron of hell]]|baron
|[[arachnotron]]|arachno
|[[former commando]]|commando
|[[pain elemental]]|pain
|[[revenant]]|revenant
|[[mancubus]]|mancubus
|[[arch-vile]]|arch
|[[nightmare imp]]|nimp
|[[nightmare cacodemon]]|ncacodemon
|[[nightmare demon]]|ndemon
|[[nightmare arachnotron]]|narachno
|[[nightmare arch-vile]]|narch
|[[elite former human]]|eformer
|[[elite former sergeant]]|esergeant
|[[elite former captain]]|ecaptain
|[[elite former commando]]|ecommando
}}
{{Table2Col
|es=background: #333;
|c1=text-align:right; vertical-align:top; padding:0px 2px;
|c2=vertical-align:top; padding:0px 2px;
|[[bruiser brother]]|bruiser
|[[shambler]]|shambler
|[[lava elemental]]|lava_elemental
|[[agony elemental]]|agony
|[[Angel of Death]]|angel
|[[Cyberdemon]]|cyberdemon
|[[Spider Mastermind]]|mastermind
|[[John Carmack]]|jc
|[[Arena Master]]|arenamaster
|[[Apostle]]|apostle
|[[player]]|soldier
}}
|}

== [[Modding:Cell|Cells]] ==

{|class="wikitable" style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
! colspan="2" style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Cells'''
{{Table2Col
|es=background: #333;
|c1=text-align:right; vertical-align:top; padding:0px 2px;
|c2=vertical-align:top; padding:0px 2px;
|[[Levels#Basic Objects|floor]]|floor
|[[Levels#Basic Objects|stone wall]]|wall
|[[Levels#Basic Objects|blooded wall]]|bwall
|[[Levels#Basic Objects|base wall]]|dwall
|[[Levels#Basic Objects|blooded base wall]]|bdwall
|[[Levels#Basic Objects|ice wall]]|iwall
|[[Levels#Basic Objects|blooded ice wall]]|biwall
|[[Levels#Basic Objects|green wall]]|gwall
|[[Levels#Basic Objects|blooded green wall]]|bgwall
|[[Levels#Basic Objects|bloodstone]]|rwall
|[[Levels#Basic Objects|blooded wall (bloodstone)]]|brwall
|[[Levels#Basic Objects|crate (blue)]]|crate
|[[Levels#Basic Objects|blooded crate (blue)]]|bcrate
|[[Levels#Basic Objects|crate (yellow)]]|ycrate
|[[Levels#Basic Objects|blooded crate (yellow)]]|bycrate
|[[Levels#Basic Objects|closed door]]|door
|[[Levels#Basic Objects|open door]]|odoor
|[[Levels#Basic Objects|locked door]]|ldoor
}}
{{Table2Col
|es=background: #333;
|c1=text-align:right; vertical-align:top; padding:0px 2px;
|c2=vertical-align:top; padding:0px 2px;
|[[Levels#Basic Objects|stairs]]|stairs
|[[Levels#Basic Objects|down stairs (yellow)]]|ystairs
|[[Levels#Basic Objects|down stairs (red)]]|rstairs
|[[Levels#Basic Objects|barrel of fuel]]|barrel
|[[Levels#Basic Objects|barrel of acid]]|barrela
|[[Levels#Basic Objects|barrel of napalm]]|barreln
|[[Levels#Basic Objects|water]]|water
|[[Levels#Basic Objects|acid]]|acid
|[[Levels#Basic Objects|lava]]|lava
|[[Levels#Basic Objects|water (indestructible)]]|pwater
|[[Levels#Basic Objects|acid (indestructible)]]|pacid
|[[Levels#Basic Objects|lava (indestructible)]]|plava
|[[Levels#Basic Objects|bridge]]|bridge
|[[Levels#Basic Objects|Phobos rock]]|rock
|[[thermonuclear bomb|a nuke!]]|nukecell
|[[Levels#Basic Objects]]|tree
|[[Levels#Basic Objects|bloody corpse]]|corpse
|[[Levels#Basic Objects|blood]]|blood
|[[Levels#Basic Objects|blood pool]]|bloodpool
}}
|}

Most beings have automatically generated corpse cells. These cells have sID <tt>being.id .. "corpse"</tt>.

== [[Modding:Item|Items]] ==

{|class="wikitable" style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
! colspan="2" style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Basic Items'''
{{Table2Col
|es=background: #333;
|c1=text-align:right; vertical-align:top; padding:0px 2px;
|c2=vertical-align:top; padding:0px 2px;
|[[combat knife]]|knife
|[[green armor]]|garmor
|[[blue armor]]|barmor
|[[red armor]]|rarmor
|[[steel boots]]|sboots
|[[protective boots]]|pboots
|[[plasteel boots]]|psboots
|[[Small Health Globe]]|shglobe
|[[Berserk Pack]]|bpack
|[[Invulnerability Globe]]|iglobe
|[[Supercharge Globe]]|scglobe
|[[Large Health Globe]]|lhglobe
|[[Megasphere]]|msglobe
|[[Computer Map]]|map
|[[Tracking Map]]|pmap
|[[Light-Amp Goggles]]|gpack
|[[armor shard]]|ashard
|[[10mm ammo]]|ammo
}}
{{Table2Col
|es=background: #333;
|c1=text-align:right; vertical-align:top; padding:0px 2px;
|c2=vertical-align:top; padding:0px 2px;
|[[shotgun shell]]|shell
|[[rocket]]|rocket
|[[power cell]]|cell
|[[10mm ammo chain]]|pammo
|[[shell box]]|pshell
|[[rocket box]]|procket
|[[power battery]]|pcell
|[[pistol]]|pistol
|[[shotgun]]|shotgun
|[[double shotgun]]|dshotgun
|[[combat shotgun]]|ashotgun
|[[rocket launcher]]|bazooka
|[[chaingun]]|chaingun
|[[plasma rifle]]|plasma
|[[small med-pack]]|smed
|[[large med-pack]]|lmed
}}
{{Table2Col
|es=background: #333;
|c1=text-align:right; vertical-align:top; padding:0px 2px;
|c2=vertical-align:top; padding:0px 2px;
|[[phase device]]|phase
|[[homing phase device]]|hphase
|[[envirosuit pack]]|epack
|[[thermonuclear bomb]]|nuke
|[[power mod pack]]|mod_power
|[[technical mod pack]]|mod_tech
|[[agility mod pack]]|mod_agility
}}
{{Table2Col
|es=background: #333;
|c1=text-align:right; vertical-align:top; padding:0px 2px;
|c2=vertical-align:top; padding:0px 2px;
|[[bulk mod pack]]|mod_bulk
|[[Lever|lever (floods with water)]]|lever_flood_water
|[[Lever|lever (floods with acid)]]|lever_flood_acid
|[[Lever|lever (floods with lava)]]|lever_flood_lava
|[[Lever|lever (harms creatures)]]|lever_kill
|[[Lever|lever (forces explosions)]]|lever_explode
|[[Lever|lever (destroys walls)]]|lever_walls
|[[Lever|lever (summons enemies)]]|lever_summon
|[[Lever|lever (Armor depot)]]|lever_repair
|[[Lever|lever (MediTech depot)]]|lever_medical
|[[Hell's Armory|lever (opens the lab)]]|lever_spec3
|[[Dis|lever (lowers walls)]]|dis_switch
|[[schematics|schematics (basic)]]|schematic_0
|[[schematics|schematics (advanced)]]|schematic_1
|[[schematics|schematics (master)]]|schematic_2
|[[Backpack]]|backpack
|[[lava element]]|lava_element
|[[teleport]]|teleport
|stubitem|stubitem
}}
|}
{|class="wikitable" style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
! colspan="2" style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Exotic Items'''
{{Table2Col
|es=background: #333;
|c1=text-align:right; vertical-align:top; padding:0px 2px;
|c2=vertical-align:top; padding:0px 2px;
|[[chainsaw]]|chainsaw
|[[combat pistol]]|ucpistol
|[[blaster]]|ublaster
|[[super shotgun]]|udshotgun
|[[assault shotgun]]|uashotgun
|[[plasma shotgun]]|upshotgun
|[[tristar blaster]]|utristar
|[[minigun]]|uminigun
|[[missile launcher]]|umbazooka
|[[napalm launcher]]|unapalm
|[[nuclear plasma rifle]]|unplasma
|[[laser rifle]]|ulaser
|[[combat translocator]]|utrans
|[[BFG 9000]]|bfg9000
|[[nuclear BFG 9000]]|unbfg9000
}}
{{Table2Col
|es=background: #333;
|c1=text-align:right; vertical-align:top; padding:0px 2px;
|c2=vertical-align:top; padding:0px 2px;
|[[medical armor]]|umedarmor
|[[duelist armor]]|uduelarmor
|[[bullet-proof vest]]|ubulletarmor
|[[ballistic vest]]|uballisticarmor
|[[energy-shielded vest]]|ueshieldarmor
|[[ballistic shield]]|ubalshield
|[[plasma shield]]|uplasmashield
|[[energy shield]]|uenergyshield
|[[onyx armor]]|uoarmor
|[[phaseshift armor]]|uparmor
|[[phaseshift boots]]|upboots
|[[gothic armor]]|ugarmor
|[[gothic boots]]|ugboots
|[[acid-proof boots]]|uacidboots
|[[firestorm weapon pack]]|umod_firestorm
|[[sniper weapon pack]]|umod_sniper
|[[Onyx Armor Pack]]|umod_onyx
|[[Nano Pack]]|umod_nano
|[[shockwave pack]]|uswpack
|[[blood skull]]|ubskull
|[[fire skull]]|ufskull
|[[hatred skull]]|uhskull
}}
|}
{|class="wikitable" style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
! colspan="2" style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Unique Items'''
{{Table2Col
|es=background: #333;
|c1=text-align:right; vertical-align:top; padding:0px 2px;
|c2=vertical-align:top; padding:0px 2px;
|[[Butcher's Cleaver]]|ubutcher
|[[Subtle Knife]]|usubtle
|[[Mjollnir]]|umjoll
|[[Trigun]]|utrigun
|[[Grammaton Cleric Beretta]]|uberetta
|[[Anti-Freak Jackal]]|ujackal
|[[Jackhammer]]|usjack
|[[Frag Shotgun]]|ufshotgun
|[[Mega Buster]]|umega
|[[Revenant's Launcher]]|urbazooka
|[[Railgun]]|urailgun
|[[BFG 10K]]|ubfg10k
|[[Acid Spitter]]|uacid
|[[Charch's Null Pointer]]|unullpointer
|[[Cybernetic Armor]]|ucarmor
|[[Medical Powerarmor]]|umedparmor
|[[Shielded Armor]]|ushieldarmor
|[[Necroarmor]]|unarmor
|[[Lava Armor]]|ulavaarmor
|[[Malek's Armor]]|umarmor
|[[Enviroboots]]|uenviroboots
|[[Nyarlaptotep's Boots]]|unboots
|[[Hellwave Pack]]|uhwpack
|[[Hell Staff]]|umodstaff
}}
{{Table2Col
|es=background: #333;
|c1=text-align:right; vertical-align:top; padding:0px 2px;
|c2=vertical-align:top; padding:0px 2px;
|[[Berserker Armor]]|uberarmor
|[[Dragonslayer]]|udragon
|[[Angelic Armor]]|aarmor
|[[Longinus Spear]]|spear
|[[Azrael's Scythe]]|uscythe
|[[Arena Master's Staff]]|uarenastaff
}}
|}

The Berserker Armor and Dragonslayer are not loaded in custom modules.

Natural enemy weapons (such as the imp's fireball or the mancubus's launcher) are autogenerated. If you want to use an natural weapon directly (for whatever reason) they are named <tt>"nat_" .. being.id</tt>.

== [[Modding:Missile|Missiles]] ==

{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Missiles'''
|-
|style="text-align: right; vertical-align:top; padding-right: 2ex;"|gun
|-style="background: #333;"
|style="text-align: right; vertical-align:top; padding-right: 2ex;"|chaingun
|-
|style="text-align: right; vertical-align:top; padding-right: 2ex;"|plasma
|-style="background: #333;"
|style="text-align: right; vertical-align:top; padding-right: 2ex;"|rocket
|-
|style="text-align: right; vertical-align:top; padding-right: 2ex;"|bazooka_alternative
|-style="background: #333;"
|style="text-align: right; vertical-align:top; padding-right: 2ex;"|explround
|-
|style="text-align: right; vertical-align:top; padding-right: 2ex;"|bfg
|-style="background: #333;"
|style="text-align: right; vertical-align:top; padding-right: 2ex;"|bfgover
|-
|style="text-align: right; vertical-align:top; padding-right: 2ex;"|blaster
|-style="background: #333;"
|style="text-align: right; vertical-align:top; padding-right: 2ex;"|knife_thrown
|}

{| style="border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=2 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Shotgun Missiles'''
|-
|style="text-align: right; vertical-align:top; padding-right: 2ex;"|normal
|-style="background: #333;"
|style="text-align: right; vertical-align:top; padding-right: 2ex;"|wide
|-
|style="text-align: right; vertical-align:top; padding-right: 2ex;"|focused
|-style="background: #333;"
|style="text-align: right; vertical-align:top; padding-right: 2ex;"|splasma
|}

Autogenerated missiles are similar to the sID of the weapon to which they are assigned, but an "m" is included before the name. Thus, for autogenerated missiles from autogenerated natural weapons, you'll use the use <tt>"mnat_" .. being.id</tt>.

Subtle Knife

2013-06-12T22:59:45Z

Rabinowitz:

{{infostrat switch}}
{{melee weapon|
weapon_name=Subtle Knife - [[Melee_Types|Melee Family]]|
weapon_dmg=3d5/3-15|
weapon_avgdmg=9|
weapon_dmgtype=[[Damage type#BFG Plasma|BFG Plasma]]|
weapon_accuracy=+0|
weapon_afire=Invoke|
weapon_get=Random (15+)|
weapon_quote=''Looks very inconspicious.''|
weapon_looks=\|
weapon_description=''A weapon that can cut the very fabric of reality. Too bad it's only eight inches long...''|
weapon_other=Using invoke will deal 10 [[Damage type#BFG Plasma|BFG Plasma]] damage to all enemies you can see, at the cost of making you [[Tactics|tired]] and reducing your max health by 2 points. Takes 1 second to activate.|
weapon_source={{Wiki|The_Subtle_Knife|His Dark Materials}}by Philip Pullman}}

Elite former sergeant

2013-06-06T15:02:48Z

Rabinowitz:

{{infostrat switch}}
{{Monsters|
monster_name=Elite former sergeant|
monster_looks=h|
monster_hp=25|
monster_ac=2 (+1 from equipped [[green armor]], total 3)|
monster_acc=+0 melee, +0 ranged|
monster_melee=1d3+1 = 2-4 = 3 avg|
monster_projectile=Attacks with an {{exotic link|assault shotgun}}: 7d3 = 7-21 = 14 avg
OR

Attacks with a {{exotic link|plasma shotgun}}: 7d3 = 7-21 = 14 avg

OR

Attacks with a {{exotic link|super shotgun}}: (8d4)x2 = 16-64 = 40 avg|
monster_speed=100%|
monster_dlvl=60-90|
monster_xp=320|
monster_inventory=Assault Shotgun/Super Shotgun: [[shotgun shell]] (x60), [[green armor]] (equipped)

Plasma Shotgun: [[power cell]] (x60), [[green armor]] (equipped)|
monster_pickup=Yes|
monster_doors=Yes|
monster_atkchance=75|
monster_abilities=N/A|
monster_description=''These are the elite among the former sergeants. And they carry firepower to boot! Too bad their weapons are set to self-destruct on death.''|
monster_other=15% bullet and shrapnel resist from green armor.
Weapon is picked randomly for each elite former sergeant.

Elite formers never drop their weapon.}}

Elite former commando

2013-06-05T00:34:55Z

Rabinowitz:

{{infostrat switch}}
{{Monsters|
monster_name=Elite former commando|
monster_looks=h|
monster_hp=40|
monster_ac=2 (+2 from equipped [[blue armor]], total 4)|
monster_acc=+3 melee, +5 (tristar blaster) or +10 (missile launcher, napalm launcher) ranged|
monster_melee=1d3+3 = 4-6 = 5 avg|
monster_projectile=Attacks with an {{exotic link|missile launcher}}: 6d6 = 6-36 = 21 avg
OR

Attacks with a {{exotic link|napalm launcher}}: 7d7 = 7-49 = 28 avg

OR

Attacks with a {{exotic link|tristar blaster}}: (4d5)x3 = 4-20 each = 12 avg each|
monster_speed=100%|
monster_dlvl=80+|
monster_xp=608|
monster_inventory=Missile Launcher: [[rocket]] (x20), [[blue armor]] (equipped)
Napalm Launcher: [[rocket]] (x12), [[blue armor]] (equipped)

Tristar Blaster: [[power cell]] (x60), [[blue armor]] (equipped)|
monster_pickup=Yes|
monster_doors=Yes|
monster_atkchance=75|
monster_abilities=N/A|
monster_description=''As expected, these ex-human soldiers are the best of the best! Armored, resilient and with superior firepower! Too bad their weapons are set to self-destruct on death.''|
monster_other=20% plasma resist from blue armor.

Takes no damage from [[fluids]].

Weapon is picked randomly for each elite former commando.

Elite formers never drop their weapon.}}

Elite former captain

2013-06-04T23:53:11Z

Rabinowitz:

{{infostrat switch}}
{{Monsters|
monster_name=Elite former captain|
monster_looks=h|
monster_hp=25|
monster_ac=2 (+2 from equipped [[blue armor]], total 4)|
monster_acc=+1 melee, +1 (minigun) OR +8 (laser rifle) ranged|
monster_melee=1d3+1 = 2-4 = 3 avg|
monster_projectile=Attacks with a {{exotic link|laser rifle}}: (1d7)x5 = 5-35 = 20 avg
OR

Attacks with a {{exotic link|minigun}}: (1d6)x8 = 8-48 = 28 avg|
monster_speed=90%|
monster_dlvl=70+|
monster_xp=452|
monster_inventory=Minigun: [[10mm ammo]] (x200), [[blue armor]] (equipped)
Laser Rifle: [[power cell]] (x50), [[blue armor]] (equipped)|
monster_pickup=Yes|
monster_doors=Yes|
monster_atkchance=75|
monster_abilities=20% plasma resist from blue armor.

Weapon is picked randomly for each elite former captain.

Elite formers never drop their weapon.|
monster_description=''These are the elite among the former captains. Beware of the superior firepower! Too bad their weapons are set to self-destruct on death.''|
monster_other=N/A}}

Barrel

2013-06-04T22:21:25Z

Rabinowitz: Created page with "{| style="rules: cols; border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;" |colspan=11 style="background: darkred; color: yellow; font-size: 120%..."

{| style="rules: cols; border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=11 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Barrels O'Fun'''
|-
|style="text-align: center; padding: 1ex; border: solid darkred; border-width: 0 1px 1px 0" width=100|'''Name'''
|style="text-align: center; padding: 1ex; border: solid darkred; border-width: 0 1px 1px 1px" width=50|'''Appearance'''
|style="text-align: center; padding: 1ex; border: solid darkred; border-width: 0 1px 1px 1px" width=50|'''HP'''
|style="text-align: center; padding: 1ex; border: solid darkred; border-width: 0 1px 1px 1px" width=50|'''Armor'''
|style="text-align: center; padding: 1ex; border: solid darkred; border-width: 0 1px 1px 1px" width=50|'''Fragile'''
|style="text-align: center; padding: 1ex; border: solid darkred; border-width: 0 0 1px 1px"|'''Special'''
|- style="background: #333;"
|style="text-align: left; padding-right: 1ex; border: solid darkred; border-width: 0 1px 0 0"|barrel of fuel
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|'''0'''
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|2
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|3
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|yes
|style="text-align: center; border: solid darkred; border-width: 0 0 0 1px"|Can be pushed. When destroyed, creates a radius 4 [[explosions|explosion]] dealing 5d5 [[Damage type#fire|fire damage]].
|- style="background: #333;"
|style="text-align: left; padding-right: 1ex; border: solid darkred; border-width: 0 1px 0 0"|barrel of acid
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|'''0'''
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|2
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|4
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|yes
|style="text-align: center; border: solid darkred; border-width: 0 0 0 1px"|Can be pushed. When destroyed, creates a radius 4 [[explosions|explosion]] dealing 6d6 [[Damage type#acid|acid damage]], sometimes leaving behind acid tiles.
|-
|style="text-align: left; padding-right: 1ex; border: solid darkred; border-width: 0 1px 0 0"|barrel of napalm
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|'''0'''
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|2
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|5
|style="text-align: center; border: solid darkred; border-width: 0 1px 0 1px"|yes
|style="text-align: center; border: solid darkred; border-width: 0 0 0 1px"|Can be pushed. When destroyed, creates a radius 4 [[explosions|explosion]] dealing 7d7 [[Damage type#fire|fire damage]], sometimes (often) leaving behind lava tiles.
|}

Level feeling

2013-06-04T21:23:56Z

Rabinowitz: /* Other */

__NOTOC__
Level feelings are determined at random throughout the game and add features to a particular map. Depending on the level feeling, multiple feelings can exist on the same level.

If you can't find a displayed message here, check the [[level event]] page for other possibilities.

=== [[Room Generation#Lever Rooms|Levers]] ===

* '''You feel that smell? That gasoline smell? Oh hell...'''
** There is a lever that floods every tile with [[Fluids|lava]]. If you see this message then don't pull any of the levers in the level; it will not be worth the risk, even if you have an [[envirosuit pack]].
* '''In the State of Denmark there was the odor of decay...'''
** There is a lever that floods every tile with [[Fluids|acid]]. Just as with the level feeling above, don't pull levers if this shows up. Enough points invested into [[Traits#Intuition|Intuition]] will make this manageable, however.
* '''The air is really humid here...'''
** There is a lever that floods every tile with [[Fluids|water]]. Same as the last two, except not deadly at all and can actually be useful in preventing corpses.
* '''The smell of a massacre... '''
** This indicates the presence of a 'kills creatures' lever that affects all creatures on the map. This is particularly useful early on, as it is capable of destroying most early-game enemies completely.
* '''You hear the trumpets of Jericho echoing in the distance...'''
** There is a lever that will destroy all walls on the map when pulled. Does not include border walls. Generally a big problem for the player, considering that they make use of the cover more than enemies do.

=== [[Room Generation#Vaults|Vaults]] ===

Each of these feelings indicate that there is a [[Room Generation#Vault room|vault]] somewhere on the level. Multiple instances of these feelings indicate multiple vaults, as well.

* '''There's something special here...'''
* '''There's the smell of blood in the air!'''
* '''You feel excited!'''

===[[Level type|Level Type]]===

If this level feeling occurs, it means you get a level type very different in style. In addition, Levers and Vaults feelings cannot occur.

* '''Suddenly monsters come from everywhere!'''
** Indicates that you have spawned in an [[Level type#Arena|Arena]].
* '''Twisted passages carry the smell of death...'''
** Indicates that you have spawned in a [[Level type#Cave|Cave]].
* '''Where the hell is the way out of here!?!'''
** Indicates that you have spawned in a [[Level type#Maze|Maze]].
* The following messages indicate a [[Level type#Single Monster|single monster]] level type:
**'''You hear many marching feet.''' (equal distribution of all former-type enemies)
**'''The walls are scratched and flame-scorched!''' (all [[imp|imps]])
**'''A battle cry chants in the distance!''' (equal distribution of [[hell knight|hell knights]] and [[baron of hell|barons of hell]])
**'''You hear deep, guttural noises!''' (all [[mancubus|mancubi]])
**'''Bones clatter all around you!''' (all [[revenant|revenants]])
**'''You hear crackling flames!''' (all [[arch-vile|arch-viles]])
**'''Hellish magic haunts air!''' (half archviles, half formers)
**'''You hear loud wails that cannot mean anything good!''' (all [[bruiser brother|bruiser brothers]])
**'''The air is crackling with electricity!''' (all [[shambler|shamblers]])
**'''Suddenly you have a great urge to turn back! You scream in TERROR!''' (all [[Cyberdemon|Cyberdemons]])

===[[Levels#Special Levels|Special Levels]]===

If this level feeling occurs, it means there will be a separate set of stairs (colored red) that allows access to one of the special levels.

* '''You feel a breeze of morbid air...'''
* '''You sense a passage to a place beyond...'''
* '''You shiver from cold...'''

=== Other ===

* '''You feel there is something really valuable here!'''
** Somewhere on the level one of the [[specials|uniques]] was generated.
* '''Khe, he, he. This will be a mess...'''
** The level is generated chock-full of [[Barrel|barrels]]. Barrel type depends on depth rather than being random.
* '''As you enter, some weird alarm starts howling!'''
** All monsters are set to actively hunt the player.
* '''The air seems deadly here, you better leave quick!'''
** Every X seconds ((0.1s × (100 - 5 × difficulty)), the player and enemies will lose a few HP. Envirosuit prevents those damages.
* '''You hear sounds of hellish mortars!'''
** Every few seconds of game time, an explosion occurs somewhere on the level. This explosion can damage you or enemies and destroy items or barrels.
* '''They rolled out BIG guns!'''
** Always paired with You hear the sounds of hellish mortars!. Same as above, but napalm explosions occur, covering the area with lava.

Elite former human

2013-06-04T20:07:32Z

Rabinowitz:

{{infostrat switch}}
{{Monsters|
monster_name=Elite former human|
monster_looks=h|
monster_hp=20|
monster_ac=2 (+1 from equipped [[green armor]], total 3)|
monster_acc=-2 melee, +5 ranged|
monster_melee=1d3+1 = 2-4 = 3 avg|
monster_projectile=Attacks with a {{exotic link|combat pistol}}: 3d3 = 3-9 = 6 avg|
monster_speed=100%|
monster_dlvl=40-80|
monster_xp=167|
monster_inventory=[[10mm ammo]] (x72), [[green armor]] (equipped)|
monster_pickup=Yes|
monster_doors=Yes|
monster_atkchance=75|
monster_abilities=15% bullet and shrapnel resist from green armor.
Elite formers never drop their weapon.|
monster_description=''These are the elite among the former humans. As stupid as their regular counterparts, but more resilient and packing quite a punch. Too bad their weapons are set to self-destruct on death.''|
monster_other=N/A}}

Megasphere

2013-06-04T17:43:59Z

Rabinowitz:

{{infostrat switch}}
{{Item|
item_name=Megasphere|
item_get=Random (16+)|
item_looks=^|
item_effect=Sets HP to 200%; repairs any [[armor]] currently equipped to its maximum durability, including that that cannot be repaired regularly (shields, {{unique link|Lava Armor}}, etc). Restores [[tactics|fatigue]].|
item_description=N/A|
item_other=N/A}}

Megasphere

2013-06-04T17:38:59Z

Rabinowitz:

{{infostrat switch}}
{{Item|
item_name=Megasphere|
item_get=Random (16+)|
item_looks=^|
item_effect=Sets HP to 200%; repairs any [[armor]] currently equipped to its maximum durability, including 'unrepairable' shields. Restores [[tactics|fatigue]].|
item_description=N/A|
item_other=N/A}}

Misc Types

2013-06-04T17:11:17Z

Rabinowitz: /* Special */

''The following is a list of [[weapons]] that are [[Weapon_Families|classified]] as the [http://doom.chaosforge.org/wiki/Misc_Types miscellaneous type], as they do not belong in any proper group.''

== '''Type''' ==

=== '''Special''' ===
* {{exotic link|Tristar blaster}}
* {{exotic link|Combat translocator}}
* {{unique link|Railgun}}
* {{unique link|Acid Spitter}}
* {{unique link|Charch's Null Pointer}}

== '''About Miscellaneous Weapons''' ==

=== '''Overview and Strategy''' ===
{{infostrat switch}}
edit me

=== '''Special Details''' ===
{{Technical}}
edit me

Rapid-fire Types

2013-06-04T17:08:50Z

Rabinowitz: /* Special */

''The following is a list of [[weapons]] that are [[Weapon_Families|classified]] as the [http://doom.chaosforge.org/wiki/Rapid-fire_Types rapid-fire type] for the purposes of [[Challenges]] and [[Traits]].''

== '''Types''' ==

=== '''Standard''' ===
*[[Chaingun]]
*[[Plasma_rifle|Plasma rifle]]

=== '''[[Assemblies|Assembly]]''' ===
*{{assembly link|Gatling gun}}
*{{assembly link|Hyperblaster}}

*{{SpAssembly link|High power chaingun}}
*{{SpAssembly link|High power plasma rifle}}
*{{SpAssembly link|High power minigun}}
*{{SpAssembly link|High power laser rifle}}
*{{SpAssembly link|High power nuclear plasma rifle}}

*{{SpAssembly link|Assault rifle chaingun}}
*{{SpAssembly link|Assault rifle plasma rifle}}
*{{SpAssembly link|Assault rifle minigun}}
*{{SpAssembly link|Assault rifle laser rifle}}
*{{SpAssembly link|Assault rifle nuclear plasma rifle}}

*{{SpAssembly link|Burst cannon chaingun}}
*{{SpAssembly link|Burst cannon plasma rifle}}
*{{SpAssembly link|Burst cannon minigun}}
*{{SpAssembly link|Burst cannon laser rifle}}
*{{SpAssembly link|Burst cannon nuclear plasma rifle}}

*{{SpAssembly link|Demolition ammo chaingun}}
*{{SpAssembly link|Demolition ammo minigun}}

*{{SpAssembly link|Nanomanufacture ammo chaingun}}
*{{SpAssembly link|Nanomanufacture plasma rifle}}
*{{SpAssembly link|Nanomanufacture ammo minigun}}
*{{SpAssembly link|Nanomanufacture ammo laser rifle}}
*{{SpAssembly link|Nanomanufacture ammo nuclear plasma rifle}}

=== '''Special''' ===
* {{exotic link|Minigun}}
* {{exotic link|Laser rifle}}
* {{exotic link|Nuclear plasma rifle}}
* {{unique link|BFG 10K}}
* {{unique link|Mega Buster}}

== '''About Rapid-fire Weapons''' ==
=== '''Overview and Strategy''' ===
edit me
{{infostrat switch}}

=== '''Special Details''' ===
{{Technical}}
edit me

Shotgun Types

2013-06-04T17:07:30Z

Rabinowitz: /* Special */

''The following is a list of [[weapons]] that are [[Weapon_Families|classified]] as the [http://doom.chaosforge.org/wiki/Shotgun_Types shotgun type] for the purposes of [[Challenges]] and [[Traits]].''

== Types ==

=== '''Standard''' ===
*[[Shotgun]]
*[[Combat_shotgun|Combat shotgun]]
*[[Double_shotgun|Double shotgun]]

=== '''[[Assemblies|Assembly]]''' ===
*{{assembly link|Elephant gun}}
*{{assembly link|Tactical shotgun}}
*{{assembly link|Focused double shotgun}}

*{{SpAssembly link|Plasmatic shrapnel shotgun}}
*{{SpAssembly link|Plasmatic shrapnel combat shotgun}}
*{{SpAssembly link|Plasmatic shrapnel double shotgun}}
*{{SpAssembly link|Plasmatic shrapnel assault shotgun}}
*{{SpAssembly link|Plasmatic shrapnel plasma shotgun}}
*{{SpAssembly link|Plasmatic shrapnel super shotgun}}

*{{SpAssembly link|Nano-shrapnel shotgun}}
*{{SpAssembly link|Nano-shrapnel combat shotgun}}
*{{SpAssembly link|Nano-shrapnel double shotgun}}
*{{SpAssembly link|Nano-shrapnel assault shotgun}}
*{{SpAssembly link|Nano-shrapnel plasma shotgun}}
*{{SpAssembly link|Nano-shrapnel super shotgun}}

=== '''Special''' ===
* {{exotic link|Assault shotgun}}
* {{exotic link|Plasma shotgun}}
* {{exotic link|Super shotgun}}
* {{unique link|Jackhammer}}
* {{unique link|Frag Shotgun}}

== '''About Shotguns''' ==

=== '''Overview and Strategy''' ===
{{infostrat switch}}
The weapons from the shotgun family of DoomRL all have an cone-shaped area of effect attack that makes them unique and powerful. Shotguns never miss any target in their affected area, and they always do at least one damage to each target. The size of the shotgun blast varies from weapon to weapon. It is governed by two parameters: range and spread. The range of a shotgun determines how far the blast extends from the attacker, and the spread determines the half-width of the blast when it reaches it's furthest point.

Shotgun damage also diminishes over distance. Each shotgun has a reduction rating that determines what percentage of damage is taken off per tile of [[distance]]. This penalty is applied linearly, and it is applied even at point-blank range. Rounding is to the nearest integer (0.5 rounds to even).

DoomRL uses shotguns with four different Area of Effect types:

{| style="rules: cols; border: 2px solid darkred; border-spacing: 0; font-size: 90%; margin: 0.25em 0.5em;"
|colspan=11 style="background: darkred; color: yellow; font-size: 120%; text-align: center"|'''Shotgun Area of Effect Types'''
|-
|style="text-align: center; padding: 1ex; border: solid darkred; border-width: 0 1px 1px 0" width=100|'''Name'''
|style="text-align: center; padding: 1ex; border: solid darkred; border-width: 0 1px 1px 1px" width=50|'''Range'''
|style="text-align: center; padding: 1ex; border: solid darkred; border-width: 0 1px 1px 1px" width=50|'''Spread'''
|style="text-align: center; padding: 1ex; border: solid darkred; border-width: 0 0 1px 1px" width=50|'''Reduction'''
|- style="background: #333;"
|style="text-align: left; padding-right: 1ex; border: solid darkred; border-width: 1px 1px 0 0"|normal
|style="text-align: center; border: solid darkred; border-width: 1px 1px 0 1px"|15
|style="text-align: center; border: solid darkred; border-width: 1px 1px 0 1px"|3
|style="text-align: center; border: solid darkred; border-width: 1px 0 0 1px"|7%
|-
|style="text-align: left; padding-right: 1ex; border: solid darkred; border-width: 1px 1px 0 0"|focused
|style="text-align: center; border: solid darkred; border-width: 1px 1px 0 1px"|15
|style="text-align: center; border: solid darkred; border-width: 1px 1px 0 1px"|2
|style="text-align: center; border: solid darkred; border-width: 1px 0 0 1px"|5%
|- style="background: #333;"
|style="text-align: left; padding-right: 1ex; border: solid darkred; border-width: 1px 1px 0 0"|wide
|style="text-align: center; border: solid darkred; border-width: 1px 1px 0 1px"|8
|style="text-align: center; border: solid darkred; border-width: 1px 1px 0 1px"|3
|style="text-align: center; border: solid darkred; border-width: 1px 0 0 1px"|10%
|-
|style="text-align: left; padding-right: 1ex; border: solid darkred; border-width: 1px 1px 0 0"|plasma
|style="text-align: center; border: solid darkred; border-width: 1px 1px 0 1px"|15
|style="text-align: center; border: solid darkred; border-width: 1px 1px 0 1px"|3
|style="text-align: center; border: solid darkred; border-width: 1px 0 0 1px"|5%
|}

=== '''Area of Effect Details''' ===
{{Technical}}
To calculate a shotgun's area of effect, first a target square is calculated by extrapolating from the vector pointing at the manually targeted square. The true target will be a tile that is at the shotgun's maximum range with an approximately parallel vector. Then, for each tile in a (2 × spread + 1) side-length square around the target, the game traces out the path of a missile until it hits a wall. (Shotgun blasts go through enemies.) The missile paths are truncated if the distance along one of the axes becomes greater than the shotgun's range. For each tile that was traced out in at least one of the missile paths, damage is applied.

Melee Types

2013-06-04T17:03:50Z

Rabinowitz: /* Special */

''The following is a list of [[weapons]] that are [[Weapon_Families|classified]] as the [http://doom.chaosforge.org/wiki/Melee_Types melee type] for the purposes of [[Challenges]] and [[Traits]]. Note that some [[Challenges]] and [[Traits]] go to further lengths, and specify blades in specific, which are a sub-class of this family''

== '''Types''' ==

=== '''Standard''' ===
*[[Fists]]
*[[Combat_knife|Combat knife]]

=== '''[[Assemblies|Assembly]]''' ===
*{{assembly link|Chainsword}}
*{{assembly link|Piercing blade}}
*{{assembly link|Double chainsaw}}
*{{assembly link|Ripper}}

*{{SpAssembly link|Piercing combat knife}}
*{{SpAssembly link|Piercing chainsaw}}

=== '''Special''' ===
* {{exotic link|Chainsaw}}
* {{unique link|Butcher's Cleaver}}
* {{unique link|Dragonslayer}}
* {{unique link|Mjollnir}}
* {{unique link|Subtle Knife}}
* {{artifact link|Azrael's Scythe}}
* {{artifact link|Longinus Spear}}

== '''About Melee''' ==

=== '''Overview and Strategy''' ===

{{infostrat switch}}
edit me

=== '''Special Details''' ===
{{Technical}}
edit me

Backpack

2013-06-02T01:59:21Z

Rabinowitz:

{{infostrat switch}}
{{Item|
item_name=Backpack!|
item_get=[[The Wall]], [[Containment Area]]|
item_looks=^|
item_description=N/A|
item_effect=Permanently increases stack size of [[Items#Ammo|ammo]] in your inventory by 40%.|
item_other=N/A}}