Back to mods
Underground Mines project artwork

Vintage Story Mod DB · Vintage Story mod

Underground Mines

NEW VERSIONS As I said some time ago I'll not work on this mod anymore. I'll keep it working on new version of the game but I'll not add anything new. Now there are a few successors of the mod that you can try! I'll list them here: - Underground Mines Lite

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Underground Mines release should I use?

Updated 3 months ago
Latest stable file 1.0.6
Game version 1.22.0
Loader Built-in Vintage Story mod system

Underground Mines 1.0.6 targets 1.22.0. Do not install it on the client. It must be installed on the dedicated server. No extra mods listed for this file.

Where it goes

Is Underground Mines required on the client, server, or both?

Do not install it on the client. It must be installed on the dedicated server.

Client Not supported
Dedicated server Required
Loader for this release Built-in Vintage Story mod system
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

This Vintage Story file is marked server-only.

What else does Underground Mines 1.0.6 need?

1.0.6. Change the file and its required mods may change too.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

This file does not list any required or optional mods.

Before you install it

Add Underground Mines without breaking your instance.

Built for Underground Mines 1.0.6. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use 1.0.6. It targets 1.22.0; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    This file does not list any required mods. Do not add a library just because a different file uses it.

  3. 03

    Put it on the correct side

    Do not install it on the client. It must be installed on the dedicated server.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside 1.0.6. It opens that exact file at the source.

About this project

What does Underground Mines add?

NEW VERSIONS

As I said some time ago I'll not work on this mod anymore. I'll keep it working on new version of the game but I'll not add anything new.

Now there are a few successors of the mod that you can try! I'll list them here:

- Underground Mines Lite by A_Whisper

- Underground Mines Progression by A_Whisper


This mod generates large and sometimes almost infinite mines and mineshafts underground! In those you can easily find ores and some loot but... be careful, in the depths, you'll encounter powerful enemies such as drifters, locust and, if you have some luck(or not) a bell!

Depending on the type of rock where the mines are generated, they will appear not only with the same type of rock but the ores can only be of the types that can be generated in that type of rock.

There are also some rooms with special loot and enemies so, be careful if you explore one of those.

If you want to explore some of this mines, you can find entrances ofer the world, in caves and, if you can't find one, you can just mine down until find one(By default, they are generated in Y5 but that can be changed in config file or in worlds with more/less height).


👨‍💻 Contributors
  • Rata: Help designing and building the mines.
  • VS Offcial Discord modders: For helping with some codding questions and for leting us use some pieces of their mods code.

✅ Compatible Mods

I've tested Underground Mines with other 60+ mods and it's working perfectly.

Some times ruins from other mods are generated inside the mines. 90% of the times those are perfectly conected to this ones not breaking anything but, the other 10%... they break a wall in the mine or something like that.
I can't fix that as this mines are not breaking anything, the other mods are generating things inside mines.


🔧 Future Plans & Updates
  • [Done] Rework the actual structures to make them look more ruined and remove some blocks that generates in a wrong way.
  • [Done] Change structure rock types to match the terrain rock strata.
  • [Done] Add special rare rooms with some good loot and enemies.
  • [Done] Add entrances to the mines in random places over the world.
  • [Done] Add a config file to let players modify some things like spawn rates or Y cordinate where mines are generated.

⚙ Configuration File
This file is located in VintagestoryData/ModConfig/UndergroundMines.json and contains the following options:
 
"yLevel": 0.48 (0.0 to 1.0)
Let's you change the Y level where mines are generated. 0.0 is the mantle layer and 1.0 is the sea level.

"aditionalOres": true (true or false)
When you set this to true, random ores will be generated in the mine walls and roof, if you set it to false you'll only find narutal generated ores.

"addMushrooms": true (true or false)
When you set this to true, mushrooms will be generated in the support beams of the mines, if you set it to false no mushrooms will be generated.

"addLocustNests": true (true or false)
When you set this to true, locust nests will be generated in the ceiling of some mines, if you set it to false no locust nests will be generated.

"entranceChance": 0.1 (0.0 to 1.0)
To change the amount of entrances generated over the world. Entrances are generated above crossings where there are no oceans or lakes on the surface so, if you set the value to 0.0 no entrances will be generated but, if you set it to 1.0, an entrance will be generated in all crossings with land on the surface.

"newMineSpawnChance": 0.15 (0.0 to 1.0)
To change the amount of new mines generated in empty chunks. 0 will not generate any new mine, only the main mine will be generated, if you set it to 1 every single chunk will have a mine generated.


⚠️IMPORTANT⚠️

If you want to add the mod to an existing world, please, make a backup before, it should not break anything but let's make sure ^^


Q. Does the mod works with .Net7?

A. Yes, it's developed and tested in the version 1.18.12 of the game, every time a new version is released I will test everything and keep you updated!

Q. Where can I ask something, report bugs or make suggestions?

A. You can ask anything you need, report any bug or suggest all the things you want in the Discord Server.

Project description from Vintage Story Mod DB.

Pick your setup

Underground Mines releases for each Vintage Story version.

Choose the version and loader you play, then open the matching release.

85 available setups

Showing the newest 12 of 85 game versions. Older files are in the list below.

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

Underground Mines versions and loaders

14 of 14 releases match

Looking for an older file? The official Vintage Story Mod DB project page is in Resources.