Skip to content

Placeholders

With PlaceholderAPI installed, xStats adds these. Each is answered from memory, from the last save, so they’re cheap enough for a scoreboard that refreshes every tick.

<stat> is a stat’s id from the config, such as kills or mob_kills. <period> is daily, weekly, monthly or all; leave it out for all time. Only stats with periods: true have daily, weekly and monthly numbers.

Placeholder What it shows
%xstats_<stat>% The player’s all-time value, as players read it: 1,234, 3h 12m, 1.2 km.
%xstats_<stat>_<period>% Their value for a period: %xstats_kills_monthly%.
%xstats_<stat>_raw%, %xstats_<stat>_<period>_raw% The bare number, for plugins that sort or add up: seconds for times, centimetres for distances.
%xstats_rank_<stat>%, %xstats_rank_<stat>_<period>% Their place on the leaderboard, or blank if they’re not on it.
%xstats_top_<stat>_<n>_name% Who’s in place n: %xstats_top_kills_1_name%. Add a period: %xstats_top_kills_monthly_1_name%.
%xstats_top_<stat>_<n>_value%, %xstats_top_<stat>_<n>_raw% Their value, written out or as a bare number.
%xstats_kd% Kills per death, from the kills and deaths stats: 2.50.

Leaderboard placeholders reach as far as leaderboards.size (100 places); past that, they’re blank.

ajLeaderboards works with the _raw placeholders, but xStats’ own top placeholders and boards already give you leaderboards per day, week and month without it.