DigDug - Precision Excavation & Terrain Building Tool

DigDug is a Valheim mod designed to make large-scale excavation and terrain building easy, fast, and precise. Instead of chipping away at the ground piece by piece, you can dig flat-bottomed pits, trenches, lines, or build protective earth walls of any size, aligned exactly with your look direction.

Features

• Pickaxe Integration: Triggers naturally by right-clicking while holding any pickaxe.
• Precision Alignment Display: Shows your precise yaw angle in degrees and cardinal direction at the top of the screen and window.
• Configurable Rotation & Toggle Keys: Smoothly rotate your character, camera, and the blue preview outlines by 1° increments (hold to rotate continuously at 30°/second) for micro-adjustments using your configured keys (default: Left/Right Arrow keys). Optionally configure a custom MenuHotkey to toggle the menu.
• Excavation & Building Modes:
  • Line: Digs a long, straight line of custom depth, length, and width.
  • Rectangle: Digs a flat solid rectangular pit of custom depth, length, and width.
  • Trench: Digs a hollow perimeter trench (2 meters thick) of custom depth, length, and width around a base plot, keeping the inner ground untouched for quick defense perimeters.
  • Wall: Raises a solid flat-topped dirt wall/mound of custom height, length, and width.
• Smart Painting Options: Automatically paint the excavated floor with Dirt, Paved Stone, Grass, or leave it as No Change.
• Real-Time Resource & Cost Calculation:
  • Shows estimated pickaxe swings, stamina costs, and pickaxe durability.
  • Dynamically calculates the Stone Cost for raising terrain or building walls.
• Terrain Height Modification Safety & Limits:
  • Performs a pre-scan validation to prevent stamina, pickaxe durability, and resource loss if you try to dig or build beyond Valheim's limits where no actual height changes are possible.
  • Clamps the UI depth/height fields dynamically based on the configurable MaxTerrainOffset limit (default: 8.0m).
• Creative Mode & Mod Compatibility:
  • Natively integrates with chest-building mods (like Craft From Containers). If you have enough resources in nearby chests, they will be used and consumed automatically.

Workstation Dependencies

To keep gameplay balanced, building actions require local workstations:

• Wall Mode: Requires a Stonecutter bench nearby.
• Raising Terrain (negative depth): Requires a Workbench nearby.
• Excavation (positive depth) / Trench: Does not require any workstation.

Controls

1. Equip any pickaxe.
2. Right-click (or use your custom MenuHotkey if set) to open the DigDug Excavation window.
3. Use your configured rotation keys (default: Left/Right Arrow keys) to rotate your character, camera, and the blue layout preview box.
4. Set your desired dimensions:
   • Depth/Height: How deep to dig, or how high to raise the wall.
   • Length: Bounding size forward/backward.
   • Width: Bounding size left/right.
5. Choose your alignment Direction (Forward, Backward, or Centered relative to your position).
6. Click Dig! or Build! to execute.
7. Press Escape or click Cancel to close the window without making changes.

Installation

1. Install BepInEx for Valheim.
2. Extract DigDug.dll and place it in your BepInEx/plugins/ directory (or install directly via r2modman/Thunderstore).