Configuration
How placeholders work in Minecraft plugins
What placeholders are, how PlaceholderAPI connects plugins, and how to use sofyCore placeholders in scoreboards, menus and other plugins.
- Placeholders
- PlaceholderAPI
A placeholder is a token such as %player_name% that a plugin replaces with a value when it shows a text. They let one plugin display data that another plugin owns.
PlaceholderAPI
PlaceholderAPI is a plugin that acts as a shared registry: plugins register "expansions" with an identifier, and any plugin that supports PlaceholderAPI can resolve %identifier_key% tokens from every expansion.
sofyCore placeholders
sofyCore registers the sofycore identifier, so its values are available as %sofycore_<key>% in any PlaceholderAPI-compatible plugin:
| Example | Shows |
|---|---|
%sofycore_rank_prefix% | Prefix of the visible rank |
%sofycore_tag% | Selected tag |
%sofycore_playtime% | Network playtime |
%sofycore_vippoints% | VIP points balance |
%sofycore_online_network% | Players in the whole network |
Inside sofyCore's own scoreboard, menus and staff hotbar, these placeholders work without PlaceholderAPI. When PlaceholderAPI is installed, those texts can also use placeholders from other plugins.
Good practices
- Placeholders resolve when the text is shown, so prefer values that are cheap to compute.
- sofyCore placeholders read memory only and return an empty value while data loads.
See the complete list in Placeholders.