EarthWright

Terraforming for Valheim's hoe and cultivator, inside the game's build menu.

Features

• Brush: size (Alt + mouse wheel), five shapes (circle, square, rectangle, ring, frame), rotation, soft or hard edge, grid snapping.
• Exact target heights and three level styles for flat ground (below).
• New hoe and cultivator entries (below); the game's own gain the brush, and each entry's description lists its keys.
• Ramps and curved roads, coloured by slope for carts.
• Undo and redo (Ctrl + Z / Ctrl + Y) and named area snapshots.
• A preview of every changed point, the cost on the HUD, a world grid and an exact-values panel (F6).
• Server rules: costs, height limits per biome (past the game's 8 m too), terrain lock, admin zones; wards cover the whole brush.
• Custom entries: server admins add menu entries that run console commands.
• Tools: longer reach, a light, a left-hand torch, levels up to 6; faster sprinting on roads; a seed grid.

Hoe entries

• Level ground: levels toward the target height in the chosen level style.
• Raise ground / Lower ground: raises or digs by an exact amount, up to the height limits.
• Pathen / Paved road: paints a dirt path, or levels and paves a road.
• Smooth ground: evens out bumps and ridges, keeping the slope.
• Paint ground: paints only: dirt, paved, tilled, grass, original, vegetation and more.
• Reset ground: returns the ground to the world's original height and texture.
• Ramp: three clicks build a ramp: straight, soft joins, soft ends or S-curve.
• Road: click waypoints, then carve a curved road through them.
• Groundbreaker: levels and paves in one swing, clearing trees and rocks first when allowed.
• Clear objects: removes trees, stumps, logs, shrubs, rocks and pickables (when the server allows).
• Terraform (admins): sets the whole brush to the target height in one swing.

Cultivator entries

• Cultivate / Replant: tills while levelling, or brings the grass back.
• Till: tills without changing the height.
• Uproot: pulls up wild berries, mushrooms, flowers and stones; crops are left alone.

Level styles

• Ease: moves gently toward the target, as the unmodded game does.
• Step: moves straight toward the target, at most one step per click.
• Instant: sets every point to the target at once: a flat plateau.

Target heights

• Feet: the ground under you, as the game does.
• Aimed: the ground under the crosshair.
• Continued: the height of earlier flat ground next to the crosshair.
• Locked: one fixed height for every click until released.
• Exact: a typed or stepped height.
• Floor: the top of the building piece under the crosshair.

Install

Needed on the server and every client. Install with r2modman or the Thunderstore app, or put EarthWright.dll in BepInEx/plugins. Keep it installed once you have raised or dug past 8 m, or that ground is drawn clamped to the game's limits.

Configuration

BepInEx/config/milkyteam.earthwright.cfg and YAML files (brushes, costs, entries, limits, zones). Every setting is described in the file and applies without a restart; the server's values bind every player, keys and display options stay your own. Console: ew help; all commands with arguments: https://github.com/geraldjglasgow/ValheimMods/blob/main/EarthWright/CLAUDE.md#console-commands

Links

Discord: https://discord.gg/Q2sMPGQ4T3

Bugs and ideas: https://github.com/geraldjglasgow/ValheimMods/issues (name the mod and version). Licence: GPL-3.0.

Shout outs

• The BepInEx and Harmony teams, for the tools every Valheim mod stands on.
• Iron Gate Studio, for Valheim.
• Thunderstore, for hosting this page.
• The Valheim modding community, for the hard work and dedication that keeps enhancing an already great game.
• Every modder who keeps their mods open source so others can collaborate, learn and build on them.

Changelog

0.4.2

• Fixed: players on a slow connection with many mods are no longer refused when joining a server.

0.4.1

• Fixed: after Alt + Tab, hotkeys could stop working or act as if Shift, Ctrl or Alt were held.
• Store page: every hoe and cultivator entry listed.

0.4.0

• Fixed: an edit could vanish when the ground changed owner; it is sent again, and you are told if it never arrives.
• Fixed: clearing and Uproot no longer take over objects another player owns; picked items drop once.
• Clearing a large area no longer freezes the game.
• Snapshots are kept compressed, at most 16 MB together; a save past that is refused.
• Less network traffic while a click is held, and less work every frame.
• Update the server and every client together.

0.3.4

• Discord link on the store page.

0.3.3

• Less work every frame while previewing a brush's volume, continuing a flat and planning roads.
• Faster loading: the config file is written once instead of once per setting.

0.3.2

• Less work every frame keeping the server's settings in sync.

0.3.1

• Shorter store page; the store description no longer lists the removed shovel. Nothing changes in game.

0.3.0

• Groundbreaker no longer needs a stonecutter nearby, and Paved Road Needs Stonecutter no longer applies to it.
• New Groundbreaker Needs Stonecutter (off by default) brings the requirement back.

0.2.0

• The shovel is removed with its recipe, levels, Dig entry and settings; shovels made with 0.1.x disappear from inventories.
• EarthWright works on the hoe and cultivator only; custom entries take tool: hoe or tool: cultivator.
• Each entry's description lists every key that works with it; the hint line above the build bar and its settings are removed.

0.1.1

• New icons for every EarthWright menu entry and the shovel.

0.1.0

• First release, for the hoe, cultivator and a new shovel.
• Brush size, five shapes, rotation, edge hardness, grid mode and aim at the edge.
• Target heights: feet, aimed ground, locked, exact, continue the flat, floor height.
• Three level styles, exact raise and lower, smooth, paint, reset, a hard level key.
• Ramps (four profiles, quick ramp), curved roads, slope colours for carts.
• Undo and redo, area snapshots.
• New menu entries with toggles and key hints, custom YAML entries, the full build menu.
• Costs: stamina, wear, materials, stations, stone by volume, cooldown, free build, a live cost line.
• Height limits per biome, for the pickaxe too; admin limit, gentle slopes, strict dig mode.
• Protection: wards over the brush, no-build places, dungeons, terrain lock, tools switch, admin zones and entries, combat lock.
• Tools: reach, light, speed, a left-hand torch, levels up to 6.
• Road travel bonus, seed grid, cultivating forbidden ground, console command ew, translation files.