RoodyDonations v1.0.0 is outSee what’s new →
RoodyTops
v1.0.0 Paper 1.20.4+ Free
Guides · 10 / 12

Placeholders and API

With PlaceholderAPI. <period> is optional (all time when left out): all, daily, weekly, monthly, yearly.

Placeholder What it gives
%roodytops_<top>_<period>_name_<n>% The name in position n (--- when nobody).
%roodytops_<top>_<period>_value_<n>% · _raw_<n> · _uuid_<n> Its value formatted · as a number · its UUID.
%roodytops_<top>_<period>_position% The player's position (- when not in it).
%roodytops_<top>_<period>_me% · _me_raw The player's value.
%roodytops_<top>_<period>_ends% Time left of the period.
%roodytops_<top>_<period>_size% Players in the top.
%roodytops_<top>_<period>_last_name_<n>% · _last_value_<n> Winners of the last finished period.
%roodytops_<top>_display% The top's name.

Examples: %roodytops_kills_name_1%, %roodytops_playtime_weekly_position%, %roodytops_money_value_3%.

API (dev.roody.roodytops.api): RoodyTopsAPI.position(top, period, uuid), value(...), range(top, period, from, to), tops(), format(top, value). Events: TopPeriodEndEvent (its rewards can be stopped) and TopRewardEvent (cancellable, its actions can be changed).