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

Caves

by CaveGrinder · for Factorio

Adds a cave system to the game that contains the resources instead of the normal surface.

32Downloads
9 yr agoLast updated
UnlicenseLicense
Factorio Mod PortalSource

About Caves

From Factorio Mod Portal

Adds a cave system to the game that contains the resources instead of the normal surface.

This is yet another caves mod (called Caves) Warning: alpha version, read carefully...

This mod by default moves most resources into a cave system. Rather than generating ores on the surface, they will only generate in a cave, which can be accessed via cave entrances. Here the player can mine them, and transport them out (through cave exits) via conveyer belts. You can configure via settings which resources are in the cave and which are on the surface; the default is that crude-oil is only on the surface and stone is present in both the surface and the cave.

Note: using it along other resource generation mods like RSO will not work.

Cave entrances transport 4 things:

  1. Items can be transported via belts. On the left side, items are moved from the surface to the cave. On the right side, items are transported from the cave to the surface.
  2. Players are teleported in the middle
  3. pollution that is found in the cave is spread outside to the surface.
  4. cave entrances and exits act similar to accumulators, power is transferred from the surface to the cave. Just connect

them via poles.

Cave entrances can be created out of wood and stone, and are found on the first tab. When you place an entrance (and when you mouse over one), you see a preview of the mines so you can see where you could place the entrance. (you get entrances back if you deconstruct it)

Notes: This is still an alpha version; so before basing a playthrough on it, please try it first if it works for your configuration. Since the mod so far was only tested in singleplayer, desyncs could be possible. Also i have so far only tested the early and mid game. I don't recommend adding or removing this mod on the fly, since i think a clean migration is probably not possible. (ores on the surface are deleted) The graphics for the entrance, exit and cave walls are pretty bad. If you have some talent, feel free to create a mod to override them (i would also happily integrate them, but keep in mind that this mod is put into the public domain for everyone to do whatever they like with it) Transportation of liquids is currently not possible, use barrels on belts instead ( i didn't want to make the cave entrance any wider than it currently is) Modded ores are supported, as far as i can tell anyway, as long as standard autogen is used. I tested vanilla, bob's and angel ores. The mod simply uses the same settings as for the main surface, so anything that is created there should appear in the cave instead, without any need for configurations. However, keep in mind that the cave walls can drastically reduce how much of the ores you can reach, and they could be awkwardly placed, so i recommend using larger ore settings. There are no biters in the cave by default. But beware when leaving the cave since you don't really know if the cave exit is right in the middle of a biter base. You can enable biters to spawn in the cave via a setting. I don't know if new modded enemies work as expected. RSO will probably not work together with this mod! The chunk generation used is a bit time-consuming, i had to split it over 16 ticks. For me now i don't notice any lag any more, but let me know how it is for you. cave-generation seems to be lagging in multiplayer however. Note that the cave entrances for the starting area will appear once the cave is generated, which might take a minute. Cave generation is tied to surface generation, so when you explore on the surface, more of the cave is generated (and the other way around too). (also note that factorio seems to generate 1 chunk per second when not exploring, which then means more caves to generate, so if you encouter periodic stuttering, this could be it) The cave is essentially infinitely large, more chunks are generated on demand.

incompatible mods: any mod that spawns resources itself, e.g. RSO AAI pathfinding has trouble finding paths in the caves. playing them together is possible but more frustrating then needed. (no other mods mentioned so far, but who knows)

mods which work with restrictions: Building Platform (no platforms will spawn in the cave. also caves must be configured to spawn "building-platform" on the surface.)

credits, notes and thanks:

factorio devs MagmaMcFry for Factorissimo, which illustrated how to get players, items and power across surfaces Earendel for Water Fix, where i saw how to create proper round corners with transparencies Emmote for fewerTrees, for the idea of how to get rid of them (in the cave) this cave generator is an implementation of bitbased for the graphics and code suggestions http://www.jimrandomh.org/misc/caves.html using the parameters of the Cellular Automata generator from http://www.futuredatalab.com/proceduraldungeon/ Neemys for supporting with fixing compatibility problems

Version history: 0.1.7 added compability with building-platform mod. note: no platforms spawn within the caves (as of now). you should configure the caves mod so that the "building-platform" spawns on the surface, as per default it would not. 0.1.6 feature: it can now be configured which resources are spawned above and below ground via mod settings. (existing maps keep the "cave-only" setting for all resources) feature: mine exits can be crafted, placed and mined now, so you can also tunnel out elsewhere. a similar cave-view is present to give a preview where you would end up. change: to place exits or entrances, now 1 block must also be left below the entrance. (to avoid another getting stuck situation when tunelling out). belts are ignored however so replacing an entrance works in most cases. 0.1.5 bug fixes: fix accidential overworld resource deletetion (affected users who didn't start their map with this mod) fix north-facing entrance possibly locking the player in the cave. now a 1 wide gap must be left while placing. fixed the player teleportation placing the player off center

Read the full description on Factorio Mod Portal →

Highlights

From source data

Footprint

Rated a light load on a server.

License

Published under Unlicense.

Last update

Its author last shipped an update 9 yr ago.

Caves on Nxeon

From our catalogue
One-click install
Supported on Nxeon Factorio servers. We download it from Factorio Mod Portal, place it, and restart the server.
Server side
Required on the server
Server load
light
Smallest plan we suggest
Factorio — 2 GB (2 GB RAM). This follows our own load rating above, not a benchmark.
Latest build
0.1.7, released 2017-10-23

Recent builds

BuildReleasedGame versionsLoaders
0.1.72017-10-230.15n/a
0.1.62017-08-120.15n/a
0.1.52017-08-050.15n/a
0.1.42017-07-150.15n/a
0.1.32017-07-040.15n/a
0.1.22017-07-030.15n/a

Dependencies

Declared by the newest build that lists any. Required ones are installed with it on one-click installs.

Run Caves on a Factorio 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 Factorio Mod Portal as “Mods”

World generation

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

Runs on your server

From source side support

Factorio Mod Portal lists Caves as required on the server. Check its Factorio Mod Portal page to see whether players need it too.

Compatibility

Game
Factorio
Runs on
Serverrequired on the server

Verified at the source

  • ✓Factorio Mod PortalOfficial listing, checked 2026-10-17Open ↗
  • ✓AuthorCaveGrinder, as published on Factorio Mod Portal
  • ✓LicenseUnlicenseFree

Caves, answered

Generated from the mod’s own source data.

Do my players need to install Caves?

Factorio Mod Portal lists Caves as required on the server. Check its Factorio Mod Portal page to see whether players need it too.

Is it free?

Yes. Caves is free to download from Factorio Mod Portal. Its license is Unlicense.

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 Caves on a Factorio server.

Deploy in about a minute from $2.99 a month, then add Caves in one click.