# spawnunit

Tags: fort | armok | units

Command: `spawnunit`

Create a unit.

This tool allows you to easily spawn a unit of your choice. It is a simplified interface to modtools/create-unit, which this tool uses to actually create the requested unit.

## Usage

    spawnunit [-command] <race> <caste> [<name> [<x> <y> <z>]] [...]

If `-command` is specified, the generated modtools/create-unit command is printed to the terminal instead of being run.

The name and coordinates of the unit are optional. Any further arguments are simply passed on to modtools/create-unit. See documentation for that tool for information on what you can pass through.

To see the full list of races and castes for your world, run the following command:

    dfhack-run devel/query --table df.global.world.raws.creatures.all --search [ creature_id caste_id ] --maxdepth 3 --maxlength 5000

## Examples

`spawnunit GOBLIN MALE`

  Warp in a (male) goblin for your squads to beat on.

`spawnunit JABBERER FEMALE --domesticate`

  Spawn a tame female jabberer for breeding an army!