Home

Updated a month ago

TerrainForge Wiki

English · Español · Français · Deutsch · Русский · 中文 · 繁體中文 · 日本語 · 한국어 · Polski · Português · Türkçe · Українська · Italiano


Table of Contents

  1. Installation
  2. Quick Start
  3. Controls
  4. Operations
  5. Shapes
  6. Falloff Modes
  7. Stamps (Copy/Paste)
  8. Snapshots (Backups)
  9. Profiles
  10. Languages
  11. Multiplayer
  12. Settings
  13. Troubleshooting

📥 Installation

Requirements

  • BepInEx 5 (x64, Mono) on client and server. Thunderstore users already have it.
  • Jotunn (ValheimModding-Jotunn) — registers the custom tool. It is listed in manifest.json; Thunderstore installs it automatically.

Steps

  1. Download TerrainForge-<version>.zip from Thunderstore or GitHub Releases.
  2. Extract and place TerrainForge.dll at:
    • Client: ...\BepInEx\plugins\TerrainForge\TerrainForge.dll
    • Server: <server>\BepInEx\plugins\TerrainForge\TerrainForge.dll
  3. Restart the game / server.

⚠️ Must be installed on client AND server for edits greater than ±8 m and correct replication.


🚀 Quick Start

  1. Join a world. The TerrainForge Rod (a Hammer clone) is given and equipped automatically.
  2. Press F5 to open the menu (or click the TerrainForge button in the ESC pause menu).
  3. Equip the rod if it is not equipped.
  4. Aim at the terrain and hold right-click (Mouse1) to sculpt.
  5. Use , to cycle operations, . for shapes, / for paints.
  6. Hold Q → radial menu, release to confirm.
  7. Ctrl+Z / Ctrl+Y to undo/redo.

⌨️ Controls

Action Default key Description
Apply brush Hold Mouse1 (Right Click) Sculpts terrain under the crosshair
Radius + = or Ctrl+Wheel Increases brush radius
Radius − - or Ctrl+Wheel Decreases brush radius
Cycle operation , Cycles the 9 operations
Cycle shape . Circle → Square → Line → Rect → Poly
Cycle paint / Cycles the 6 paint types
Level to feet Hold Left Shift Flatten uses the player height
Undo Ctrl+Z Undoes the last stroke
Redo Ctrl+Y Redoes the undone stroke
Eyedropper G Fixes the Flatten height at the crosshair (again = release)
Ramp mode H Cycles: Two-Point → Fixed-Angle → Path (or pick with 3 buttons in SETTINGS)
Fixed ramp angle Hold Alt + radius/wheel Adjusts the angle in fixed mode
Radial menu Hold Q Pick an operation with the mouse, release confirms
Adjust mode V Wheel = radius, freezes zoom/bar/map
Fine adjustment (0.1 m) Hold Shift + wheel/radius Precise radius adjustment
Copy Stamp Ctrl+Shift+C Copies the marked area to the clipboard
Paste Stamp Ctrl+Shift+V Ghost preview, click confirms
Get Rod F8 Grants the TerrainForge Rod
Open menu F5 Opens the keys/help/settings menu

Extra keys (no default, assign them in KEYS):

  • Direct operation: Flatten, Raise, Lower, Smooth, Paint, Restore, Ramp, Shore, Snow
  • Next / previous profile
  • Next / previous stamp (history)

"Quick actions" section (KEYS tab): buttons for functions with no mandatory shortcut — Undo, Redo, Fix height, Copy/Paste stamp, Previous stamp, Clear marks, the heatmaps and the Material diagnostic (dumps the shader + texture slots to the log).


🔄 Operations

