Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
Rewards
Reward active playtime! Unlock server-defined prizes level by level, with boss locks, cycles and anti-AFK checks.
| Last updated | 2 days ago |
| Total downloads | 23 |
| Total rating | 0 |
| Categories | AI Generated |
| Dependency string | Radamanto-Rewards-1.0.0 |
| Dependants | 0 other packages depend on this package |
This mod requires the following mods to function
denikson-BepInExPack_Valheim
BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.
Preferred version: 5.4.2351README
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
- Install BepInEx and Rewards on the dedicated server and on all clients. Place
Rewards.dllinBepInEx/plugins. - Start the server once. The mod creates the folders below.
- 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.