SANDBOX — this is a test environment. No servers are actually deployed and no real payments are charged.
Source-checkedWorld generation

TerrainRewards

by Gafteds · for Valheim

Configurable ground-drop rewards for mining terrain in Valheim. Updated for Valheim 1.0.

612Downloads
2 mo agoLast updated
BepInExLoaders
ThunderstoreSource

About TerrainRewards

From Thunderstore

Configurable 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

  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:

| 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.Message API
  • 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: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

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

Read the full description on Thunderstore →

Highlights

From source data

Loaders

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

LoaderGame versionsNewest
BepInEx

From 5 recorded builds of TerrainRewards.

Recent builds

BuildReleasedGame versionsLoaders
1.2.12026-09-10n/aBepInEx
1.2.02026-09-10n/aBepInEx
1.1.12026-08-18n/aBepInEx
1.1.02026-08-17n/aBepInEx
1.0.02026-08-11n/aBepInEx

Dependencies

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 catalog
Listed on Thunderstore as “Content”

World 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

TerrainRewards, answered

Generated from the mod’s own source data.

Which loaders does it support?

BepInEx.

Is it free?

Yes. TerrainRewards is free to download from Thunderstore.

How do I add it to my Nxeon server?

Use “Add to a server” on this page, or open NxLabs from your dashboard. We install it, restart your server and switch it on.

NxLabs

Run TerrainRewards on a Valheim server.

Deploy in about a minute from $6.50 a month, then add TerrainRewards in one click.