Run a command if the current fort entity matches a given ID.

This script can only be called when a fort is loaded. To run it immediately when a matching fort is loaded, call it from a registered dfhack.onStateChange state change handler. See the DFHack modding guide for an example of how to set up a state change handler.


modtools/if-entity --id <entity id> --cmd [ <command> ]


--id <entity id>

Specify the entity ID to match.

--cmd [ <command> ]

Specify the command to be run when the given id is matched.


modtools/if-entity --id FOREST --cmd [ lua "print('Dirty hippies.')" ]

Print a message if you load an elf fort, but not a dwarf, human, etc. fort.