Item System Reference - dredmor-com/dungeons-of-dredmor GitHub Wiki

This reference is a guideline to how the system developed around items works like. It will help you understand how tags and items interact like.

1. Legend
2. Item Tag
3. Power Tag
4. See Also

= Food or Booze

= Weapons

= Armour

= Bolts or Thrown Weapons

= Potions

= Traps

= Craft Materials

<item>
Used With	Name	Input	Description	Example
	name	string	Shows up in-game as the item's name.	name="Cheese Round"
	iconFile	path	Path the the item's image, what it appears as in-game.	iconFile="items/food_cheese_round.png"
	special	boolean	Indicates if the item can be found on the floor or not.	special="1"
	level	ROTDG enabled: 0 - 15 No ROTDG: 0 - 10	Level it appears most often in.	level="4"
	type	0 - 8	Weapon Type.	type="0"
	artifact	boolean	Indicates if this item is an artifact, this can not be renamed (Archaeology, Krong).	artifact="1"
	maxstack	value	Amount of these approximately found on one stack.	maxstack="6"
	alchemical	boolean	Indicates if it shows up in craft dispensers.	alchemical="1"
	carftoutput	boolean	Indicates that this should show up nowhere.	craftoutput="1"
	overrideClassName	string	Changes classname corresponding to the item type to a custom one.	overrideClassName="Attachment"
<price>
	amount	value	Price cost approx. in stores (actual prices will be higher!).	amount="500"
<food>
	hp	value	Amount of HP healed with the food (makes item a food item!).	hp="5"
	mp	value	Amount of Mana healed with alcohol (makes item an alcoholic item!).	mp="12"
	meat	boolean	Indicates if this item can be used by vegans (1 = CANNOT be used by vegans).	meat="1"
	effect	string	What spell to cast on the player when he eats this item.	effect="Lingering Weakness"
<description>
	text	string	The funny but needed description when hovering over an item.	text="This is what happens when someone leaves the milk out.
<weapon>
	*damagetype*	string	Insert a *damagetype* for the weapon to deal. Multiple damagetypes can be used.	voltaic="5" blasting="3"
	hit	string	Spell casted upon hit with a bolt or thrown weapon.	hit="Clockwork Drill Hit
	thrown	string	Graphic to show up following the thrown weapon when it's airborne.	thrown="items/thrown_grenade.png"
	canTargetFloor	boolean	Whether the thrown weapon or bolt can target the floor.	canTargetFloor="1"
<artifact>
	quality	value	How many random bonuses generate on a weapon.	quality="2"
<armour>
	level	ROTDG enabled: 0 - 15 No ROTDG: 0 - 10	What floor the armour appears on.	level="4"
	type	string	What bodypart the armour fits on.	type="neck"
	randoms	boolean	Function unclear...	randoms="1"
<primarybuff>
	id	0 - 5	Specific primary buff change on the item	id="0"
	amount	value	Amount of that buff to add or remove.	amount="-3"
<secondarybuff>
	id	0 - 23	Specific secondary buff change on the item.	id="12"
	amount	-inf - inf	Amount of that buff to add or remove	amount="4"
<resistbuff>
	*damagetype*	value	What damagetype the armour or weapon does or doesn't resist. Can have multiple in one tag.	blasting="-4"
<damagebuff>
	*damagetype*	value	What damagetype the armour does or doesn't boost. Can have multiple in one tag.	conflagratory="7"
<targetHitEffectBuff>
	percentage	0 - 100	Percentage the item will actually cast a spell	percentage="50"
	name	string	The spell cast upon hitting an enemy.	name="Rockburst"
<playerHitEffectBuff>
	percentage	0 - 100	Percentage the item will actually cast a spell.	percentage="35"
	name	string	The spell to cast upon getting hit.	name="Defend"
<potion>
	spell	string	What spell to cast upon drinking the potion.	spell="Medium Regen"
<wand>
	spell	string	What spell to cast upon using the wand.	spell="Voltaic Empowerment"
	mincharge	value	The smallest charge a wand can have.	mincharge="5"
	maxcharge	value	The biggest charge a wand can have.	maxcharge="6"
<trap>
	trigger	"once"/"always"	How many times the trap can trigger	trigger="Once"
	casts	string	What spell to cast upon walking over the trap.	casts="Makeshift Bomb Center"
	level	ROTDG enabled: 0 - 15 No ROTDG: 0 - 10	What level it appears on mainly, and how hard it is to disarm.	level="7"
	origin	path	Path to the trap image (for gargoyles etc.)	origin="dungeon/trap_wall_gargoyle0.png"
	originFacing	"South" "East" "West"	Must be South if originMount is Wall and East/West when Floor.	originFacing="South"
	originMount	"Wall" "Floor"	Must be Wall if originFacing is South or Floor if East or West.	originMount="Wall"
	targetIsCaster	boolean	Function unclear...	targetIsCaster="1"
<gem>
This tag is needed to indicate gems for the core "Transmute Gem" spell.
	value	value	Function unclear...	value="1000"
	worthless	string	Function unclear...	worthless="worthless plastic triangle"
<mushroom>
This tag is needed to indicate mushrooms, so it can grow when planted on a "Patch of Dirt"
	value	value	Function unclear...	value="1000"
	worthless	string	Function unclear...	worhthless="an intriguing and potentially dangerous mushroom"
<casts>
	spell	string	What spell to cast upon eating this mushroom.	casts="Regal Vim"

<power>
Name	Input	Description	Example
name	string	The power name (encrustDB-xml => <power name='name'>) of this power	name="Rockburst"
description	string	What description will be ADDED to your item, when it has this power.	description="pounds your enemies with rocks."
spell	string	What spell will be cast upon attacking or getting attacked while this weapon or armour is equipped.	spell="Rockburst"

Item Tutorial

Item Types

Damage