🧩Placeholders
CrownPunishments provides a robust system of placeholders to customize your messages, menus, and integrate with other plugins.
🔌 PlaceholderAPI (External)
These placeholders can be used in other plugins (like TAB, Scoreboard, Holograms, or chat formatting plugins) to display Crown data.
%crown_is_banned%
Returns true or false if the player is banned.
true
%crown_ban_time_left%
Time remaining on active ban.
2d 4h or N/A
%crown_is_muted%
Returns true or false if the player is muted.
true
%crown_mute_time_left%
Time remaining on active mute.
30m
%crown_is_softbanned%
Returns true or false if softbanned.
false
%crown_softban_time_left%
Time remaining on active softban.
N/A
%crown_is_warned%
Returns true or false if the player has an active warning.
true
%crown_warn_time_left%
Time remaining on the active warning.
5d
%crown_is_frozen%
Returns true or false if the player is currently frozen.
false
%crown_freeze_time_left%
Time remaining on the freeze (usually permanent).
Permanent
%crown_<type>_count%
Total count of a specific punishment type. Replace <type> with: ban, mute, kick, warn, softban, freeze.
3
%crown_punish_count%
Total sum of all punishments on the player's record.
12
⚙️ Internal Placeholders
These placeholders are only compatible within Crown's configuration files (messages.yml, punish_info.yml, menus, etc.).
Global & Player Info
Used in profiles, menus, and general messages.
{prefix}
The plugin prefix defined in config.yml.
Global
{player}
The name of the executor (admin/mod).
Global
{target}
The name of the target player.
Global
{target_uuid}
The UUID of the target player.
Global
{target_ip}
Target's IP address (masked if configured).
Menus
{target_online}
Display symbol (✔/❌) for online status.
Menus
{target_world}
The world the target is currently in.
Menus
{target_coords}
X, Y, Z coordinates of the target.
Menus
{xp_level}
Target's XP Level.
Menus / Check
{play_time}
Target's total play time (formatted).
Menus
{health}
Target's health (e.g., 18.5/20.0).
Menus / Check
{ping}
Target's latency in ms.
Check
{gamemode}
Target's GameMode.
Check
Punishment Context
Used in punishment messages, broadcast hooks, and history menus.
{reason}
The reason provided for the punishment.
{time} / {duration}
The formatted duration string (e.g., "1 hour").
{time_left}
Time remaining until expiration.
{punisher}
Name of the staff member who applied the punishment.
{punishment_id}
The unique 6-character ID (e.g., #AB12CD).
{type}
Type of punishment (Ban, Mute, etc.).
{status}
Status of punishment (Active, Expired, Removed).
{method}
Method used: IP or Local.
{date}
Date/Time the punishment was applied.
Last updated