2022-07-10 00:01:46 -06:00
|
|
|
fix-unit-occupancy
|
|
|
|
|
==================
|
2022-07-25 11:23:26 -06:00
|
|
|
|
2022-08-09 23:37:24 -06:00
|
|
|
.. dfhack-tool::
|
|
|
|
|
:summary: Fix phantom unit occupancy issues.
|
2023-01-10 23:26:12 -07:00
|
|
|
:tags: untested fort bugfix map
|
2022-08-09 23:37:24 -06:00
|
|
|
|
|
|
|
|
If you see "unit blocking tile" messages that you can't account for
|
|
|
|
|
(:bug:`3499`), this tool can help.
|
2022-07-25 11:23:26 -06:00
|
|
|
|
2022-08-17 23:42:02 -06:00
|
|
|
Usage
|
|
|
|
|
-----
|
|
|
|
|
|
|
|
|
|
::
|
2022-07-25 11:23:26 -06:00
|
|
|
|
|
|
|
|
enable fix-unit-occupancy
|
|
|
|
|
fix-unit-occupancy [here] [-n]
|
|
|
|
|
fix-unit-occupancy interval <num_ticks>
|
|
|
|
|
|
|
|
|
|
When run without arguments (or with just the ``here`` or ``-n`` parameters),
|
2022-09-28 15:49:03 -06:00
|
|
|
the fix just runs once. You can also have it run periodically by enabling the
|
2022-07-25 11:23:26 -06:00
|
|
|
plugin.
|
|
|
|
|
|
|
|
|
|
Examples
|
|
|
|
|
--------
|
|
|
|
|
|
|
|
|
|
``fix-unit-occupancy``
|
|
|
|
|
Run once and fix all occupancy issues on the map.
|
|
|
|
|
``fix-unit-occupancy -n``
|
|
|
|
|
Report on, but do not fix, all occupancy issues on the map.
|
|
|
|
|
|
|
|
|
|
Options
|
|
|
|
|
-------
|
|
|
|
|
|
|
|
|
|
``here``
|
|
|
|
|
Only operate on the tile at the cursor.
|
|
|
|
|
``-n``
|
2022-09-28 15:49:03 -06:00
|
|
|
Report issues, but do not write any changes to the map.
|
2022-07-25 11:23:26 -06:00
|
|
|
``interval <num_ticks>``
|
|
|
|
|
Set how often the plugin will check for and fix issues when it is enabled.
|
|
|
|
|
The default is 1200 ticks, or 1 game day.
|
