TerrainForge

TerrainForge

A free-form terrain brush for Valheim. Flatten, raise, lower, smooth, build ramps (two-point, fixed-angle and path), shape shorelines, paint and restore terrain of any size — beyond the vanilla ±8 m limit — with undo/redo, five brush shapes, a radial menu, saved profiles, terrain stamps (copy/paste), terrain snapshots and 14 in-game languages with auto-detect.

> Free to download: You can download and use TerrainForge at no cost from Thunderstore or GitHub Releases. The source code is public so it can be viewed on GitHub. Please contact the author and get permission before redistributing the files, publishing modified versions, or using this project in another project. GitHub still allows anyone to fork a public repository, so this request cannot technically prevent forks. No open-source license is granted by this notice.

> 📖 Full documentation & translations (14 languages): Wiki — see the Documentation languages list below.

What's New in 0.3.8 — Hotfix for 0.3.7

• Fixes for TerrainForge Rod registration — the 0.3.7 logs showed repeated failures when its network prefab hash was already registered (same key ... 506871212), alongside invalid item entries during ObjectDB registration. This hotfix reuses a matching existing network entry, removes invalid ObjectDB entries before index rebuilding, and cleans up the tool clone if registration fails.
• Tool state cleanup — terrain editing and its HUD stop when the required tool is unequipped, including while free camera remains active. Equipped-inventory detection covers cases where free camera hides hand slots; press F to exit free camera safely.
• Verification status: these changes address the failures identified in the supplied logs. Confirm the rod is handed out and terrain editing works in Valheim before treating the hotfix as ready to publish.

Features carried forward from 0.3.6

• F5 layout refined — six tabs use two clear rows; the window opens larger and adapts to the screen. Controls are grouped by the selected operation.
• Ramp tools surfaced — the Ramp panel puts Two-Point, Fixed-Angle, and Connected Path modes up front, with width, softness, and fixed-angle controls where relevant. The Connected mode marks a continuous ramp through 3+ points.
• Circular ramp planned for 0.4.0 — the roadmap tracks a level circular ring and a height-changing spiral as candidate designs.
• Unified operation UI — F5 glyphs now appear in the Q wheel, beside the terrain target, and in a compact HUD card with key brush status.
• Dedicated Copy/Paste tab — copy a marked area, start/confirm a paste preview, cycle clipboard history, and manage saved stamps from one visible place in F5.
• Dedicated Copy / Paste brush mode in the Q wheel; Apply selects the area according to the active shape, and the configured paste shortcut starts or confirms placement. Snow is available as DeepSnow under Paint, including the existing hold-to-clear modifier.
• Copy/Paste supports precise Rectangle (two corners), Line (two endpoints), Polygon (vertices), and Circle/Square (brush footprint) selection. The HUD shows the next selection step.
• F5 holds local player controls and camera still, dims the world, and uses a resolution-aware window. The ESC menu still pauses the whole world in single-player.
• Free camera safeguard — flying camera is kept above terrain so descending controls cannot take it underneath the map.
• TerrainForge now registers and synchronizes its own TerrainForge Rod. Jotunn is no longer required.
• The rod registration is repeated for rebuilt world databases, and network registration is retried after the item database is ready. Plugin, project, and Thunderstore versions were aligned at 0.3.6 at that time.
• The live ObjectDB is also revalidated during gameplay to recover if another mod rebuilds its item index after TerrainForge's initial registration.

• Free camera (F) fixed — while flying, right-click no longer triggers lock-on, brush drift or a screenshot; Ctrl+wheel adjusts the brush radius; brush adjustments take priority.
• Docs & wiki in 14 languages — README and CHANGELOG in English, and the full manual on the Wiki (Home + 13 translations).

Description

TerrainForge ships its own TerrainForge Rod (a Hammer clone) as the brush tool. It is handed to you automatically when you join a world and everything is explained in an in-game Help tab (menu key, default F5).

Why client AND server

Terrain edits are stored in the world and the server replicates them to every player. Because the game clamps edits to ±8 m, TerrainForge must also be installed on the server; otherwise the server regenerates the clamped terrain while clients see the full edit → desync.

Requirements

• BepInEx 5 (x64, Mono) on both client and server. Thunderstore users already have it.

Installation

1. Download the latest version from Thunderstore or GitHub Releases.
2. Place it at:

• Client: ...\BepInEx\plugins\TerrainForge\TerrainForge.dll
• Server: <server>\BepInEx\plugins\TerrainForge\TerrainForge.dll

1. Restart the game / server.

> ⚠️ Must be on both (client and server) for edits greater than ±8 m and correct replication.

Usage

Equip the TerrainForge Rod (given on world join; get it again with F8), aim at the ground and hold right-click to sculpt.