65 lines
2.5 KiB
ReStructuredText
65 lines
2.5 KiB
ReStructuredText
dig-now
|
|
=======
|
|
Tags:
|
|
:dfhack-keybind:`dig-now`
|
|
|
|
:index:`Instantly complete dig designations.
|
|
<dig-now; Instantly complete dig designations.>` This tool will magically
|
|
complete non-marker dig designations, modifying tile shapes and creating
|
|
boulders, ores, and gems as if a miner were doing the mining or engraving. By
|
|
default, the entire map is processed and boulder generation follows standard
|
|
game rules, but the behavior is configurable.
|
|
|
|
Note that no units will get mining or engraving experience for the dug/engraved
|
|
tiles.
|
|
|
|
Trees and roots are not currently handled by this plugin and will be skipped.
|
|
Requests for engravings are also skipped since they would depend on the skill
|
|
and creative choices of individual engravers. Other types of engraving (i.e.
|
|
smoothing and track carving) are handled.
|
|
|
|
Usage::
|
|
|
|
dig-now [<pos> [<pos>]] [<options>]
|
|
|
|
Where the optional ``<pos>`` pair can be used to specify the coordinate bounds
|
|
within which ``dig-now`` will operate. If they are not specified, ``dig-now``
|
|
will scan the entire map. If only one ``<pos>`` is specified, only the tile at
|
|
that coordinate is processed.
|
|
|
|
Any ``<pos>`` parameters can either be an ``<x>,<y>,<z>`` triple (e.g.
|
|
``35,12,150``) or the string ``here``, which means the position of the active
|
|
game cursor should be used. You can use the `position` command to get the
|
|
current cursor position if you need it.
|
|
|
|
Examples
|
|
--------
|
|
|
|
``dig-now``
|
|
Dig designated tiles according to standard game rules.
|
|
``dig-now --clean``
|
|
Dig all designated tiles, but don't generate any boulders, ores, or gems.
|
|
``dig-now --dump here``
|
|
Dig tiles and teleport all generated boulders, ores, and gems to the tile
|
|
under the game cursor.
|
|
|
|
Options
|
|
-------
|
|
|
|
``-c``, ``--clean``
|
|
Don't generate any boulders, ores, or gems. Equivalent to
|
|
``--percentages 0,0,0,0``.
|
|
``-d``, ``--dump <pos>``
|
|
Dump any generated items at the specified coordinates. If the tile at those
|
|
coordinates is open space or is a wall, items will be generated on the
|
|
closest walkable tile below.
|
|
``-e``, ``--everywhere``
|
|
Generate a boulder, ore, or gem for every tile that can produce one.
|
|
Equivalent to ``--percentages 100,100,100,100``.
|
|
``-p``, ``--percentages <layer>,<vein>,<small cluster>,<deep>``
|
|
Set item generation percentages for each of the tile categories. The
|
|
``vein`` category includes both the large oval clusters and the long stringy
|
|
mineral veins. Default is ``25,33,100,100``.
|
|
``-z``, ``--cur-zlevel``
|
|
Restricts the bounds to the currently visible z-level.
|