gui/gm-editor

Tags: dfhack | armok | inspection | animals | buildings | items | jobs | map | plants | stockpiles | units | workorders

Command: gui/gm-editor

Inspect and edit DF game data.

This editor allows you to inspect or modify almost anything in DF. Press ? for in-game help.

Select a field and hit Enter or double click to edit, or, for structured fields, hit Enter or single click to inspect their contents. Right click or hit Esc to go back to the previous structure you were inspecting. Right clicking when viewing the structure you started with will exit the tool. Hold down Shift and right click to exit, even if you are inspecting a substructure, no matter how deep.

If you just want to browse without fear of accidentally changing anything, hit CtrlD to toggle read-only mode. If you want gui/gm-editor to automatically pick up changes to game data in realtime, hit AltA to switch to auto update mode.

Warning

Note that data structures can be created and deleted while the game is running. If you happen to be inspecting a dynamically allocated data structure when it is deleted by the game, the game may crash. Please save your game before poking around in gui/gm-editor, especially if you are examining data while the game is unpaused.

Usage

gui/gm-editor [-f]

Open the editor on whatever is selected or viewed (e.g. unit/item/building/ engraving/etc.)

gui/gm-editor [-f] <lua expression>

Evaluate a lua expression and opens the editor on its results. Field prefixes of df.global can be omitted.

gui/gm-editor [-f] dialog

Show an in-game dialog to input the lua expression to evaluate. Works the same as the version above.

Examples

gui/gm-editor

Opens the editor on the selected unit/item/job/workorder/stockpile etc.

gui/gm-editor world.items.all

Opens the editor on the items list.

gui/gm-editor --freeze scr

Opens the editor on the current DF viewscreen data (bypassing any DFHack layers) and prevents the underlying viewscreen from getting updates while you have the editor open.

Options

-f, --freeze

Freeze the underlying viewscreen so that it does not receive any updates. This allows you to be sure that whatever you are inspecting or modifying will not be read or changed by the game until you are done with it. Note that this will also prevent any rendering refreshes, so the background is replaced with a blank screen. You can open multiple instances of gui/gm-editor as usual when the game is frozen. The black background will disappear when the last gui/gm-editor window that was opened with the --freeze option is dismissed.

Screenshot