Operation Description
Flatten Levels to the aimed height (Shift = at your feet). Fixed height via the Eyedropper (G) or the SETTINGS textbox.
Raise Raises terrain by RaiseDelta per application. The falloff mode shapes it.
Lower Lowers terrain by RaiseDelta per application. The falloff mode shapes it.
Smooth Real blur: averages each vertex with its 8 neighbours. Hold for progressive. Modes: Full (both), Ridges only (lowers), Dips only (raises). Line shape = smooth a path.
Ramp 3 modes (cycle H):
• Two-Point: mark A and B → a straight slope joins the heights.
• Fixed-Angle: B = direction/length; height = SlopeAngle (up/down according to the crosshair). Adjust with Alt+radius.
• Path: mark a curve A→B→C… (double-press with 3+ closes) → smooth Catmull-Rom.
Width = brush radius. Softness = blend on the side edges only. Preview: filled corridor + height rings at A/B.
Shore Flattens toward the water level + ShoreOffset margin (beaches). Softness like Flatten.
Paint Types: Dirt, Cultivated, Paved, ClearVegetation, DeepSnow, Reset. Adjustable strength.
Restore Returns the terrain to its original state (height + paint).
Snow Snow-only paint (same mask as the game). Shift = removes it and restores the original.

📐 Shapes

Cycle with the . key. All support undo.

Shape Marking Use case
Circle Single click (brush centre) General sculpting
Square Single click (centre) Platforms, foundations
Line 2 clicks (A → B) Paths, walls, trails. Half-width = radius.
Rectangle 2 clicks (opposite corners) Foundations, farms, platforms. Soft edges.
Polygon Click per vertex, double-click closes (3+ vertices) Complex shapes, custom areas
  • Non-circular shapes show only the marked outline (no circular rings).
  • Softness affects the edge blend on all shapes.

⚙️ Falloff Modes (Raise/Lower)

Config in SETTINGS → "Raise/Lower falloff":

Mode Behavior
Pointy Central peak. Controlled by the "Falloff power" slider (1–5).
Flat Uniform disc — same weight across the whole radius.
Smooth Cosine bell — smooth transition, no hard edge.
Linear Straight taper from centre to edge.

🧱 Stamps (Copy/Paste)

A powerful feature for replicating terrain structures.

Rectangle selection (recommended)

  1. Set the shape to Rectangle (key .).
  2. Press Apply (Mouse1) once to mark corner A (this makes no edit).
  3. Aim at corner B (just move the camera).
  4. Press Ctrl+Shift+C → copies exactly that rectangle, cropped to the selection (it does not drag whole 64 m tiles or untouched ground around it). The corner A mark is consumed after a successful copy.

Workflow

  1. Mark the area: use any shape (Circle, Rect, Line, Poly, Ramp) — or the rectangle selection above.
  2. Copy: Ctrl+Shift+C → "Stamp copied: X tiles" (RAM clipboard).
  3. Paste preview: Ctrl+Shift+V → ghost wireframe at the crosshair.
    • Q/E = rotate ±15°
    • Alt+Wheel = continuous rotation
    • Shift+Wheel = scale 0.25×–4×
    • Esc = cancel
  4. Confirm: click (Mouse1) → applies as a single Undo step.

Selection stamps write only inside the copied region; terrain outside it is left untouched.

History

  • Up to 10 stamps in RAM (most recent first).
  • Next stamp / Previous stamp keys (rebindable) cycle them.
  • Flash: "Stamp history: Copy: 3 tiles [2/5]"

Persistence

  • SETTINGS → STAMPS:
    • Save the current stamp to disk (.stamp in BepInEx/config/TerrainForge/stamps/, max 12).
    • Load a stamp into the clipboard.
    • List/delete saved stamps.

Stamp tool

  • SETTINGS → "Stamp tool" (4 options):
    • Same as brush (default) — uses the same tool as the brush
    • Any — no requirement
    • Pickaxe — requires a pickaxe equipped
    • TerrainForge Rod — requires the mod's rod
  • The HUD shows STAMP READY [2/5] when the tool is equipped + stamps in the clipboard.
  • Without the tool: Stamp: tool not equipped, copy/paste blocked.

💾 Snapshots (Backups)

Full terrain backup/restore.

