|
| 1 | +logistics |
| 2 | +========= |
| 3 | + |
| 4 | +.. dfhack-tool:: |
| 5 | + :summary: Automatically mark and route items in monitored stockpiles. |
| 6 | + :tags: fort productivity items stockpiles |
| 7 | + :no-command: |
| 8 | + |
| 9 | +Commands act upon the stockpile selected in the UI unless another stockpile |
| 10 | +identifier is specified on the commandline. |
| 11 | + |
| 12 | +When the plugin is enabled, it checks stockpiles marked with automelt, |
| 13 | +autotrade, and/or autodump features twice every in-game day, and will mark valid |
| 14 | +items in those stockpiles for melting, trading, and/or dumping, respectively. |
| 15 | +Note that items will only be marked for trading if a caravan is approaching or |
| 16 | +is already at the trade depot. |
| 17 | + |
| 18 | +Please see `gui/logistics` for the interactive status and configuration dialog. |
| 19 | + |
| 20 | +Usage |
| 21 | +----- |
| 22 | + |
| 23 | +:: |
| 24 | + |
| 25 | + enable logistics |
| 26 | + logistics [status] |
| 27 | + logistics now |
| 28 | + logistics add [melt] [trade] [dump] [<options>] |
| 29 | + logistics clear [all] [<options>] |
| 30 | + |
| 31 | +Examples |
| 32 | +-------- |
| 33 | + |
| 34 | +``logistics`` |
| 35 | + Print a summary of all your stockpiles, their ``logistics`` configuration, |
| 36 | + and the number of items that are designated (or can be designated) by each |
| 37 | + of the ``logistics`` processors. |
| 38 | + |
| 39 | +``logistics now`` |
| 40 | + Designate items in monitored stockpiles according to the current |
| 41 | + configuration. This works regardless of whether ``logistics`` is currently |
| 42 | + enabled. |
| 43 | + |
| 44 | +``logistics add melt`` |
| 45 | + Register the currently selected stockpile for automelting. Meltable items |
| 46 | + that are brought to this stockpile will be designated for melting. |
| 47 | + |
| 48 | +``logistics add melt trade -s goblinite`` |
| 49 | + Register the stockpile(s) named "goblinite" for automatic melting and |
| 50 | + automatic trading. Items will be marked for melting, but any items still in |
| 51 | + the stockpile when a caravan shows up will be brought to the trade depot |
| 52 | + for trading. |
| 53 | + |
| 54 | +``logistics clear`` |
| 55 | + Unregisters the currently selected stockpile from any monitoring. Any |
| 56 | + currently designated items will remain designated. |
| 57 | + |
| 58 | +``logistics clear -s 12,15,goblinite`` |
| 59 | + Unregisters the stockpiles with stockpile numbers 12 and 15, along with any |
| 60 | + stockpiles named "goblinite", from any monitoring. |
| 61 | + |
| 62 | +``logistics clear all`` |
| 63 | + Unregister all stockpiles from any monitoring. |
| 64 | + |
| 65 | +Options |
| 66 | +------- |
| 67 | + |
| 68 | +``-s``, ``--stockpile <name or number>[,<name or number>...]`` |
| 69 | + Causes the command to act upon stockpiles with the given names or numbers |
| 70 | + instead of the stockpile that is currently selected in the UI. Note that |
| 71 | + the numbers are the stockpile numbers, not the building ids. |
0 commit comments