Reference
Placeholders
Every %sofycore_…% placeholder for ranks, tags, playtime, network status, moderation, VIP points and staff, with examples.
All placeholders use the form %sofycore_<key>%. They work through PlaceholderAPI (optional) and through sofyCore's own registry, which the scoreboard and menus use without PlaceholderAPI. Entries marked "PlaceholderAPI only" are not available in the internal registry.
Ranks & grants
| Placeholder | Description |
|---|---|
%sofycore_rank_ready% | true/false: whether the online rank view is available.Example: true |
%sofycore_rank_id% | Key of the visible rank.Example: vip |
%sofycore_rank_name% | Visible name (label) of the rank.Example: VIP |
%sofycore_rank_prefix% | Prefix with colors adapted to the server. Respects /rankdisplay. |
%sofycore_rank_suffix% | Suffix with adapted colors. |
%sofycore_rank_color% | Name color of the visible rank. |
%sofycore_rank_name_raw% | Original label, with & and RGB codes. |
%sofycore_rank_prefix_raw% | Original prefix, with & and RGB codes. |
%sofycore_rank_suffix_raw% | Original suffix, with & and RGB codes. |
%sofycore_rank_color_raw% | Original name color code. |
%sofycore_rank_weight% | Weight of the visible rank.Example: 10 |
%sofycore_rank_type% | Type of the visible rank.Example: DONATOR |
%sofycore_rank_expires% | Expiry of the main rank (`permanent` if it does not expire). |
%sofycore_rank_expires_seconds% | Seconds until the main rank expires. |
%sofycore_rank_local_prefix% | Prefix of the best local rank (grant with server=<this server>). |
%sofycore_rank_display% | `global` or `local`, from the /rankdisplay preference. |
%sofycore_rank_authority% | Highest real authority, independent of the visible rank.Example: STAFF |
%sofycore_rank_personal_color% | Stored personal color; empty if none was chosen. |
%sofycore_rank_parents% | Parents of the visible rank. |
%sofycore_rank_permission_count% | Effective nodes materialized for Bukkit. |
%sofycore_rank_individual_permission_count% | Number of individual exceptions. |
%sofycore_rank_revision% | Global revision of this view. |
%sofycore_grant_count% | Valid active grants. |
%sofycore_grant_total% | Stored grants, including history. |
%sofycore_grant_ids% | Active grant IDs, comma separated. |
%sofycore_grant_ranks% | Active granted ranks, comma separated. |
%sofycore_grant_next_expiry% | Seconds until the next expiry; 0 if none. |
%sofycore_rank_permission_<node>% | true/false/default for a node in the current view.Example: %sofycore_rank_permission_sofycore.chat.mute% |
%sofycore_grant_rank_<grant-uuid>% | Rank of a grant. |
%sofycore_grant_reason_<grant-uuid>% | Original reason of a grant. |
%sofycore_grant_actor_<grant-uuid>% | Original actor of a grant, or CONSOLE. |
%sofycore_grant_expires_<grant-uuid>% | Estimated real expiry in UTC milliseconds, 0 if permanent. |
%sofycore_grant_active_<grant-uuid>% | Current effective state of a grant. |
Tags
| Placeholder | Description |
|---|---|
%sofycore_tag% | Selected tag with adapted colors, trimmed, with a final reset. |
%sofycore_tag_key% | Selected key, if the tag exists and is allowed. |
%sofycore_tag_color% | Color and format codes at the start of the selected tag. |
Profile & preferences
| Placeholder | Description |
|---|---|
%sofycore_playtime% | Formatted network playtime.Example: 2d 3h 0m 5s |
%sofycore_playtime_seconds% | Playtime in seconds. |
%sofycore_playtime_hours% | Playtime in hours. |
%sofycore_mentions_sound% | true/false: mention sound preference. |
Network & servers
| Placeholder | Description |
|---|---|
%sofycore_online% | Visible players on this server. |
%sofycore_online_max% | Slots of this server. |
%sofycore_online_network% | Visible players in the whole network. |
%sofycore_servers_online% | Servers currently online. |
%sofycore_servers_total% | Known servers. |
%sofycore_server_id% | server.id of this server.Example: server-a4c9d3 |
%sofycore_server_<id>_online%PlaceholderAPI only | true/false for a given server. |
%sofycore_server_<id>_players%PlaceholderAPI only | Players of a given server (also _max, _tps, _version). |
%sofycore_vanished% | true/false: whether the player is vanished. |
Moderation
| Placeholder | Description |
|---|---|
%sofycore_mod_ready% | Moderation module readiness. |
%sofycore_mod_banned% | Whether the player is banned. |
%sofycore_mod_ban_reason% | Reason of the active ban. |
%sofycore_mod_ban_remaining% | Remaining time of the active ban. |
%sofycore_mod_ip_banned% | Whether the player's IP is banned. |
%sofycore_mod_blacklisted% | Whether the player is blacklisted. |
%sofycore_mod_muted% | Whether the player is muted. |
%sofycore_mod_mute_reason% | Reason of the active mute. |
%sofycore_mod_mute_remaining% | Remaining time of the active mute. |
%sofycore_mod_warns_active% | Active warnings. |
%sofycore_mod_report_cooldown% | Remaining report cooldown. |
%sofycore_mod_reports_open% | Open reports. |
%sofycore_mod_reports_pending% | Pending reports. |
%sofycore_mod_reports_reviewing% | Reports under review. |
VIP points
| Placeholder | Description |
|---|---|
%sofycore_vippoints% | VIP points balance of the connected player; empty while loading.Example: 1000 |
Staff
| Placeholder | Description |
|---|---|
%sofycore_staffmode% | true/false: whether staff mode is active. |
Parameterized placeholders
Replace the part in angle brackets: %sofycore_rank_permission_sofycore.chat.mute% returns true, false or default, and %sofycore_server_lobby-1_players% returns the players of lobby-1.