Placeholders - amnoah/BetterScoreboard GitHub Wiki

BetterScoreboard has 10 built-in placeholders and supports all placeholders in PlaceholderAPI!

Built-in Placeholders

Date Information

%date%

This placeholder will display the current date according to the system's current time. The date format can be set in the configuration under the settings.date-format node. The format will follow the Java SimpleDateFormat pattern, which is documented here.

Here are examples of formats given the time that I'm writing this:

  • "MMM dd yyyy" -> "Aug 05 2024"
  • "EEE dd/MM/yy" -> "Mon 05/08/24"

Player Information

%displayname%

This is the current display name of the player. This may be a nickname set by another plugin.

%gamemode%

This will resolve to a string representing the player's current gamemode.

%health%

This will be an integer representation of the player's current health.

If the player has 0 hearts, this will be 0. If they have 10 hearts, this will be 20.

%ping%

This is the player's current ping in milliseconds as calculated by the server.

%username%

This is the player's actual username. This is not modified by other plugins.

%world%

This will resolve as the name of the player's current world.

Server Information

%maxplayers%

This is an integer representing the maximum amount of players allowed on the server.

%players%

This is an integer representing the current amount of players on the server.

%worldplayers%

This is an integer representing the current amount of players in this player's current world.

PlaceholderAPI Placeholders

On the Spigot/Paper (and forks)/Folia platform, BetterScoreboard includes support for PlaceholderAPI. With the plugin installed, you can install and use placeholders built using it!

To view all PlaceholderAPI placeholders and how to download them, please view their wiki here.