ChestGrid

ChestGrid is a small Valheim BepInEx mod that snaps normal wooden chests into clean rows, blocks, and stacked layouts while placing them with the hammer.

Status

This is an early release and has not been broadly tested yet. Please treat it as experimental and make a backup of important worlds before using it on a server or long-running world.

AI Disclosure

This mod and Thunderstore package were created with AI assistance. OpenAI Codex was used to help generate code, package structure, and documentation.

Features

• Snaps normal wooden chests to nearby normal wooden chests while placing.
• Supports rows, blocks, and vertical stacks.
• Tuned default spacing for tight wooden chest layouts.
• Configurable grid spacing, snap range, vertical snap behavior, and cache interval.
• Hold Shift to temporarily disable snapping.
• Client-side only. The server does not need this mod.
• No runtime dependency on other placement or snapping mods.

Installation

Install with r2modman or Thunderstore Mod Manager.

For manual installation, place ChestGrid.dll in:

BepInEx/plugins/ChestGrid/

Configuration

After first launch, edit:

BepInEx/config/ChestGrid.cfg

Important values:

• GridWidth
• GridDepth
• GridHeight
• SnapRange
• VerticalSnapRange
• UsePlacementHeightForVerticalSnap
• DisableWhileShiftHeld
• ChestCacheInterval

Notes

• ChestGrid only affects placement previews for normal wooden chests.
• Existing chests are not moved automatically.
• If snapping feels too aggressive, hold Shift while placing or lower SnapRange.