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.
Open the editor on whatever is selected or viewed (e.g. unit/item description screen)
gui/gm-editor [-f] <lua expression>
Evaluate a lua expression and opens the editor on its results. Field prefixes of
df.globalcan 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.
Opens the editor on the selected unit/item/job/workorder/stockpile etc.
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.
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
--freezeoption is dismissed.