Message placeholders are a core functionality of CFTools Cloud allowing you to add dynamic values to all messages sent.
To use message placeholders you open the configuration of any module that supports them and type {{ PLACEHOLDER}}
in place of where a dynamic value should be.
Below you will find a list with all available message placeholders. Note, some are only available in certain games or if you run additional plugins.
Placeholder | Description | Games | Availability | Note |
map | Server map | All | Server & Player | |
servername | Server name | All | Server & Player | |
game | Game name | All | Server & Player | eg. DayZ, Rust, ArmA 3 etc. |
players | Current player count | All | Server & Player | |
slots | Available server slots | All | Server & Player | |
version | Server version / Game version | DayZ | Server & Player | |
gametime | Current In-Game time | DayZ | Server & Player | |
queue | Server queue size | DayZ, Rust | Server & Player | |
timeacl | Server time acceleration | DayZ | Server & Player | Global time acceleration |
nighttimeacl | Night time acceleration | DayZ | Server & Player | |
max_ping | Maximum allowed ping | All | Server & Player | |
next_restart | Next restart | All | Server & Player | Full date time in HH:MM DD.MM.YYYY format |
next_restart_in | Relative time to next restart | All | Server & Player | Mixed time formats, eg. 1 hour, 17 minutes |
uptime | Relative time of current server uptime | All | Server & Player | Mixed time formats, eg. 1 hour, 17 minutes |
minutes | Relative time to next shutdown | All | Scheduled restart | Only available for Scheduler based kick jobs |
delta | Relative time to next shutdown related kick all | All | Scheduled restart | Only available for Scheduler based kick jobs |
player_slot | Player slot index | DayZ | Player | |
player_name | Player name | All | Player | |
player_guid | Player BattlEye GUID | DayZ | Player | |
player_steam64 | Player Steam64 | All | Player | |
player_ipv4 | Player IPv4 | All | Player | GDPR restrictions may apply, |
player_country | Player country | All | Player | Full country ISO name |
player_country_code | Player country code | All | Player | ISO country code |
player_admin_status | Player admin status | All | Player | Yes or No |
player_ping | Player ping to the server | All | Player | |
player_playtime | Player playtime on server | All | Player | Mixed time formats, eg. 1 hour, 17 minutes |
persona_game | Latest used in-game player name | All | WebHooks | Currently only for ban.add |
persona_steam | Latest available Steam name | All | WebHooks | Currently only for ban.add |
kills | Player kill count (total) | DayZ | Player | Requires GameLabs plugin |
deaths | Player death count (total) | DayZ | Player | Requires GameLabs plugin |
kdratio | KD Ratio (total) | DayZ | Player | Requires GameLabs plugin |
session_kills | Player kill count (current play session) | DayZ | Player | Requires GameLabs plugin |
session_deaths | Player death count (current play session) | DayZ | Player | Requires GameLabs plugin |
session_kdratio | KD Ratio (current play session) | DayZ | Player | Requires GameLabs plugin |
storage_kills | Player kill count (only storage, no live count) | DayZ | Player | Requires GameLabs plugin |
storage_deaths | Player death count (only storage, no live count) | DayZ | Player | Requires GameLabs plugin |
storage_kdratio | KD Ratio (only storage, no live count) | DayZ | Player | Requires GameLabs plugin |
murderer | Name of murderer | DayZ | Kill Event | Requires GameLabs plugin |
victim | Name of victim | DayZ | Kill Event | Requires GameLabs plugin |
weapon | Weapon name | DayZ | Kill Event | Requires GameLabs plugin |
distance | Distance in meters without unit declaration | DayZ | Kill Event | Requires GameLabs plugin |
player_position | Victim position in default format | DayZ | Interaction Events | Requires GameLabs plugin |
victim_position | Victim position in default format | DayZ | Kill Event | Requires GameLabs plugin |
victim_position_x | Victim position X value | DayZ | Kill Event | Requires GameLabs plugin |
victim_position_y | Victim position Y value | DayZ | Kill Event | Requires GameLabs plugin |
victim_position_z | Victim position Z value | DayZ | Kill Event | Requires GameLabs plugin |
murderer_position | Murderer position in default format | DayZ | Kill Event | Requires GameLabs plugin |
murderer_position_x | Murderer position X value | DayZ | Kill Event | Requires GameLabs plugin |
murderer_position_y | Murderer position Y value | DayZ | Kill Event | Requires GameLabs plugin |
murderer_position_z | Murderer position Z value | DayZ | Kill Event | Requires GameLabs plugin |
Event | Target | Message |
Kill-feed | Server | {{ victim }} has been killed by {{ murderer }} using {{ weapon }} ({{ distance }}m) |
Welcome message | Player | Hello, {{ player_name }}. Welcome to {{ servername }}! |