dfhack/docs/plugins/logistics.rst

75 lines
2.6 KiB
ReStructuredText

logistics
=========
.. dfhack-tool::
:summary: Automatically mark and route items in monitored stockpiles.
2023-06-12 13:28:39 -06:00
:tags: fort auto animals items stockpiles
Commands act upon the stockpile selected in the UI unless another stockpile
identifier is specified on the commandline.
When the plugin is enabled, it checks stockpiles marked with automelt,
2023-06-12 13:28:39 -06:00
autotrade, autodump, and/or autotrain features twice every in-game day, and
will mark valid items/animals in those stockpiles for melting, trading,
2023-06-17 06:40:55 -06:00
dumping, and/or training, respectively.
For autotrade, items will be marked for trading only when a caravan is
approaching or is already at the trade depot. Items (or bins that contain
items) of which a noble has forbidden export will not be marked for trade.
2023-09-01 19:45:50 -06:00
Stockpiles can be registered for ``logistics`` features by toggling the options
in the `stockpiles` overlay that comes up when you select a stockpile in the UI.
Usage
-----
::
enable logistics
logistics [status]
logistics now
2023-06-12 13:28:39 -06:00
logistics add [melt] [trade] [dump] [train] [<options>]
logistics clear [all] [<options>]
Examples
--------
``logistics``
Print a summary of all your stockpiles, their ``logistics`` configuration,
and the number of items that are designated (or can be designated) by each
of the ``logistics`` processors.
``logistics now``
Designate items in monitored stockpiles according to the current
configuration. This works regardless of whether ``logistics`` is currently
enabled.
``logistics add melt``
Register the currently selected stockpile for automelting. Meltable items
that are brought to this stockpile will be designated for melting.
``logistics add melt trade -s goblinite``
Register the stockpile(s) named "goblinite" for automatic melting and
automatic trading. Items will be marked for melting, but any items still in
the stockpile when a caravan shows up will be brought to the trade depot
for trading.
``logistics clear``
Unregisters the currently selected stockpile from any monitoring. Any
currently designated items will remain designated.
``logistics clear -s 12,15,goblinite``
Unregisters the stockpiles with stockpile numbers 12 and 15, along with any
stockpiles named "goblinite", from any monitoring.
``logistics clear all``
Unregister all stockpiles from any monitoring.
Options
-------
``-s``, ``--stockpile <name or number>[,<name or number>...]``
Causes the command to act upon stockpiles with the given names or numbers
instead of the stockpile that is currently selected in the UI. Note that
the numbers are the stockpile numbers, not the building ids.