Skip to content

Placeholders

Rui Pereira edited this page Dec 20, 2025 · 8 revisions

Placeholders

Note

By default, placeholders are processed asynchronously. Some placeholders may not work as expected if they interact with plugins that aren't thread-safe. You can toggle this via the scoreboardTaskAsync option in the main configuration file.

SimpleScore fully supports PlaceholderAPI, allowing you to retrieve and display information from thousands of other plugins in real time or create a set of conditions that players must meet to see a particular scoreboard. You can find a list of placeholders here.

It also supports MiniMessage on modern versions of Paper and Folia that come with Adventure.

Built-in Placeholders

If you prefer to keep things light, SimpleScore includes several internal placeholders:

Placeholder Description
%player_name% The player's username.
%player_displayname% The player's current display name.
%player_uuid% The player's Unique ID (UUID).
%player_level% The player's current XP level.
%player_gamemode% The player's GameMode (Creative, Survival, etc.).
%player_health% The player's health rounded to the nearest integer.
%player_maxhealth% The player's maximum health rounded to the nearest integer.
%player_hearts% The player's health displayed using the "❤" symbol.
%player_ping% The player's current ping in milliseconds.
%player_kills% The player's total kills count.
%player_deaths% The player's total deaths count.
%player_world% The name of the world the player is currently in.
%player_world_online% The number of players in the same world as the player.
%server_online% The total number of players online on the server.
%server_maxplayers% The server's maximum player capacity.

Clone this wiki locally