# liquids

Tags: adventure | fort | armok | map

Command: `liquids`

Place magma, water or obsidian.

Command: `liquids-here`

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)