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).