modbykou minechop

Client (single-player or dedicated server)

1. Install BepInEx for Valheim.
2. Copy ConfigurableMineChop.dll into Valheim/BepInEx/plugins/.
3. Launch the game once — the config file is generated at: Valheim/BepInEx/config/kou_minechop.cfg

Dedicated server

1. Install BepInEx on the server.
2. Copy ConfigurableMineChop.dll into the server's BepInEx/plugins/ folder.
3. Start the server once, then edit BepInEx/config/kou_minechop.cfg and restart.
4. With ServerAuthoritative = true (default), the server's settings automatically override every joining client's settings — you only need to configure the server.

How to use in game

• Hold the activation key (default: Left Alt) while swinging your axe or pickaxe — the mod's hit-count rules apply only while the key is held.
• Set ActivationKey to empty or None to make the mod always active.

Configuration (kou_minechop.cfg)

[General]

Setting	Default	Description
Enabled	true	Master switch. false = mod behaves as if uninstalled.
ServerAuthoritative	true	Server's config overrides clients' on connect.
ActivationKey	LeftAlt	Mod only works while this key is held. Any UnityEngine.KeyCode name (e.g. LeftControl, X). Empty/None = always active.

[Trees]

Setting	Default	Description
MinHits	2	Minimum hits to fell a tree/log.
MaxHits	2	Maximum hits. If greater than MinHits, each tree rolls a random count between them (deterministic per tree).
StaminaPerHit	15	Stamina drained per axe swing.

[Rocks]

Setting	Default	Description
MinHits	3	Minimum hits to destroy an ore vein/rock.
MaxHits	7	Maximum hits (random roll per rock between min and max).
StaminaPerHit	15	Fallback stamina per pickaxe swing when no table entry matches.
StaminaPercentTable	3:50,4:40,5:30,6:15,7:10	Per-swing mining stamina as a percent of max stamina, keyed by the rock's rolled hit count. Format: hits:percent,hits:percent,...

Example: a rock that rolled 5 hits drains 30% of your max stamina per swing with the default table.

Tip: set MinHits == MaxHits for a fixed hit count.

How it works

Instead of altering damage numbers (which drift with world modifiers), the mod counts swings per target: non-final swings deal minimal damage, and the final swing destroys the target — so the configured hit count is exact regardless of tool tier or skill level.

Uninstall

Delete ConfigurableMineChop.dll from BepInEx/plugins/. Optionally delete BepInEx/config/kou_minechop.cfg.