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

Underground Ruins

by warpalicious · for Valheim

Adds a new Blackforest dungeon with puzzles, randomly generated layouts, and vanilla-friendly progression.

60KDownloads
19 mo agoLast updated
BepInExLoaders
ThunderstoreSource

About Underground Ruins

From Thunderstore

Adds a new Blackforest dungeon with puzzles, randomly generated layouts, and vanilla-friendly progression.

Underground Ruins

Underground Ruins

This mod adds a new procedural dungeon to the Blackforest biome with 24 custom designed rooms, a random size & layout for each dungeon instance, and a custom puzzle system. Part of the More World Locations series, see below for more details. A big thank you to Ruijven and probablyKory for their immense contributions to this project.

Lore

"As the first travelers arrived in Valheim, they carved grand cities deep beneath the BlackForest. But the Elder’s roots slowly spread and devoured the pioneers. Now, only the hollow shell of their once-great legacy remains in the Underground Ruins."

Features

  • Adds a new dungeon to Blackforest biome.
  • Custom built puzzle system.
  • Utilizes the vanilla game dungeon generator to randomize size and layout of each dungeon instance.
  • Features 24 unqiue rooms designed with vanilla build pieces.
  • The dungeon fits into vanilla progression by offering an alternate route to acquire copper ore.
  • Configurability: Dungeon spawn quantities, creature spawn lists, chest loot lists, pickable loot lists.

Instructions

  • To add these locations to a non-existing world, no action is required. Ensure the mod is installed and create a new world.
  • To add these locations to an existing world, use the Upgrade World with the command below:

Command: locations_add BFD_Exterior start

Custom Creature Spawns

The creatures and loot are all customizable. Modded creatures and items are supported. To customize, create a new YAML file in the BepinEx configuration folder. If using mod manager, then use the BepinEx config folder in your profile folder. All mods from the More World Locations series will share the same Yaml file so you only need to create it once.

For creatures, each instance of the location will randomly select from the list of creatures in the the file. First, it will pick a random index (an item in the list), then it will increment through the list, assigning creatures to available creature spawners until each creature spawner has a creature. For the best results, scatter higher tier creatures throughout the list. You must use the creature's prefab name and not it's in-game name. See here for a list of vanilla creature prefab names: Creatures List

Creature file name: warpalicious.More_World_Locations_CreatureLists.yml Creature file structure:

UndergroundRuinsCreatures1:
  - Greydwarf
  - Greydwarf_Shaman
  - Greydwarf
  - Greydwarf_Elite
  - Greydwarf
  - Greydwarf
  - Greydwarf
  - Greydwarf_Elite
  - Greydwarf
  - Greydwarf
  - Greydwarf
  - Greydwarf_Shaman

Custom Loot Lists

For loot, as of 12/19/24 the loot list format has changed. If you're using an old format it will still work but you can't access the new customization feature. To access new customization feature, please convert to the new format below and ensure you include the verision number at top of file.

The new format works as such: 1 - Random roll for total loot slots available. Roll number between 1 - 3. There will be between 1 - 3 loot slots. 2 - For each loot slot, weighted-random selection for item from loot list. Randomly select item from list based on weights. 3 - For each item, random roll between stackMin and stackMax for loot stack amount.

Example for UndergroundRuinsContainers1 below: 1 - Random roll results in 2 loot slots 2 - Weighted-random selection for slot 1 = Amber 3 - Weighted-random selection for slot 2 = Coins 4 - Random roll for slot 1 stack size = 3 5 - Random roll for slot 2 stack size = 23 6 - Final loot in chest = 3 Amber, 23 Coins

Modded items are confirmed to work in the loot list.

Loot file name: warpalicious.More_World_Locations_LootLists.yml Loot file structure:

version: 2.0
UndergroundRuinsLoot1:
  - item: Amber
    stackMin: 1
    stackMax: 5
    weight: 1.5
  - item: Ruby
    stackMin: 1
    stackMax: 3
    weight: 1.0
  - item: Coins
    stackMin: 10
    stackMax: 30
    weight: 1.5

Custom Pickable Lists

The custom pickable lists function the same as the custom loot lists. They do not require the "version: 2.0" string at the top of the file. They require their own file with name: warpalicious.More_World_Locations_PickableItemLists.yml

Pickable file structure:

UndergroundRuinsPickables1:
  - item: Coins
    stackMin: 5
    stackMax: 20
  - item: AmberPearl
    stackMin: 1
    stackMax: 2
  - item: Ruby
    stackMin: 1
    stackMax: 3

More World Locations

The goal of the More World Locations series is to solve Valheims exploration problem. Valheim has a giant map but relatively few points of interest (POI) to find. Once a player learns that each biome is just a copy of what they've already seen, exploring the rest of the map feels unnecessary. The More World Locations series will fix this problem by adding dozens of handcrafted, unique, and interesting POIs to the Valheim world. I started developing the series in Febuary 2024 and have released the following mods in the series. See my mod author page for most up to date list.

Read the full description on Thunderstore →

Highlights

From source data

Loaders

Runs on BepInEx.

Footprint

Rated a light load on a server.

Last update

Its author last shipped an update 19 mo ago.

Underground Ruins on Nxeon

From our catalogue
One-click install
Supported on Nxeon Valheim servers, for BepInEx servers. We download it from Thunderstore, place it, and restart the server.
Server type needed
BepInEx
Server load
light
Smallest plan we suggest
Valheim — 2 GB (2 GB RAM). This follows our own load rating above, not a benchmark.
Latest build
1.0.8, released 2025-04-21

Game versions by loader

LoaderGame versionsNewest
BepInEx

From 9 recorded builds of Underground Ruins.

Recent builds

BuildReleasedGame versionsLoaders
1.0.82025-04-21n/aBepInEx
1.0.72025-03-20n/aBepInEx
1.0.62025-03-13n/aBepInEx
1.0.52025-03-13n/aBepInEx
1.0.42025-03-13n/aBepInEx
1.0.32025-03-11n/aBepInEx

Dependencies

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

Run Underground Ruins on a Valheim 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 Thunderstore as “Content”

World generation

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

Compatibility

Game
Valheim
Loaders
BepInEx
Requires
One-click install needs a BepInEx server.

Verified at the source

  • ✓ThunderstoreOfficial listing, checked 2026-10-16Open ↗
  • ✓Authorwarpalicious, as published on Thunderstore
  • ✓LicenseNot published by the sourceFree

Underground Ruins, answered

Generated from the mod’s own source data.

Which loaders does it support?

BepInEx.

Is it free?

Yes. Underground Ruins is free to download from Thunderstore.

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 Ruins on a Valheim server.

Deploy in about a minute from $6.50 a month, then add Underground Ruins in one click.