Skip to content

liquids.rst

Latest commit

 

History

History
84 lines (62 loc) · 2.52 KB

liquids.rst

File metadata and controls

84 lines (62 loc) · 2.52 KB
Raw

liquids

.. dfhack-tool::
    :summary: Place magma, water or obsidian.
    :tags: adventure fort armok map


.. dfhack-command:: liquids-here
    :summary: Spawn liquids on the selected tile.

Place magma, water or obsidian. See gui/liquids for an in-game interface for this functionality.

Also, if you only want to add or remove water or magma from a single tile, the source script may be easier to use.

Usage

liquids
Start the interactive terminal settings interpreter. This command must be called from the DFHack terminal and not from any in-game interface.
liquids-here
Run the liquid spawner with the current/last settings made in liquids (if no settings in liquids were made, then it paints a point of 7/7 magma by default). This command is intended to be used as keybinding, and it requires an active in-game cursor.

Warning

Spawning and deleting liquids can mess up pathing data and temperatures (creating heat traps). You've been warned.

Interactive interpreter

The interpreter replaces the normal dfhack command line and can't be used from a hotkey. Settings will be remembered as long as dfhack runs. It is intended for use in combination with the command liquids-here (which can be bound to a hotkey).

You can enter the following commands at the prompt.

Misc commands:

q:quit
help, ?:print this list of commands
<empty line>:put liquid

Modes:

m:switch to magma
w:switch to water
o:make obsidian wall instead
of:make obsidian floors
rs:make a river source
f:flow bits only
wclean:remove salt and stagnant flags from tiles

Set-Modes and flow properties (only for magma/water):

s+:only add mode
s.:set mode
s-:only remove mode
f+:make the spawned liquid flow
f.:don't change flow state (read state in flow mode)
f-:make the spawned liquid static

Permaflow (only for water):

pf.:don't change permaflow state
pf-:make the spawned liquid static
pf[NS][EW]:make the spawned liquid permanently flow
0-7:set liquid amount

Brush size and shape:

p, point:Single tile
r, range:Block with cursor at bottom north-west (any place, any size)
block:DF map block with cursor in it (regular spaced 16x16x1 blocks)
column:Column from cursor, up through free space
flood:Flood-fill water tiles from cursor (only makes sense with wclean)