Rewards

Reward the players who actually play. Active playtime fills a trail of milestones, and each level unlocks prizes defined by the server. Built-in anti-AFK checks make sure idle characters, macros and repetitive actions do not count.

Features

• Playtime levels: each level unlocks after a total of active minutes and grants one or more items.
• Milestone trail: a window in the Vikings Ascension style shows about six milestones around your current level, with arrows to browse ahead or back. Works with 200+ levels.
• Boss locks: any level can require a boss key. Works with BiomeLock private keys, or with world keys when BiomeLock is not installed.
• Cycles: optionally restart from level 1 after the last level is claimed. Boss locks do not apply from cycle 2 on.
• Safe delivery: rewards are only claimed when they fit in the inventory, and a claimed reward is delivered again after a disconnect.
• Anti-AFK:
  • Time stops after a few minutes without input.
  • Each minute must meet a set of activity criteria (movement, camera, action variety, target variety). Holding attack on the same rock does not count.
  • The server checks the real position and stops counting for players standing still on the same spot.
  • Periodic presence check: a "Are you still there?" prompt appears at random intervals inside the Rewards window, with the answer button placed at a random spot. Without an answer before the deadline, time is paused until the player answers.
  • Being carried by a ship does not count as input; steering and sails do.
• Access button: a draggable icon (Ctrl + drag) with a badge showing how many rewards are ready, or a pulsing "!" when a presence check is waiting.
• Server-authoritative: levels and progress live only on the server and are synced to every player.

Installation

1. Install BepInEx and Rewards on the dedicated server and on all clients. Place Rewards.dll in BepInEx/plugins.
2. Start the server once. The mod creates the folders below.
3. Add your level files to BepInEx/config/Rewards/Levels/. No example file is generated.

BepInEx/config/
  radamanto.Rewards.cfg     options (synced with the server)
  Rewards/
    Levels/                 any number of .cfg files, any name, subfolders allowed
    SavedData/Rewards.db    player progress (server only)

Rewards is made for dedicated servers. Playing as host or in single player does not count time.

Levels

Every .cfg inside Levels/ is read in alphabetical order and merged. Each section is a level number. If the same level appears in two files, the first one wins and the log names the file.

[1]
Minutes = 30
Items = Coins:50

[2]
Minutes = 60
Items = Coins:100, MeadHealthMedium:3

[3]
Minutes = 120
Items = SilverOre:20
RequiredKey = defeated_bonemass

Key	Description
Minutes	Total active minutes in the current cycle needed to unlock the level.
Items	One or more Prefab:Amount entries, separated by commas.
RequiredKey	Optional boss key. Without it, the level has no lock.

Levels with an unknown item or an invalid value are skipped with a warning in the log. Files reload automatically when changed.

Admin commands

Run in the F5 console. Admins only (server adminlist.txt).

Command	Description
rewards_reload	Reloads all level files.
rewards_add <player> <minutes>	Adds (or removes, with a negative value) active minutes to an online player.
rewards_reset <player>	Resets an online player's time, claimed levels and cycle.

Compatibility

• BiomeLock (optional): boss locks follow its private or world keys.