Latest revision as of 21:57, 1 May 2024

This is a list of createitem commands for DFHack.

Not to be confused with gui/create-item, an interactive Lua script, or create-items, a Ruby script with different syntax and support for fewer types of items.

Usage[edit]

Format:

createitem [Item token] [Material] [Quantity (optional)]

If you select a unit, then that unit will be used as the crafter, otherwise the first unit in the fortress will be automatically selected. Clothing and armor items will be sized for that unit's creature type.
By default, items will be placed on the floor, either at the feet of the selected unit or beneath the cursor.
- If you select a container (such as a barrel, backpack, or minecart) and type createitem item, all subsequently created items will be placed inside that container.
- If you select a building (such as a workshop, chest, or weapon rack) and type createitem building, all subsequently created items will be placed inside that building.
- Typing createitem floor will switch it back to placing created items on the floor. This will also happen automatically if the previously-selected container or building is destroyed.
A list of valid item tokens can be found here. Note that CORPSE, CORPSEPIECE, and FOOD are not supported by DFHack.
You can create multiple items at once by appending a number to the createitem command (e.g. createitem BOULDER INORGANIC:HEMATITE 20). Note that certain item types will be created in stacks, while others will be created as individual items - see the Reactions page for more information.
Text in italics should be replaced with the ID from the relevant raw page on this wiki. For example, to make goblin-cap logs, visit the goblin-cap page and view the raws. The ID is found in the first token, separated from the item type with a colon - for example, the ID for goblin-caps is GOBLIN_CAP, retrieved from [PLANT:GOBLIN_CAP].
- Some IDs contain a space which needs to be quoted, for example createitem ROUGH "INORGANIC:LAPIS LAZULI".
- All ID values are case sensitive, so make sure you capitalize them correctly - in vanilla raws, they are typically all uppercase, but mixed-case IDs may be encountered when using mods.

Items[edit]

Inorganic items[edit]

Most of these can be obtained from the list of item tokens.

Stone[edit]

Boulders (i.e. mined stones):

BOULDER INORGANIC:stone

Blocks

BLOCKS INORGANIC:stone

Wood[edit]

Logs

WOOD PLANT_MAT:tree:WOOD

Blocks

BLOCKS PLANT_MAT:tree:WOOD

Metal[edit]

Bars (or wafers)

BAR INORGANIC:metal

Gems[edit]

Rough gems

ROUGH INORGANIC:gem

Small cut gems

SMALLGEM INORGANIC:gem

Large cut gems

GEM INORGANIC:gem

Glass[edit]

Raw glass:

ROUGH glass:NONE

Glass	Material token ("`glass`")
Green glass	GLASS_GREEN
Clear glass	GLASS_CLEAR
Crystal glass	GLASS_CRYSTAL

(Items made of glass, e.g. furniture, use these names as well)

Fuel[edit]

Coke

BAR COAL:COKE

Charcoal

BAR COAL:CHARCOAL

Misc[edit]

Ash bars

BAR ASH

Liquids (non-DRINK but including milk)

LIQUID_MISC material

Quires

TOOL:ITEM_TOOL_QUIRE material

Pipe sections

PIPE_SECTION material

Armor[edit]

Gauntlets (will automatically be created in pairs)

GLOVES:ITEM_GLOVES_GAUNTLETS material

Gloves (will automatically be created in pairs)

GLOVES:ITEM_GLOVES_GLOVES material

Helm

HELM:ITEM_HELM_HELM material

Cap

HELM:ITEM_HELM_CAP material

Breastplate

ARMOR:ITEM_ARMOR_BREASTPLATE material

Mail shirt

ARMOR:ITEM_ARMOR_MAIL_SHIRT material

Greaves

PANTS:ITEM_PANTS_GREAVES material

Leggings

PANTS:ITEM_PANTS_LEGGINGS material

High boots (will automatically be created in pairs)

SHOES:ITEM_SHOES_BOOTS material

Low boots (will automatically be created in pairs)

SHOES:ITEM_SHOES_SHOES material

Shoes (will automatically be created in pairs)

SHOES:ITEM_SHOES_BOOTS_LOW material

Cloak

ARMOR:ITEM_ARMOR_CLOAK material

Shield

SHIELD:ITEM_SHIELD_SHIELD material

Buckler

SHIELD:ITEM_SHIELD_BUCKLER material

Skirt (long)

PANTS:ITEM_PANTS_SKIRT_LONG material

Skirt (short)

PANTS:ITEM_PANTS_SKIRT_SHORT material

Skirt

PANTS:ITEM_PANTS_SKIRT material

Weapons[edit]

Whip:

WEAPON:ITEM_WEAPON_WHIP material

Battle axe:

WEAPON:ITEM_WEAPON_AXE_BATTLE material

War hammer:

WEAPON:ITEM_WEAPON_HAMMER_WAR material

Short sword:

WEAPON:ITEM_WEAPON_SWORD_SHORT material

Spear:

WEAPON:ITEM_WEAPON_SPEAR material

Mace:

WEAPON:ITEM_WEAPON_MACE material

