About TerrainRewards
From ThunderstoreConfigurable ground-drop rewards for mining terrain in Valheim. Updated for Valheim 1.0.
TerrainRewards
Dig the ground. Get rewarded.
TerrainRewards is a configurable Valheim mod that spawns item rewards on the ground when mining and modifying terrain with a pickaxe.
Instead of digging through the world and getting nothing for your effort, TerrainRewards gives you a configurable chance to discover useful resources while you work.
Features
- ⛏️ Earn resources while mining terrain
- 🌱 Rewards spawn naturally on the ground at the digging location
- 🎲 One independent chance roll per configured reward entry
- 📦 Configurable item quantities
- 🛠️ Requires a pickaxe
- ⚙️ Fully configurable through the BepInEx configuration file
- 🌎 Designed to feel like a natural extension of Valheim
- 🖥️ Lightweight and simple
- 🔧 Server-friendly configuration
Requirements
TerrainRewards requires:
- Valheim
- BepInExPack for Valheim
When installed through a compatible mod manager, required dependencies can be installed automatically.
Installation
Thunderstore / r2modman
- Install TerrainRewards through your preferred Thunderstore-compatible mod manager.
- Launch Valheim once.
- TerrainRewards will create its configuration file.
- Adjust the reward settings if desired.
- Restart Valheim after making configuration changes.
Manual Installation
- Install BepInExPack for Valheim.
- Place
TerrainRewards.dllinside:
BepInEx/plugins/TerrainRewards/
- Start Valheim.
- The configuration file will be generated automatically.
Configuration
After launching the game, TerrainRewards creates a BepInEx configuration file.
The reward system uses the following format:
ItemName:Amount:Chance
For example:
Stone:2:25
means:
- Item: Stone
- Amount: 2
- Chance: 25%
So that entry makes one 25% roll each time it is evaluated. If the roll succeeds, 2 Stone spawn on the ground at the digging location.
Multiple Rewards
Multiple items can be configured so each resource has its own quantity and drop chance. Each configured entry receives one independent roll.
Example:
Stone:2:25
Wood:1:15
Coal:1:5
This would configure:
| Resource | Amount | Chance | | -------- | -----: | -----: | | Stone | 2 | 25% | | Wood | 1 | 15% | | Coal | 1 | 5% |
This makes it possible to have common resources appear frequently while making valuable resources much rarer.
Default Setup
TerrainRewards ships with a deliberately simple default configuration:
Stone:2:25
This means each eligible digging operation gets one 25% chance to spawn 2 Stone on the ground.
All biome-specific reward settings are blank by default. Server owners and players can add biome-specific rewards manually if they want a more customized progression.
For example, a custom Black Forest setup could include:
CopperOre:1:3
Flint:1:15
Each entry is rolled independently, and successful rewards spawn on the ground at the digging location.
Pickaxe Requirement
TerrainRewards is designed around actual mining.
Rewards are tied to terrain modification performed using a pickaxe, preventing ordinary movement or unrelated interactions from generating free resources.
Multiplayer
TerrainRewards can be used with multiplayer Valheim worlds.
For the most consistent experience, players and servers should use matching versions and configuration settings. Server owners can leave biome-specific reward lists blank or configure them manually.
Compatibility
TerrainRewards is designed to remain lightweight and focused specifically on terrain reward behavior.
If you discover a conflict with another Valheim mod, please report the mod name, TerrainRewards version, and any relevant BepInEx log messages.
Feedback & Bug Reports
Found a bug?
Please include:
- TerrainRewards version
- Valheim version
- BepInEx version
- Other relevant installed mods
- Steps to reproduce the problem
- Relevant sections of
LogOutput.log
This information makes problems significantly easier to reproduce and fix.
Changelog
v1.2.0
Valheim 1.0 compatibility update.
- Updated TerrainRewards for Valheim 1.0
- Fixed reward notifications after Valheim changed the
Character.MessageAPI - Rebuilt against the current Valheim 1.0 assemblies
- Updated the internal plugin version to match the public release version
- Verified terrain digging detection, biome detection, reward rolls, and ground-drop rewards on Valheim 1.0.7
- Added the official GitHub repository for source code and future development
v1.1.0
Ground-drop update.
- Rewards now spawn on the ground at the digging location instead of being placed directly into the player's inventory
- Changed the default global reward to
Stone:2:25 - Biome-specific reward lists now default to blank
- Each
ItemName:Amount:Chanceentry now performs one chance roll and spawns the full configured amount on success - Added valid stack splitting for larger ground-drop quantities
- Updated configuration documentation and examples
v1.0.0
Initial public release.
- Added configurable terrain mining rewards
- Added configurable reward quantities
- Added per-item percentage chances
- Added pickaxe requirement
- Added BepInEx configuration support
Source Code & Bug Reports
TerrainRewards is open source and available on GitHub:
https://github.com/Dcannady03/TerrainRewards
Use the GitHub repository to:
- View the source code
- Report bugs
- Request features
- Follow development
- Review previous versions and changes
When reporting a bug, please include your TerrainRewards version, Valheim version, BepInEx version, and the relevant portion of LogOutput.log.
Credits
Created by Daniel Cannady
Built for the Valheim modding community.
TerrainRewards
Highlights
From source dataLoaders
Runs on BepInEx.
Footprint
Rated a light load on a server.
Last update
Its author last shipped an update 2 mo ago.
TerrainRewards on Nxeon
From our catalogue- One-click install
- Supported on Nxeon Valheim servers, for BepInEx servers. We download it from Thunderstore, place it, and restart the server.
- Server type needed
- BepInEx
- Server load
- light
- Smallest plan we suggest
- Valheim — 2 GB (2 GB RAM). This follows our own load rating above, not a benchmark.
- Latest build
- 1.2.1, released 2026-09-10
Game versions by loader
| Loader | Game versions | Newest |
|---|---|---|
| BepInEx |
From 5 recorded builds of TerrainRewards.
Recent builds
| Build | Released | Game versions | Loaders |
|---|---|---|---|
| 1.2.1 | 2026-09-10 | n/a | BepInEx |
| 1.2.0 | 2026-09-10 | n/a | BepInEx |
| 1.1.1 | 2026-08-18 | n/a | BepInEx |
| 1.1.0 | 2026-08-17 | n/a | BepInEx |
| 1.0.0 | 2026-08-11 | n/a | BepInEx |
Dependencies
- Required: BepInExPack Valheim
Declared by the newest build that lists any. Required ones are installed with it on one-click installs.
Run TerrainRewards on a Valheim server
Pick a server or deploy a new one above; it is installed in one click.
What kind of mod it is
From the catalogWorld generation
Changes or adds to how new terrain, biomes and structures are created.
Compatibility
- Game
- Valheim
- Loaders
- BepInEx
- Requires
- One-click install needs a BepInEx server.
Verified at the source
- ✓ThunderstoreOfficial listing, checked 2026-10-16Open ↗
- ✓AuthorGafteds, as published on Thunderstore
- ✓LicenseNot published by the sourceFree






