Skip to main content
Regions Unexplored is designed to work seamlessly with vanilla Minecraft and integrates with popular mods through its dependencies Biolith and Lithostitched.

​
Minecraft versions

Regions Unexplored follows a dual-version policy: maintaining an LTS (Long Term Support) version for stable modded ecosystems and a latest version for the newest Minecraft releases.

​
Currently supported

Minecraft VersionMod VersionStatusLoaders
1.21.10.6+indevActive DevelopmentFabric, NeoForge

​
Loader requirements

Minimum versions:
  • Fabric Loader: 0.18.4 or higher
  • Fabric API: 0.116.8 or higher
Recommended:
  • Latest stable Fabric Loader
  • Latest Fabric API for 1.21.1

​
Required dependencies

These dependencies are mandatory. Regions Unexplored will not function without them.

Biolith

Version: 3.0.10 or higherBiome placement and integration library. Handles how Regions Unexplored biomes are distributed throughout the world and ensures compatibility with other biome mods.

Lithostitched

Version: 1.5.7 for Minecraft 1.21.1World generation framework that enables advanced terrain features and ensures seamless integration with vanilla worldgen.

​
Dependency installation

1

Download the correct versions

Ensure you download versions matching your mod loader:
  • Fabric: biolith-fabric-3.0.10.jar, lithostitched-1.5.7-fabric-1.21.1.jar
  • NeoForge: biolith-neoforge-3.0.10.jar, lithostitched-1.5.7-neoforge-1.21.1.jar
2

Install alongside Regions Unexplored

Place all dependency .jar files in your mods folder together with Regions Unexplored.

​
Optional integrations

​
Mod Menu (Fabric only)

Mod Menu

Recommended for Fabric usersRegions Unexplored includes Mod Menu integration, providing:
  • In-game configuration screen access
  • Visual mod information display
  • Easy config file management
Integration class: net.regions_unexplored.compat.ModMenuIntegration

​
World Preview

The Fabric build includes optional runtime support for World Preview, allowing you to preview biome generation before creating a world.

​
Compatible with other mods

​
Biome and worldgen mods

Regions Unexplored uses Biolith for biome placement, which is specifically designed for multi-biome-mod compatibility.
Regions Unexplored works alongside other biome mods that use compatible worldgen systems:
  • Biomes O’ Plenty - Use together for 200+ total biomes
  • Terralith - Compatible when both use Biolith
  • William Wythers’ Overhauled Overworld - Works with proper config
  • Promenade - Full compatibility
  • Other Biolith-based biome mods
When using multiple biome mods, biomes will be distributed based on their configured weights and climate parameters. You may need to adjust configs for optimal distribution.
Some worldgen modification mods may cause conflicts:
  • Terrafirmacraft - Total conversion, incompatible
  • Custom terrain mods - May override biome placement
  • Older worldgen mods - Pre-1.18 worldgen systems incompatible
Always test mod combinations in a new world before committing to a long-term save.

​
Performance mods

Recommended performance mods:

Sodium

Rendering optimization - Highly Recommended

Lithium

Server/game logic optimization

Starlight

Lighting engine optimization

FerriteCore

Memory usage optimization
All tested and compatible with Regions Unexplored.

​
Quality of life mods

  • Nature’s Compass - Locate Regions Unexplored biomes easily
  • Xaero’s Minimap/World Map - Track explored biomes
  • JourneyMap - Full compatibility with biome display
  • Explorer’s Compass - Find structures in RU biomes
  • Complementary Shaders - Beautiful lighting with RU biomes
  • BSL Shaders - Tested and compatible
  • Dynamic Trees - May require compatibility datapack
  • Falling Leaves - Works with RU tree types
  • Macaw’s Fences/Bridges/etc - Full compatibility with RU wood types
  • Chipped - Can add variants of RU blocks
  • FramedBlocks - Use RU blocks as materials

​
Configuration

Regions Unexplored provides configuration files for both client and common settings.

​
Config files location

File paths
config/regions unexplored/regions_unexplored-client.toml
config/regions unexplored/regions_unexplored-common.toml

​
Configuration system

Regions Unexplored uses Night Config (TOML format) for configuration management. The config system is implemented in:
  • net.regions_unexplored.config.RuClientConfig
  • net.regions_unexplored.config.RuCommonConfig
Client-side settings that affect visual and performance aspects:
  • Particle effects
  • Rendering options
  • Visual preferences
Registered as: "regions unexplored/regions_unexplored-client"

​
In-game configuration

With Mod Menu (Fabric) or NeoForge mods screen:
1

Access the mods screen

  • Fabric: Click “Mods” in the main menu (requires Mod Menu)
  • NeoForge: Click “Mods” in the main menu
2

Select Regions Unexplored

Find “Regions Unexplored” in the mod list.
3

Open configuration

Configuration GUI is registered via ConfigScreenRegistry and displays both Client and Common settings.

​
System requirements

​
Minimum requirements

Minecraft: Java Edition 1.21.1
Java: Version 21 or higher
RAM: 4GB allocated to Minecraft
Storage: 500MB for mod files + world data
GPU: Integrated graphics capable of running vanilla Minecraft

Minecraft: Java Edition 1.21.1
Java: Latest Java 21 LTS
RAM: 6-8GB allocated to Minecraft
Storage: 2GB+ for mod files and world data
GPU: Dedicated graphics card (GTX 1050 or equivalent)
CPU: Quad-core processor (i5/Ryzen 5 or better)
Allocating more RAM helps with chunk generation and loading, especially when using multiple biome mods or large modpacks.

​
Performance considerations

Regions Unexplored generates detailed biomes with custom features, which can impact performance during initial world generation:
  • First-time generation: Expect slower chunk generation (30-50% longer than vanilla)
  • Subsequent loads: Normal performance once chunks are generated
  • Solution: Pre-generate chunks using mods like Chunky before playing
The mod adds:
  • 71 biome definitions
  • Hundreds of placed features and configured features
  • Custom block and item registries
  • World generation data
Typical memory footprint: 200-400MB additional RAM usage
For servers:
  • Pre-generate spawn area to reduce initial lag
  • Allocate 6-8GB RAM minimum for dedicated servers
  • Use performance mods on server-side (Lithium/Canary)
  • Monitor tick time during chunk generation

​
Troubleshooting compatibility issues

1

Identify the conflict

Check crash logs in the crash-reports folder or latest.log in the logs folder for error messages mentioning mod IDs.
2

Isolate the problem

Test with only:
  • Regions Unexplored
  • Biolith
  • Lithostitched
  • Fabric API (if using Fabric)
If the issue disappears, add other mods back one at a time.
3

Check for updates

Ensure all mods are the latest versions for Minecraft 1.21.1.
4

Report the issue

If you’ve confirmed an incompatibility, report it on the GitHub Issues page with:
  • Full mod list
  • Crash report or log file
  • Steps to reproduce
  • Minecraft and loader versions

​
Additional resources

Installation guide

Detailed installation instructions for both loaders

GitHub issues

Report bugs and compatibility problems

Modrinth page

Download the latest version

Source code

View the source code on GitHub

Build docs developers (and LLMs) love

Get started for freeTalk to us