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

Periods and rewards

A top counts every period in periods at the same time. A timed period counts what each player gained since it started, and starts again from 0 when it ends: daily at periods.reset-hour, weekly on periods.week-starts, monthly on the 1st, yearly on 1 January, in the time zone of periods.timezone.

When a period ends: its winners go to the history (/tops history <top> <period> and the menu), its rewards are given, and everyone is told the first positions (announce, rewards.announce-top). If the server was off when a period was due, it ends as soon as the server starts.

rewards:
  weekly:
    "1":
      - "give {player} diamond 10"
      - "[broadcast] {prefix}&f{player} &7won the weekly &f{top} &7top!"
    "2-3": ["give {player} diamond 5"]
    "4-10": ["give {player} emerald 5"]
    "*": ["[message] &7Thanks for playing this week!"]

Positions: "1", a range "2-3", "11+" or "*" (everyone in the top). Each line is a console command, or [console] / [player] command, [message] / [broadcast] / [actionbar] text, [title] title;subtitle, [sound] id volume pitch. Placeholders: {player} {uuid} {rank} {value} {value-raw} {top} {top-id} {period} {group}.

Winners who are not online get their rewards the next time they join (rewards.offline: pending), on any server of a network.

/tops end <top> <period> finishes a period now (with rewards); /tops reset <top> <period> starts it again now without rewards.