VeinMining
Cooperative whole-deposit mining. Hold or double-tap Alt, shared leather HUD, adjustable ore speed and diminishing team bonuses. Requires BepInEx and Jotunn.Vein Mining 0.3.3
Experimental shared deposit mining for Valheim 1.0.16. Requires BepInExPack 5.4.2351 and Jotunn 2.30.2. No additional mining mod is required or installed as a dependency.
Equip a pickaxe, aim at ore within normal swing range, and hold Left Alt. Your character keeps swinging while the key is held. The server records damage in one shared progress bar. Other players can hold Alt on the same deposit to contribute. The deposit breaks and releases its resources at completion.
Release Alt to pause in hold mode. Or double-tap Alt within 0.35 seconds for automatic mining without holding it; press Alt again to stop. The bar shows Auto in this mode. Movement, blocking, a menu, loss of window focus, changing tools or breaking your pickaxe also stops your contribution. Progress is retained. Repair and equip your pickaxe, then start again. Native game mechanics handle stamina and attack speed.
You can mine the same deposit normally without Alt. Parts break and drop resources immediately, reducing the work left for Vein Mining.
Vein Mining works independently of Smoothbrain Mining. An optional compatibility adapter remains for players who already use that mod; it does not install it. All plugin messages and documentation are in English.
Delivery
src/SharedMining: complete source code.dist/VeinMining-0.3.3.zip: installation package with Thunderstore layout.dist/VeinMining-0.3.3-source.zip: source, build scripts and tests.- Installation, test report, ore catalog, profile lock.
Nothing has been published. This is a test build; acceptance testing with separate clients and a dedicated server remains outstanding.
Work and timing
Actual native attacks provide skill-adjusted damage and normal durability deductions. The mod does not drain your entire pickaxe or use a fixed timer per ore type. The server tracks health per part, including buried parts and intact shells that transition to fragmented ore. Overkill damage is not transferred to another part.
The single visible setting, Ore Mining Multiplayer, applies to all supported deposits. The host/server chooses a value from 1 to 10, default 3. 1 = normal work per hit; it does not guarantee exact total manual-mining time. Client settings do not override the server. Loot and per-hit durability are unchanged; fewer swings mean less total wear and fewer skill awards. Ordinary mining is unaffected. Legacy key/prefab/distance settings remain hidden for compatibility; the old CopperWorkMultiplier is no longer used.
Cooperative scaling: one active miner = 1x, two = 2x, three = 2.5x, four = 3x; each additional miner adds 0.5x. Each contributor's actual damage is multiplied by team rate divided by active miner count, so the bonus is not applied twice. The displayed team rate assumes equal tools and swing rates. A miner counts after a valid shared hit and for four seconds after their latest hit; stopping removes them. Brief join/leave transitions are therefore approximate. Ordinary hand mining reduces remaining work but is not part of this automatic-miner count.
The compact 360×84 Canvas HUD uses the approved dark leather artwork, stitched border and bronze corner studs. Text and the golden progress bar are rendered live. The header shows Vein Mining and a percentage; the footer shows only the configured ore factor and active miner count, for example 3× · 3 miners. The cooperative curve remains active internally, but no Co-op, Team, Ore or Auto labels are displayed. Idle jobs show zero miners with retained progress. The background is embedded in the DLL, so no loose texture installation is required.
Identical total completion time has not been established for every manual mining method. Digging, movement, changing collision geometry, multiple hits and structural collapse affect comparisons. Structural collapse is not simulated during progress. Total time and durability comparisons remain part of acceptance testing.
A deposit is one networked object and its possible transition to fragmented ore. Separate neighboring objects are not merged automatically. Barrels containing ore are not deposits. Additional modded deposits can be enabled after examining the prefab audit; unfamiliar destruction components need another adapter.
Build
Use a .NET SDK and a local Valheim installation with the mod profile. Game and third-party mod libraries are not redistributed.
dotnet build src/SharedMining/SharedMining.csproj -c Release -p:GameManaged="D:/Steam/steamapps/common/Valheim/valheim_Data/Managed" -p:BepInExCore="C:/path/to/profile/BepInEx/core"
dotnet run --project tests/CoreTests/CoreTests.csproj -c Release
./tools/Package.ps1
Paths can also be defined in an ignored Local.props. Jotunn is expected under the profile's BepInEx/plugins/ValheimModding-Jotunn directory. Never install the runtime test DLL in a normal profile or production server.
Server behavior
Progress is stored in the deposit's ZDO and follows normal world saves. Reconnecting, repairing or changing contributors does not reset it. A crash before the next world save can lose unsaved progress.
Active deposits remain server-owned. The server loads the selected deposit and contributor when needed, including in remote areas. Heartbeats retain those instances while contributions remain active. You can also mine normally without Alt: ordinary hits break parts and release their resources normally, reducing remaining shared work. Native collapse caused by ordinary hits also counts. Previously destroyed parts are not rewarded again at shared completion.
The server checks session tokens, sequence numbers, player ownership, distance, tool tier, numeric bounds and frequency. Actual player damage and equipment remain client-controlled, as in ordinary Valheim combat. This is not a complete anti-cheat system.
Jotunn enforces matching plugin versions through its network compatibility system. Only the server's allowed-deposit configuration decides whether a job can start.
