Playtime Rewards

Playtime is counted per player while they are online and is stored with the world, so the total survives restarts. Milestone rewards are given once when a player reaches a set number of hours. Repeating rewards fire again every N hours. A reward can list several items, a set of console commands, or a pool from which the server picks one random entry. Reward items may carry optional NBT data.

An optional AFK check pauses the counter when a player stops moving, looks around, breaks or places blocks, or opens a container, and the timer resets after inactivity. Rewards that cannot be delivered because the inventory is full wait in a pending queue until the player makes room and claims them. Chat messages support color codes and placeholders for hours and minutes.

The mod runs on the server alone, so players join without installing anything. It targets Forge with six release versions, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5 and 1.20.6, and the newest file is 1.0.1 for 1.20.6. The code is open source under the MIT License, and each player's data is saved in the world's playerdata folder as a JSON file.