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

Retrogen

by Cat4blep · for Minecraft

Adds ores and structures from newly installed mods to existing chunks & worlds

1.8KDownloads
4 mo agoLast updated
LicenseRef-All-Rights-ReservedLicense
Fabric · NeoForgeLoaders

About Retrogen

From Modrinth

Adds ores and structures from newly installed mods to existing chunks & worlds

Retrogen

Add ores and structures from newly installed mods to your existing Minecraft world.

Retrogen is a server-side world-generation mod for Minecraft 1.21.1. It processes already generated chunks as they are loaded and adds compatible ores and structures from mods that were installed later.

Normally, new world-generation content only appears in unexplored areas. Retrogen allows you to continue using your existing world without travelling thousands of blocks just to find newly added resources or structures.

Features

  • Adds modded ores to existing chunks
  • Adds modded structures to existing chunks
  • Uses the original generation settings from the source mod
  • Preserves biome, height, frequency, spread, and block replacement rules
  • Supports imported and custom terrain
  • Can adjust surface structures to match the existing landscape
  • Processes chunks gradually to reduce server lag
  • Remembers completed generation attempts
  • Prevents repeated generation of the same content
  • Supports configurable include and exclude lists
  • Supports Fabric and NeoForge

Supported Versions

  • Minecraft 1.21.1
  • Fabric with Fabric API
  • NeoForge

Fabric and NeoForge use separate JAR files.

On a dedicated server, Retrogen only needs to be installed on the server. Players do not need to install it on their clients.

For single-player worlds, install Retrogen in the client’s mods folder.

How It Works

When an existing chunk is loaded, Retrogen adds it to a processing queue.

The chunk is processed only after it is fully loaded. Retrogen limits both the number of operations and the amount of processing time used during each server tick.

Ore generation uses the original PlacedFeature settings provided by the source mod. This means Retrogen keeps the intended:

  • generation height;
  • vein size;
  • frequency;
  • biome restrictions;
  • block replacement rules.

Structures are created through Minecraft’s standard structure-generation system.

Retrogen stores processed content inside each chunk and keeps the world’s generation history in:

data/retrogen_manifest.json

This prevents the same ore or structure from being generated every time the chunk loads.

Installation

  1. Back up your world.
  2. Install the correct Retrogen JAR.
  3. Install the mods that provide the new ores and structures.
  4. Start the server or single-player world.
  5. Check the processing queue with:
/retrogen status

For Fabric, Fabric API is also required.

Retrogen creates its configuration file automatically:

config/retrogen.json

Configuration

Default configuration:

{
  "enabled": true,
  "generateOres": true,
  "generateStructures": true,
  "adaptStructuresToExistingTerrain": true,
  "maxOperationsPerTick": 2,
  "maxMillisPerTick": 8,
  "structureReferenceRadius": 8,
  "maxTerrainShift": 96,
  "maxTerrainSampleSpread": 32,
  "maxInhabitedTimeTicks": -1,
  "automaticNamespaces": ["*"],
  "excludedNamespaces": ["minecraft", "retrogen"],
  "includePlacedFeatures": [],
  "excludePlacedFeatures": [],
  "includeStructures": [],
  "excludeStructures": []
}

Retrogen automatically selects standard modded ore features from allowed namespaces.

You can restrict automatic processing to specific mods:

{
  "automaticNamespaces": ["create", "alexscaves"]
}

You can also manually include or exclude individual features and structures:

{
  "includePlacedFeatures": [
    "example:underground_dungeon",
    "anothermod:*_ore"
  ],
  "excludePlacedFeatures": [
    "example:huge_test_ore"
  ],
  "includeStructures": [
    "minecraft:trial_chambers"
  ],
  "excludeStructures": [
    "example:unsafe_castle"
  ]
}

The lists support wildcard patterns:

  • * matches any number of characters;
  • ? matches one character.

Reload the configuration without restarting the server:

/retrogen reload

Custom and Imported Terrain

Ores are generated in the blocks that already exist inside the chunk.

A modded ore can only replace blocks accepted by the source mod’s generation rules. For example, an ore configured to replace normal Minecraft stone may not generate inside custom stone blocks.

Retrogen can also adjust surface structures to match the real terrain instead of relying only on the current chunk generator.

When enabled, Retrogen samples the existing surface or ocean floor and moves the structure vertically when necessary.

This is a best-effort system. Some unusual structures may still require special support from their original mod developer.

Important Warning

Always create a backup before using Retrogen.

Minecraft cannot reliably distinguish naturally generated blocks from blocks placed by players.

Ores normally replace only valid target blocks, but structures may intersect:

  • player buildings;
  • roads;
  • farms;
  • underground bases;
  • other edited terrain.

On its first installation, Retrogen may not know which modded ores were already present when older chunks were created. Existing modded worlds may therefore receive additional ore veins.

Use the include and exclude lists when working with an important world.

Limitations

Retrogen supports content registered through standard Minecraft world-generation systems such as:

  • BiomeGenerationSettings;
  • PlacedFeature;
  • StructureSet.

It cannot automatically reproduce content generated through completely custom mod events or independent generation systems.

Changing generation settings while keeping the same registry ID does not automatically trigger another generation pass.

Do not delete:

data/retrogen_manifest.json

This file stores the world’s Retrogen history.

Retrogen does not force-load distant chunks to complete structures. Very large structures may require both their starting chunk and distant piece chunks to be loaded at the same time.

Retrogen can move structures vertically, but it cannot regenerate natural terrain blending around them.

Read the full description on Modrinth →

Highlights

From source data

Game versions

Built for Minecraft 1.21.1.

Loaders

Runs on Fabric and NeoForge.

Footprint

Rated a light load on a server.

Retrogen on Nxeon

From our catalogue
One-click install
Supported on Nxeon Minecraft servers. We download it from Modrinth, place it, and restart the server.
Server side
Required on the server
Server type needed
Fabric, NeoForge
Server load
light
Smallest plan we suggest
Minecraft — 1.5 GB (2 GB RAM). This follows our own load rating above, not a benchmark.
Latest build
1.0, released 2026-07-13

Game versions by loader

LoaderGame versionsNewest
Fabric1.21.11.21.1
NeoForge1.21.11.21.1

From 2 recorded builds of Retrogen.

Recent builds

BuildReleasedGame versionsLoaders
1.02026-07-131.21.1NeoForge
1.02026-07-131.21.1Fabric

Run Retrogen on a Minecraft 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 Modrinth as “Mods”

World generation

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

Runs on your server

From source side support

Modrinth lists Retrogen as required on the server. Check its Modrinth page to see whether players need it too.

Compatibility

Game
Minecraft
Loaders
FabricNeoForge
Runs on
Serverrequired on the server
Game versions
1.21.1

Verified at the source

  • ✓ModrinthOfficial listing, checked 2026-10-17Open ↗
  • ✓AuthorCat4blep, as published on Modrinth
  • ✓LicenseLicenseRef-All-Rights-ReservedFree

Retrogen, answered

Generated from the mod’s own source data.

Do my players need to install Retrogen?

Modrinth lists Retrogen as required on the server. Check its Modrinth page to see whether players need it too.

Which loaders does it support?

Fabric and NeoForge.

Is it free?

Yes. Retrogen is free to download from Modrinth. Its license is LicenseRef-All-Rights-Reserved.

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 Retrogen on a Minecraft server.

Deploy in about a minute from $4.20 a month, then add Retrogen in one click.