# dig-now

Tags: fort | armok | map

Command: `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.