SANDBOX — this is a test environment. No servers are actually deployed and no real payments are charged.
Source-checkedWorld generation

Underground Mines

by XurxoMF · for Vintage Story

This mod adds infinite underground mines and mineshafts.

36KDownloads
1.18.10Latest game version
Vintage Story ModDBSource

About Underground Mines

From Vintage Story ModDB

This mod adds infinite underground mines and mineshafts.

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.

Highlights

From source data

Game versions

Supports 11 Vintage Story versions, the newest being 1.18.10.

Footprint

Rated a light load on a server.

Underground Mines on Nxeon

From our catalogue
One-click install
Supported on Nxeon Vintage Story servers. We download it from Vintage Story ModDB, place it, and restart the server.
Server side
Required on the server
Server load
light
Smallest plan we suggest
Vintage Story — 1 GB (1 GB RAM). This follows our own load rating above, not a benchmark.

Run Underground Mines on a Vintage Story server

Pick a server or deploy a new one above; it is installed in one click.

What kind of mod it is

From the catalog
Listed on Vintage Story ModDB as “Worldgen”

World generation

Changes or adds to how new terrain, biomes and structures are created.

Runs on your server

From source side support

Vintage Story ModDB lists Underground Mines as required on the server. Check its Vintage Story ModDB page to see whether players need it too.

Compatibility

Game
Vintage Story
Runs on
Serverrequired on the server
Game versions
1.18.10 and 10 earlier

Verified at the source

  • ✓Vintage Story ModDBOfficial listing, checked 2026-09-24Open ↗
  • ✓AuthorXurxoMF, as published on Vintage Story ModDB
  • ✓LicenseNot published by the sourceFree

Underground Mines, answered

Generated from the mod’s own source data.

Do my players need to install Underground Mines?

Vintage Story ModDB lists Underground Mines as required on the server. Check its Vintage Story ModDB page to see whether players need it too.

Is it free?

Yes. Underground Mines is free to download from Vintage Story ModDB.

How do I add it to my Nxeon server?

Use “Add to a server” on this page, or open NxLabs from your dashboard. We install it, restart your server and switch it on.

NxLabs

Run Underground Mines on a Vintage Story server.

Deploy in about a minute from $4.00 a month, then add Underground Mines in one click.