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

1. Install TerrainRewards through your preferred Thunderstore-compatible mod manager.
2. Launch Valheim once.
3. TerrainRewards will create its configuration file.
4. Adjust the reward settings if desired.
5. Restart Valheim after making configuration changes.

Manual Installation

1. Install BepInExPack for Valheim.
2. Place TerrainRewards.dll inside:

BepInEx/plugins/TerrainRewards/

1. Start Valheim.
2. 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:

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.1.1

Documentation update.

• Added Ko-fi support link to the mod page
• Minor README formatting improvements

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:Chance entry 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

Support Development

If you enjoy TerrainRewards and want to support future Valheim mods, you can support me on Ko-fi.

Your support helps me spend more time creating new mods, improving existing ones, fixing bugs, and experimenting with new ideas.

☕ Support Gafteds on Ko-fi

Thank you for supporting my work. Skål! 🍻

Credits

Created by Daniel Cannady

Built for the Valheim modding community.

TerrainRewards

Every swing could uncover something.