63 lines
2.7 KiB
ReStructuredText
63 lines
2.7 KiB
ReStructuredText
channel-safely
|
|
==============
|
|
|
|
.. dfhack-tool::
|
|
:summary: Auto-manage channel designations to keep dwarves safe
|
|
:tags: fort auto
|
|
|
|
Multi-level channel projects can be dangerous, and managing the safety of your
|
|
dwarves throughout the completion of such projects can be difficult and time
|
|
consuming. This plugin keeps your dwarves safe (while channeling) so you don't
|
|
have to. Now you can focus on designing your dwarven cities with the deep chasms
|
|
they were meant to have.
|
|
|
|
Usage
|
|
-----
|
|
|
|
::
|
|
enable channel-safely
|
|
channel-safely set <setting> <value>
|
|
channel-safely enable|disable <feature>
|
|
channel-safely run once
|
|
|
|
When enabled the map will be scanned for channel designations which will be grouped
|
|
together based on adjacency and z-level. These groups will then be analyzed for safety
|
|
and designations deemed unsafe will be put into :wiki:`Marker Mode <Designations_menu#Marker_Mode>`.
|
|
Each time a channel designation is completed its group status is checked, and if the group
|
|
is complete pending groups below are made active again.
|
|
|
|
Examples
|
|
--------
|
|
|
|
``channel-safely``
|
|
The plugin reports its configured status.
|
|
|
|
``channel-safely run once``
|
|
Runs the safety procedures once. You can use this if you prefer initiating scans manually.
|
|
|
|
``channel-safely disable require-vision``
|
|
Allows the plugin to read all tiles, including the ones your dwarves know nothing about.
|
|
|
|
``channel-safely enable monitor-active``
|
|
Enables monitoring active channel digging jobs. Meaning that if another unit it present
|
|
or the tile below becomes open space the job will be paused or canceled (respectively).
|
|
|
|
``channel-safely set ignore-threshold 3``
|
|
Configures the plugin to ignore designations equal to or above priority 3 designations.
|
|
|
|
Features
|
|
--------
|
|
:monitor-active: Toggle whether to monitor the conditions of active digs. (default: disabled)
|
|
:require-vision: Toggle whether the dwarves need vision of a tile before channeling to it can be deemed unsafe. (default: enabled)
|
|
:insta-dig: Toggle whether to use insta-digging on unreachable designations. (default: disabled)
|
|
|
|
Settings
|
|
--------
|
|
:refresh-freq: The rate at which full refreshes are performed.
|
|
This can be expensive if you're undertaking many mega projects. (default:600, twice a day)
|
|
:monitor-freq: The rate at which active jobs are monitored.
|
|
todo: this can have a massive impact? (default:10)
|
|
:ignore-threshold: Sets the priority threshold below which designations are processed. You can set to 1 or 0 to
|
|
effectively disable the scanning. (default: 7)
|
|
:fall-threshold: Sets the fall threshold beyond which is considered unsafe. (default: 1)
|