Skip to content

Leaderboard Placeholders

Advanced Parkour exposes leaderboard placeholders using the following format:

%advancedparkour_leaderboard:<stat>:<position>:<name|value>%

These placeholders are made up of three main parts:

  • <stat>: The leaderboard ID.
  • <position>: The ranking position, such as 1, 2, or 3.
  • <name|value>: Whether to return the player name or the stored value.

These map directly to the stored statistic keys used by the plugin:

  • games_played
  • completions
  • uncompleted_runs
  • perfect_runs
  • checkpoint_teleports
  • checkpoints_reached

Example:

%advancedparkour_leaderboard:completions:1:name%
%advancedparkour_leaderboard:completions:1:value%

Each ready arena gets its own best-time leaderboard with this pattern:

arena_time_<arena_id>

Example:

%advancedparkour_leaderboard:arena_time_easy:1:name%
%advancedparkour_leaderboard:arena_time_easy:1:value%

For arena time leaderboards, value is formatted as a readable time instead of a raw numeric value.


Each checkpoint in a ready arena also gets a leaderboard ID:

checkpoint_time_<arena_id>_<checkpoint_index>

Example:

%advancedparkour_leaderboard:checkpoint_time_easy_3:1:name%
%advancedparkour_leaderboard:checkpoint_time_easy_3:1:value%

These placeholders are useful for advanced HUDs, training lobbies, or holograms placed near specific sections of a course.