Skip to content

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

PlaceholderDescription
%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

PlaceholderDescription
%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

PlaceholderDescription
%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

PlaceholderDescription
%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 onlytrue/false for a given server.
%sofycore_server_<id>_players%PlaceholderAPI onlyPlayers of a given server (also _max, _tps, _version).
%sofycore_vanished%true/false: whether the player is vanished.

Moderation

PlaceholderDescription
%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

PlaceholderDescription
%sofycore_vippoints%VIP points balance of the connected player; empty while loading.Example: 1000

Staff

PlaceholderDescription
%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.