Aces VeinMine

A safer, configurable vein-mining mod for Valheim.

Break connected rocks, ore deposits, trees and logs without turning every destructible object in the world into a target.

Frozen north Compatible

Features

• Vein-mines supported rocks and ore deposits.
• Vein-mines trees and fallen logs.
• Supports small rocks and tree stumps through narrow safety checks.
• Uses the correct tool type:
  • Pickaxe for rocks and ores.
  • Axe for trees, logs and stumps.
• Three activation modes:
  • HoldKey
  • AlwaysOn
  • Off
• Default activation key: LeftShift.
• Extra mouse buttons are supported.
• Mouse0, Mouse1 and Mouse2 are blocked from use as the activation key.
• Vanilla Valheim item drops are preserved.
• Fail-closed safety: unknown destructibles are ignored.

Safety

Aces VeinMine deliberately avoids generic destruction patches.

The mod targets known natural resource classes such as:

• MineRock
• MineRock5
• TreeBase
• TreeLog

Small rocks and stumps are handled only through tightly-filtered Destructible checks.

Anything that cannot be confidently identified as a supported natural resource is left alone.

Configuration

After launching the game once with the mod installed, edit the generated BepInEx configuration or use a compatible configuration manager.

Activation Mode

HoldKey
VeinMine activates while the configured key is held.

AlwaysOn
VeinMine activates automatically when using the correct tool on a supported resource.

Off
Disables VeinMine without uninstalling the mod.

Hold Key

Default: LeftShift

Extra mouse buttons such as Mouse3 and above are supported.

Primary mouse buttons Mouse0, Mouse1 and Mouse2 are intentionally rejected.

Drops

Aces VeinMine uses normal Valheim drop behavior. Item quantities and drop locations are not modified.

Compatibility

Client-side BepInEx mod for Valheim.

Unknown or unsupported destructible objects are intentionally ignored for safety.

Author

AcesGamingUK

Debug Logging

In BepInEx/config/acesgaminguk.acesveinmine.cfg:

[Debug]
EnableDebugLogging = false

Set to true to write detailed diagnostic messages to BepInEx/LogOutput.log, or use a compatible config manager. When editing the file manually, close the game first and restart afterwards. Turn it back to false after reproducing a problem. The setting persists and does not change mining behavior. Diagnostics include target/prefab identity, activation and tool checks, and before/after pickaxe/chop damage. Existing error logs remain available when debug is off.

Console Commands

• acesveinmine on: use HoldKey mode with your configured key.
• acesveinmine always: use AlwaysOn mode.
• acesveinmine off: disable vein mining.
• acesveinmine: show current mode and usage.

Mode changes save to the existing config. Tool and resource checks still apply. The mod does not open the console or enable cheats.

This release does not contain the DEV identify, nearby or drop-inspection commands.

Changelog

1.0.1

• Works With 1.0
• Added persistent Debug.EnableDebugLogging config setting, disabled by default.
• Added acesveinmine on, always and off commands; mode changes save to config.
• Preserved existing mining, protection, tool and drop handling.

1.0.0

• Initial public release.
• Added configurable HoldKey, AlwaysOn and Off activation modes.
• Default hold key set to LeftShift.
• Added support for extra mouse buttons while blocking Mouse0, Mouse1 and Mouse2.
• Added vein-mining support for MineRock and MineRock5 resources.
• Added tree and fallen-log support through TreeBase and TreeLog.
• Added narrow support for small rocks.
• Added narrow support for tree stumps/stubs.
• Added strict fail-closed protection for unknown destructible objects and structures.
• Preserved vanilla Valheim drop behavior.