Placeholders
PlaceholderAPI placeholders that StaffHQ exposes for use in scoreboards, TAB plugins, chat formatters, and more.
When PlaceholderAPI is installed on the same server as the StaffHQ plugin, StaffHQ registers a set of placeholders under the staffhq identifier. These placeholders update automatically and can be used in any plugin that supports PAPI.
Server placeholders
These placeholders reflect the current state of the server.
%staffhq_staff_online%Number of staff members currently online.
Example output: 3
%staffhq_server_tps%Current server TPS rounded to one decimal place.
Example output: 19.8
%staffhq_server_uptime_human%Human-readable server uptime since last restart.
Example output: 3h 42m
%staffhq_server_uptime_seconds%Raw uptime in whole seconds.
Example output: 13320
%staffhq_version%StaffHQ plugin version currently running.
Example output: 2.1.4
Player placeholders
These placeholders are evaluated per player and reflect data about that individual.
%staffhq_is_staff%true if the player belongs to a tracked staff group, false otherwise.
Example output: true
%staffhq_staff_role%The highest staff group the player belongs to, as defined in config.yml. Empty string if the player is not staff.
Example output: moderator
%staffhq_session_duration%How long the player has been online in this session, in human-readable format.
Example output: 1h 12m
%staffhq_punishment_count%Total number of punishments on record for the player.
Example output: 2
Usage examples
Use these placeholders in plugins like TAB, Featherboard, CMI, or DeluxeChat.
TAB plugin scoreboard
&7Staff online: &a%staffhq_staff_online% &7Server TPS: &a%staffhq_server_tps% &7Uptime: &f%staffhq_server_uptime_human%
DeluxeChat prefix for staff
condition: '%staffhq_is_staff% == true' prefix: '&c[%staffhq_staff_role%] '