TerrainShaperPlus

TerrainShaperPlus

Craftable Workbench terrain tool for Valheim 1.0 — raise, lower, level, smooth, reset and paint with typed Height × Width control.

Built with BepInEx + Jotunn.

Support: ko-fi.com/tudoecriativo

---

How to use

1. Craft Terrain Shaper Plus at a Workbench (default min level 1)
2. Recipe (default): 10 Wood + 10 Stone (configurable)
3. Equip the tool
4. Press Ctrl+G → panel Height × Width
5. Type values or pick a preset (e.g. 5×2) → Apply (default max 8 m, raise Height.MaxMeters for unlimited-height mods)
6. Select a piece (Raise ground (square) for platforms)
7. Place freely; hold Alt to magnetically snap tiles to the grid
8. Hold Ctrl + Q/E to rotate the square; Shift + scroll = radius
9. Cultivator farm grid: Ctrl + scroll changes grid size

Level vs Raise

| Piece | What it does | |---|---| | Level | Flattens to your feet height — does not raise by N meters | | Raise / Lower | Moves terrain by Height meters from the panel |

Soft edges / “limbo” voids

Square raises in vanilla are hard cliffs (black void). Soft square bevel is on by default (Terrain.SoftSquareEdges). If you still see dark rims, use Smooth or Reset.

Game clamp: vanilla is about ±8 m per vertex. TerrainShaperPlus defaults to 8; set Height.MaxMeters higher (up to 512) if you use an unlimited-height companion mod.

---

Controls (configurable)

| Action | Default | Config section | |---|---|---| | Open panel | Ctrl+G | Panel.ModifierKey + Panel.ToggleKey | | Grid snap (terrain) | Hold Alt | Grid.HoldKey | | Rotate square | Hold Ctrl + Q/E | vanilla place-rotate + Grid.FollowPieceRotation | | Radius | Shift + scroll | Radius.ModifierKey (default Shift) | | Hardness | Ctrl + scroll | Sharpness | | Height (Raise/Lower) | Scroll alone | Height | | Farm grid | Cultivator + seeds | Farm.Enabled | | Farm grid size | Ctrl + scroll | Farm.SizeModKey |

• Panel.ModifierKey = None → single key (e.g. only G)
• Grid.HoldKey = None → always snap when grid is enabled

---

Panel

| Field | Meaning | |---|---| | Height | Meters up / down | | Width | Brush size (radius / square half-extent) | | Square | Square brush | | Presets | 1×2, 5×2, 5×3, 8×3 |

---

Install (Thunderstore / r2modman)

1. BepInExPack Valheim 5.4.2350+
2. Jotunn 2.26.1+
3. Install TerrainShaperPlus
4. Restart the game

Manual: copy plugins/TerrainShaperPlus.dll into BepInEx/plugins/.

Config: BepInEx/config/poneis.valheim.TerrainShaperPlus.cfg Languages: BepInEx/config/TerrainShaperPlus/lang/ (en.json, pt.json)

---

Features

• Craftable Workbench tool (Wood + Stone)
• Level / Raise / Lower / Smooth / Reset / Paint pieces (+ square variants)
• Typed Height × Width panel with presets
• Magnetic grid snap while holding Alt (terrain tools)
• Rotatable square (Q/E) — brush, snap grid and preview follow piece yaw
• Cultivator farm grid (FarmGrid-style plant snap + visual grid) — uninstall FarmGrid to avoid conflicts
• Soft square edges to reduce black voids
• Optional stamina drain (Stamina.*)
• Optional workbench-in-range for placing (Placement.RequireWorkbench, default off — works from boats)
• Configurable durability, recipe, keys
• EN / PT / ZH localization (editable JSON; drop more languages in config/TerrainShaperPlus/lang/)
• Repairable at Workbench

---

Support

If TerrainShaperPlus helps your builds, you can support continued maintenance:

ko-fi.com/tudoecriativo

---

Credits

• Special thanks to NILDEIRA from team PONEIS
• ValheimTooler / Gungnir — Terrain Shaper concepts
• TerrainTools — QoL ideas
• FarmGrid (Sarcen) — cultivator plant grid concepts
• PONEIS — Valheim 1.0 maintenance

---

Changelog

1.0.18

• Fix crash on load (1.0.17): Harmony patch used wrong parameter name (settings → modifier) for TerrainComp.DoOperation
• Fix Chinese item name on English clients: stop mapping unknown language codes to English (was overwriting EN strings); safer Auto language matching
• If the name is still wrong: set Localization.Language to English in config / Mod Settings

1.0.17

• Height.MaxMeters no longer hard-capped at 8 (range 1–512). Raise it to use with unlimited-height terrain mods
• Soft-square path uses the same configurable height limit (was hardcoded ±8)
• Chinese (zh) localization shipped; Language config accepts Chinese / any lang JSON in config/TerrainShaperPlus/lang/
• See TRANSLATIONS.md for adding more languages / Nexus translation packs

1.0.16

• Fix tool stopping after repeated uses: harden TerrainOp ObjectDB registration, recover failed Deserialize hashes, scrub destroyed ops
• Soft-square flag now set on DoOperation (RPC path) so raises keep applying after many places
• Ghost outline no longer disables the entire placement ghost (only _GhostOnly mesh)

1.0.15

• On-screen / README: Ctrl+Q/E rotate, Shift+scroll radius
• Farm grid size: hold Ctrl (configurable Farm.SizeModKey) + scroll to change GridSections
• Default radius modifier key set to Shift (existing configs keep their value)

1.0.14

• Fix Q/E square rotation (terrain pieces now have m_canRotate)
• Move controls hint above the hotbar
• Hide vanilla circular ghost/marker while drawing the square outline
• Tip: Farm grid is Cultivator-only (not the Terrain Shaper tool) — gray plant grid while placing seeds

1.0.13