128 lines
3.7 KiB
ReStructuredText
128 lines
3.7 KiB
ReStructuredText
.. _digv:
|
|
.. _digtype:
|
|
|
|
dig
|
|
===
|
|
Tags:
|
|
:dfhack-keybind:`digv`
|
|
:dfhack-keybind:`digvx`
|
|
:dfhack-keybind:`digl`
|
|
:dfhack-keybind:`diglx`
|
|
:dfhack-keybind:`digcircle`
|
|
:dfhack-keybind:`digtype`
|
|
:dfhack-keybind:`digexp`
|
|
|
|
Make complicated dig patterns easy.
|
|
|
|
Usage:
|
|
|
|
``digv [x] [-p<number>]``
|
|
Designate all of the selected vein for digging.
|
|
``digvx [-p<number>]``
|
|
Also cross z-levels, digging stairs as needed. Alias for ``digv x``.
|
|
``digl [x] [undo] [-p<number>]``
|
|
Like ``digv``, for layer stone. If ``undo`` is specified, removes the
|
|
layer designation instead (for if you accidentally set 50 levels at once).
|
|
``diglx [-p<number>]``
|
|
Also cross z-levels, digging stairs as needed. Alias for ``digl x``.
|
|
``digcircle [<diameter>] [<solidity>] [<action>] [<designation>] [-p<number>]``
|
|
Designate circles. The diameter is the number of tiles across the center of
|
|
the circle that you want to dig. See the `digcircle`_ section below for an
|
|
explanation of the options.
|
|
``digtype [<designation>]
|
|
For every tile on the map of the same vein type as the selected tile,
|
|
this command designates it to have the same designation as the
|
|
selected tile. If the selected tile has no designation, they will be
|
|
dig designated.
|
|
|
|
``digexp [<pattern>] [<filter>]
|
|
|
|
.. note::
|
|
|
|
All commands implemented by the `dig` plugin (listed by ``ls dig``) support
|
|
specifying the designation priority with ``-p#``, ``-p #``, or ``p=#``,
|
|
where ``#`` is a number from 1 to 7. If a priority is not specified, the
|
|
priority selected in-game is used as the default.
|
|
|
|
digcircle
|
|
=========
|
|
|
|
Designate filled or hollow circles. If neither ``hollow`` nor ``filled``
|
|
is specified, the default is ``hollow``. The diameter is the number of tiles
|
|
Action:
|
|
|
|
:set: Set designation (default)
|
|
:unset: Unset current designation
|
|
:invert: Invert designations already present
|
|
|
|
Designation types:
|
|
|
|
:dig: Normal digging designation (default)
|
|
:ramp: Ramp digging
|
|
:ustair: Staircase up
|
|
:dstair: Staircase down
|
|
:xstair: Staircase up/down
|
|
:chan: Dig channel
|
|
|
|
After you have set the options, the command called with no options
|
|
repeats with the last selected parameters.
|
|
|
|
Examples:
|
|
|
|
``digcircle filled 3``
|
|
Dig a filled circle with diameter = 3.
|
|
``digcircle``
|
|
Do it again.
|
|
|
|
digtype
|
|
=======
|
|
For every tile on the map of the same vein type as the selected tile,
|
|
this command designates it to have the same designation as the
|
|
selected tile. If the selected tile has no designation, they will be
|
|
dig designated.
|
|
If an argument is given, the designation of the selected tile is
|
|
ignored, and all appropriate tiles are set to the specified
|
|
designation.
|
|
|
|
Options:
|
|
|
|
:dig:
|
|
:channel:
|
|
:ramp:
|
|
:updown: up/down stairs
|
|
:up: up stairs
|
|
:down: down stairs
|
|
:clear: clear designation
|
|
|
|
digexp
|
|
======
|
|
This command is for :wiki:`exploratory mining <Exploratory_mining>`.
|
|
|
|
There are two variables that can be set: pattern and filter.
|
|
|
|
Patterns:
|
|
|
|
:diag5: diagonals separated by 5 tiles
|
|
:diag5r: diag5 rotated 90 degrees
|
|
:ladder: A 'ladder' pattern
|
|
:ladderr: ladder rotated 90 degrees
|
|
:clear: Just remove all dig designations
|
|
:cross: A cross, exactly in the middle of the map.
|
|
|
|
Filters:
|
|
|
|
:all: designate whole z-level
|
|
:hidden: designate only hidden tiles of z-level (default)
|
|
:designated: Take current designation and apply pattern to it.
|
|
|
|
After you have a pattern set, you can use ``expdig`` to apply it again.
|
|
|
|
Examples:
|
|
|
|
``expdig diag5 hidden``
|
|
Designate the diagonal 5 patter over all hidden tiles
|
|
``expdig``
|
|
Apply last used pattern and filter
|
|
``expdig ladder designated``
|
|
Take current designations and replace them with the ladder pattern
|