Skip to content

Online rewards

RageOfFire edited this page Sep 6, 2026 · 1 revision

Online rewards

Online rewards are earned by playing continuously within a single session and are granted automatically the instant the time requirement is reached - there's no click-to-claim step, since the player is already online to receive it.

Example

online-rewards:
  dedicated:
    permission: ""
    time: "5h"
    message: "&6You're a dedicated player! Enjoy this reward."
    execute: 'CONSOLE'
    commands:
      - "give %player% diamond 1"

The keys work exactly the same as offline rewards - permission, time, message, execute, commands - the only difference is what time measures and how it's claimed.

How it works

  • time is measured from the moment the player joins - it's real elapsed wall-clock time in their current session, not cumulative playtime across all sessions.
  • The plugin schedules the reward to fire at the exact real-world moment the player crosses the threshold, rather than checking on a periodic timer - so a 5h reward fires right at 5 hours, not up to a minute (or more) late.
  • If a player disconnects before reaching the threshold, that session's progress is lost - it starts over from zero the next time they join. Reward design tip: keep online-reward time values reasonably short (minutes to a few hours) since they reset on disconnect, unlike offline and login rewards which persist between sessions.
  • Once granted, the same reward won't fire again until its own time has elapsed again from the point it was last granted.

Turning it off

Set online-rewards-enabled: false in config.yml to disable the entire online-rewards section without deleting it.

Clone this wiki locally