Easily install and uninstall mods.
This tool provides a simple way to install and remove small mods that you have
downloaded from the internet – or have created yourself! Several mods are
available here. Mods that you want
to manage with this tool should go in the
mods subfolder under your main
The mod manager must be invoked on the Dwarf Fortress title screen, before a world is generated. Any mods that you install will only affect worlds generated after you install them.
Each mod must include a lua script that defines the following variables:
The name that should be displayed in the mod manager list.
The mod author.
A description of the mod
Of course, this doesn’t actually make a mod - so one or more of the following variables should also be defined:
A list (table) of file names that need to be copied over to DF raws.
A chunk of text to use to patch the
A chunk of text to add to the
init.luafile in the raws.
A list (table) of files to run from
A table of files to patch, each element containing the following subfields:
A filename (relative to the raws folder) to patch.
The text to add.
A string after which to insert the text.
A token that is used in raw files to find additions from this mod and remove them on uninstall.
A token that is used in the
init.luafile to find additions from this mod and remove them on uninstall.
Callback functions for each installation/uninstallation stage that can be used to trigger more complex install behavior.