Save

  1. SETTINGS → SNAPSHOTS.
  2. Name (empty = auto date/time).
  3. Save → edited tiles to BepInEx/config/TerrainForge/snapshots/<name>.dat (max 12).

Load

  1. Select a snapshot.
  2. Load → restores tiles with ownership, 1 undo step.
  3. Unloaded tiles warn cleanly — import close to the original location.

Features

  • Versioned binary format (.dat).
  • Restores height + smooth + paint + ownership.
  • Import is undoable (Ctrl+Z reverts the import).
  • Unloaded tiles warn cleanly.

💾 Profiles

Save/load complete brush configurations.

  • SETTINGS → PROFILES.
  • Name + Save → radius, softness, op, shape, paint, ramp mode, angle, smooth mode, raise delta, paint strength, falloff, shore offset.
  • Load → applies instantly.
  • Max 12 profiles (culture-invariant format in Presets > Slots).
  • Keybind: Next Profile (assign in KEYS) to cycle.

🌐 Languages

15 options: Auto, English, Español, Français, Deutsch, Русский, 中文, 繁體中文, 日本語, 한국어, Polski, Português, Türkçe, Українська, Italiano — default Auto.

Auto-Detect

  • The default Auto detects the game language via reflection: Localization.instance.GetSelectedLanguage().
  • Maps the Valheim language → internal index.
  • If a language has no complete translation → falls back to English.
  • Configurable in SETTINGS → "Language" (cycles the 15 options).
  • Key labels are rebuilt when the menu opens.

Translation status

  • Complete: English, Español
  • English fallback: Français, Deutsch, Русский, 中文, 繁體中文, 日本語, 한국어, Polski, Português, Türkçe, Українська, Italiano
  • Community translations welcome via PR.

This documentation

Translated wiki pages: English · Español · Français · Deutsch · Русский · 中文 · 繁體中文 · 日本語 · 한국어 · Polski · Português · Türkçe · Українська · Italiano.


🌍 Multiplayer

Requirements

  • Mod on client AND server for edits greater than ±8 m and correct replication.
  • UnlockDeltaLimit on the server too, otherwise the server clamps terrain.

Server Authority (Config Sync)

When the server runs the mod, its Server section wins:

  • AllowTerrainEdits (default true) — master switch; if false, clients cannot apply/undo/redo.
  • AdminOnlyEdits (default false) — only admins/host can edit.
  • RespectWards (default true) — blocks edits inside foreign wards.
  • RadiusCap / DeltaCap (0 = off) — server-enforced caps, visible in the HUD+preview.

Servers without the mod ignore the section → the client works for testing.

Desync Prevention

  • Keep MaxUpDelta / MaxDownDelta consistent on server + clients.
  • Large radii can desync clients without the mod.

⚙️ Settings

File: BepInEx/config/com.terrainforge.valheim.cfg

General

Setting Default Description
Enabled true Master switch
PlayEffects true Dust + hit on apply
Language Auto Auto / English / Español / Français / Deutsch / Русский / 中文 / 繁體中文 / 日本語 / 한국어 / Polski / Português / Türkçe / Українська / Italiano
ToolTint true Tints the TerrainForge Rod (a Hammer clone) so it is easy to tell apart from the vanilla Hammer
ToolTintColor #4FC3F7 Rod hex color (model + icon). E.g. #FFC400 gold, #8BC34A green

Brush

Setting Default Range Description
Radius 8 1–100 Brush radius (m)
RadiusMin 2 — Min radius while adjusting
RadiusMax 60 — Max radius while adjusting
RadiusStep 1 — Radius change per key/wheel
Softness 50 0–100 Edge softness (0 = hard, 100 = very soft)
FalloffPower 3 1–5 Falloff exponent (Pointy mode only)
RaiseLowerMeters 2 0.5–10 Metres per Raise/Lower application
PaintStrength 1 0–1 Paint strength
DefaultOperation Flatten — Starting operation
Shape Circle — Starting shape
Paint Dirt — Starting paint
RampMode TwoPoint — TwoPoint / FixedAngle / Path
SlopeAngle 30 5–60 Fixed ramp angle (degrees)
SmoothMode Full — Full / Bumps / Dips
FalloffMode Pointy — Pointy / Flat / Smooth / Linear
ShoreOffset 0.5 -2–5 Shore margin above water (m)
UseFixedHeight false — Use a fixed height (eyedropper state)
FixedHeight 30 -10–150 Exact Flatten height (m)