Crossbow:

WEAPON:ITEM_WEAPON_CROSSBOW material

Pick:

WEAPON:ITEM_WEAPON_PICK material

Bow:

WEAPON:ITEM_WEAPON_BOW material

Blowgun:

WEAPON:ITEM_WEAPON_BLOWGUN material

Pike:

WEAPON:ITEM_WEAPON_PIKE material

Halberd:

WEAPON:ITEM_WEAPON_HALBERD material

Two-handed sword:

WEAPON:ITEM_WEAPON_SWORD_2H material

Long sword:

WEAPON:ITEM_WEAPON_SWORD_LONG material

Maul:

WEAPON:ITEM_WEAPON_MAUL material

Great axe:

WEAPON:ITEM_WEAPON_AXE_GREAT material

Dagger:

WEAPON:ITEM_WEAPON_DAGGER_LARGE material

Scourge:

WEAPON:ITEM_WEAPON_SCOURGE material

Flail:

WEAPON:ITEM_WEAPON_FLAIL material

Morningstar:

WEAPON:ITEM_WEAPON_MORNINGSTAR material

Scimitar:

WEAPON:ITEM_WEAPON_SCIMITAR material

Training axe:

WEAPON:ITEM_WEAPON_AXE_TRAINING material

Training sword:

WEAPON:ITEM_WEAPON_SWORD_SHORT_TRAINING material

Training spear:

WEAPON:ITEM_WEAPON_SPEAR_TRAINING material

Ammo[edit]

Bolts:

AMMO:ITEM_AMMO_BOLTS material
AMMO:ITEM_AMMO_BOLTS PLANT:GOBLIN_CAP:WOOD

Trap components[edit]

Menacing spike

TRAPCOMP:ITEM_TRAPCOMP_MENACINGSPIKE material

Large, serrated disc

TRAPCOMP:ITEM_TRAPCOMP_LARGESERRATEDDISC material

Spiked ball

TRAPCOMP:ITEM_TRAPCOMP_SPIKEDBALL material

Enormous corkscrew

TRAPCOMP:ITEM_TRAPCOMP_ENORMOUSCORKSCREW material

Giant axe blade

TRAPCOMP:ITEM_TRAPCOMP_GIANTAXEBLADE material

Tools[edit]

Nest box

TOOL:ITEM_TOOL_NEST_BOX material

Furniture[edit]

Format:

createitem Item token (from list below) Material

"Material" is the same as the material used to create basic items (e.g. logs, boulders, bars, etc.)

Item	Item token
Armor stand	ARMORSTAND
Bag	BAG
Bed	BED
Box	BOX
Cabinet	CABINET
Cage	CAGE
Chair	CHAIR
Chest	BOX
Coffer	BOX
Coffin	COFFIN
Door	DOOR
Floodgate	FLOODGATE
Grate	GRATE
Hatch cover	HATCH_COVER
Mechanisms	TRAPPARTS
Slab	SLAB
Statue	STATUE
Table	TABLE
Traction bench	TRACTION_BENCH
Weapon rack	WEAPONRACK

Animal products[edit]

Cloth/leather/milk[edit]

Yarn (creature must be able to produce wool):

CLOTH CREATURE_MAT:creature:HAIR

Silk (creature must be able to produce silk):

CLOTH CREATURE_MAT:creature:SILK

Plant fiber (only works with appropriate plants):

CLOTH PLANT_MAT:plant:THREAD

(Example: createitem CLOTH PLANT_MAT:GRASS_TAIL_PIG:THREAD 1)

Leather (tanned):

SKIN_TANNED CREATURE_MAT:creature:LEATHER

Milk (creature must be able to produce milk):

LIQUID_MISC CREATURE_MAT:creature:MILK

Shells[edit]

Shells (when demanded for moods, for example) are body parts and cannot be created directly. But it is possible to create a raw fish, then process it in a fishery:

FISH_RAW creature:caste

Example:

createitem FISH_RAW POND_TURTLE:MALE

Plant products[edit]

Drinks[edit]

Drink made from the specified plant:

DRINK PLANT_MAT:plant:DRINK

Example: createitem DRINK PLANT_MAT:MUSHROOM_HELMET_PLUMP:DRINK

Spawning drinks on the ground will create an undrinkable puddle. You may wish to select an empty barrel with the cursor first.

Mill Products[edit]

Flour, dyes, and sugar:

POWDER_MISC PLANT_MAT:plant:MILL

Example: createitem POWDER_MISC PLANT_MAT:MUSHROOM_CUP_DIMPLE:MILL

Note that powders will only be usable if you create them into a bag by doing "createitem item" beforehand.

Seeds[edit]

Seeds for farming:

SEEDS PLANT_MAT:plant:SEED

Growths[edit]

Growths being FRUIT, LEAVES, FLOWERS, etc:

PLANT_GROWTH PLANT:plant:growth

Equipment[edit]

Flask/Waterskin/Vial:

FLASK:NONE material

Backpack:

BACKPACK:NONE material

Materials[edit]

Unusual materials that work for most items above

Body parts[edit]