Hooks are a way to add additional behaviour to the scripts. They are basically custom scripts that are called upon specific events. For example one could define a hook which is called on player connects and then send a message in the in-game chat to greet the new player.

All hooks have to executable files in SDTD_BASE/hooks/<name of hook>/<any name>.sh. The folder <name of hook> has to be in exactly the same case as the hook name column in the table below shows it.

If you think a hook for another event could be interesting please create a ticket or contact me.

Currently the following hooks are defined:

Hook name	Called on event	Passed parameters
playerConnect	After a player has connected	Instance name Player ID Entity ID Nickname Steam ID
playerDisconnect	After a player has disconnected
serverPreStart	Before an instance is started	Instance name
serverPostStart	After an instance was started
serverPreStop	Before an instance is stopped
serverPostStop	After an instance was stopped
backup	After a backup was created	Path of new backup folder
chat	After message was sent in the chat	Instance name Message including player name