modtools/if-entity¶
Tags: dev
Command: modtools/if-entity
Run DFHack commands based on current civ id.
Run a command if the current entity matches a given ID.
To use this script effectively it needs to be called from “raw/onload.init”. Calling this from the main dfhack.init file will do nothing, as no world has been loaded yet.
Usage:
id
:Specify the entity ID to match
cmd [ commandStrs ]
:Specify the command to be run if the current entity matches the entity given via -id
All arguments are required.
Example:
Print a message if you load an elf fort, but not a dwarf, human, etc. fort:
if-entity -id "FOREST" -cmd [ lua "print('Dirty hippies.')" ]