Vanilla / integration

  • BlockVanillaTerrainTools: false — with the rod equipped, ignores the vanilla hoe/cultivator terrain edit. There is also a toggle in SETTINGS.

Input

All shortcuts are rebindable in the KEYS tab. Highlights:

  • ApplyKey (Mouse1), RadiusUp/Down (=/-), CycleOp/Shape/Paint (,/.//)
  • UndoKey (Ctrl+Z), RedoKey (Ctrl+Y), EyedropKey (G), RampModeKey (H)
  • RadialKey (Q), AdjustModeKey (V), GiveToolKey (F8), RebindMenuKey (F5)
  • Direct op keys (9, no default): OpFlatten/Raise/Lower/Smooth/Paint/Restore/Ramp/Shore/Snow
  • CycleProfileKey, CycleStampKey, CycleStampBackKey
  • RequiredTool: Any / Pickaxe / TerrainForgeTool (default)
  • AutoGiveTool: true (grants the rod on join)

Stamps

  • StampToolMode: Same as Brush / Any / Pickaxe / TerrainForgeTool (default Same as Brush)

Preview

  • ShowPreview: true, ShowGuides: true (reach guides, slope tint, level ring)

History

  • UndoDepth: 50 (0–500, 0 disables history)

Server (Authoritative via Config Sync)

  • AllowTerrainEdits: true (master switch)
  • AdminOnlyEdits: false (admins only)
  • RespectWards: true (blocks foreign wards)
  • RadiusCap / DeltaCap: 0 (off) — server-enforced caps

Performance

  • TilesPerFrame: 4 (1–32 tiles/frame)

🐛 Troubleshooting

Issue Solution
Menu does not appear / invisible cursor Close the game. Delete %APPDATA%\Thunderstore Mod Manager\DataFolder\Valheim\profiles\YourProfile\BepInEx\plugins\TerrainForge\ and %APPDATA%\Thunderstore Mod Manager\PackageCache\. Restart TMM, check updates.
Update not showing in TMM TMM → Settings → "Refresh mod list" (Ctrl+R). Close/reopen TMM. Verify the correct profile.
Thunderstore version conflict Bump the version (0.3.3 → 0.3.4) in .csproj, Plugin.cs, manifest.json. Rebuild + re-upload.
Stamp copy/paste does nothing HUD: STAMP READY [X/Y] = ready. If "tool not equipped", equip the tool (SETTINGS → Stamp tool).
Preview invisible under water Fixed in 0.3.2 — the preview floats on the surface. Update.
Circles on Line/Rect/Poly Fixed in 0.3.2 — only the marked outline is shown. Update.
Radial wheel does not work Fixed in 0.3.2 (ZInput.GetMouseScrollWheel()) and 0.3.4 (the selection is no longer wiped with a centered cursor). Update.
Config does not save Close the menu (F5) to auto-save. Or edit BepInEx/config/com.terrainforge.valheim.cfg directly.
Multiplayer desync Mod on client+server. UnlockDeltaLimit on both. Same MaxUpDelta/MaxDownDelta.
Build fails Check the ValheimDir, BepInExCoreDir, JotunnDir paths in .csproj or via CLI. .NET SDK 8+ required.
Compile / package dotnet build -c Release (DLL in build/), -p:Deploy=true (installs into the profile) or -p:Package=true (zip in build/).

🔗 Links


TerrainForge — Terraform Valheim without limits.