Skip to content

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:

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