GoldenJude-Mineshafts icon


Adds underground mining to valheim

Last updated a day ago
Total downloads 2127
Total rating 3 
Categories Server-side Client-side
Dependency string GoldenJude-Mineshafts-1.0.4
Dependants 7 other mods depend on this mod

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.1900 icon

BepInEx pack for Valheim. Preconfigured and includes unstripped Unity DLLs.

Preferred version: 5.4.1900



Use the mod on a server to sync configs.
In case of questions you may find me on the OdinPlus or the Valheim modding discord servers.
You may also file an issue on GitHub.


Underground mining

  • place down a mineshaft entrance, grab your pickaxe and uncover the riches hiding deep in the earth
  • upon entering a mine you may dig around using your pickaxe and eventually find ores
  • building within mines is allowed
  • it is possible to link up separate mineshafts by digging towards them
  • the dug up area will stay behind even when destroying a mineshaft entrance, feel free to reposition entrances
  • placing an entrance inside a mine will link it up back to the surface

Abandoned mineshafts

  • explore the remains of past mining operations and fight the entrapped miners
  • abandoned mineshafts generate throughout the world and contain loot aswell as exposed ore veins


Configuration for the mod is done within the GoldenJude_Mineshafts.cfg file created upon game launch.
All configs reload during runtime.

General configuration

wall_health = configures the health of underground rock
min_pickaxe_tier = minimum pickaxe tier needed to mine generic underground rock
vein_chance = percent chance that a vein will appear
default_drop = default drop when mining underground rock
default_drop_min/max = amount of dropped default material

Building piece recipe

items = array of items followed by their required amounts for this building piece
recover = defines if required items should be recovered upon destruction

Abandoned mineshaft configuration

spawn_chance = percent chance that a mineshaft will spawn if possible
quantity = amount of abandoned mineshafts to be generated throughout the world
min_spacing = minimum spacing between abandoned mineshafts (if an abandoned mineshaft is spawned another one cannot spawn within this distance of it)
rooms = amount of rooms to be generated in an abandoned mineshaft


biomes = array of possible bioms this vein may spawn in
possible biomes: Global, None, Meadows, Swamp, Mountain, BlackForest, Plains, AshLands, DeepNorth, Ocean, Mistlands
weight = likelinnes of a vein occuring over others in the same biome
min_pickaxe_tier = minimum pickaxe tier required to mine this vein
color = color of the vein model defined in hex color code
emission_color = color of the glow on the vein model, black - no glow
metallic = adds a metallic shine to the vein
shine = defines the smoothness/shine of the vein model
drop = item dropped by this vein
drop min/max = amount of dropped material
to define a vein config the header must start with vein_ followed by anything, for example [vein_my_vein-mistlands-32]




  • 1.0.4
    fixed required pickaxe tiers being too high in default config
  • 1.0.3
    fixed min pickaxe tier config for veins not applying
  • 1.0.2
    fixed vein chance calculation resulting in infinite strips of veins
  • 1.0.1
    fixed an error regarding piece configs
  • 1.0.0
    initial upload

Prefab names

mineshaft entrance - MS_Entrance
abandoned mineshaft location - MS_D_AbandonedMineshaft
mine chunk/tile - MS_MineTile
wood planks 2x2 - MS_woodwall_2x2
damaged wood planks 2x2 - MS_woodwall_2x2_damaged
wood planks 2x4 - MS_woodwall_2x4
damaged wood planks 2x4 - MS_woodwall_2x4_damaged
wooden stairs - MS_woodstairs
damaged wooden stairs - MS_woodstairs_damaged
tier 1 chest - MS_chest_T1
tier 2 chest - MS_chest_T2
underground wall on hit effect - MS_FX_Tile_Hit
underground wall on destroy effect - MS_FX_Tile_Destroyed
bone pile skeleton spawner - MS_Bonepile

Available versions

Please note that the install buttons only work if you have compatible client software installed, such as the Thunderstore Mod Manager. Otherwise use the zip download links instead.

Upload date Version number Downloads Download link  
2022-5-22 1.0.4 413 Version 1.0.4 Install
2022-5-21 1.0.3 457 Version 1.0.3 Install
2022-5-18 1.0.2 465 Version 1.0.2 Install
2022-5-16 1.0.1 328 Version 1.0.1 Install
2022-5-14 1.0.0 464 Version 1.0.0 Install