dfhack/docs/plugins/stockpiles.rst

43 lines
1.5 KiB
ReStructuredText

.. _stocksettings:
stockpiles
==========
2022-07-31 14:29:53 -06:00
Tags:
:dfhack-keybind:`copystock`
:dfhack-keybind:`savestock`
:dfhack-keybind:`loadstock`
2022-07-31 14:29:53 -06:00
Import and export stockpile settings. When the plugin is enabled, the :kbd:`q`
menu of each stockpile will have an option for saving or loading the stockpile
settings. See `gui/stockpiles` for an in-game interface.
2022-07-31 14:29:53 -06:00
Usage:
2022-07-31 14:29:53 -06:00
``enable stockpiles``
Add a hotkey that you can hit to easily save and load settings from
stockpiles selected in :kbd:`q` mode.
``copystock``
Copies the parameters of the currently highlighted stockpile to the custom
stockpile settings and switches to custom stockpile placement mode,
effectively allowing you to copy/paste stockpiles easily.
``savestock <filename>``
Saves the currently highlighted stockpile's settings to a file in your
Dwarf Fortress folder. This file can be used to copy settings between game
saves or players.
``loadstock <filename>``
Loads a saved stockpile settings file and applies it to the currently
selected stockpile.
2022-07-31 14:29:53 -06:00
Filenames with spaces are not supported. Generated materials, divine metals,
etc. are not saved as they are different in every world.
2022-07-31 14:29:53 -06:00
Examples
--------
``savestock food_settings.dfstock``
Export the stockpile settings for the stockpile currently selected in
:kbd:`q` mode to a file named ``food_settings.dfstock``.
``loadstock food_settings.dfstock``
Set the selected stockpile settings to those saved in the
``food_settings.dfstock`` file.