Skip to main content
Regions Unexplored uses TOML configuration files to customize biomes, worldgen features, and client-side settings. Configuration files are automatically generated when you first launch the game with the mod installed.

​
Configuration files

Two configuration files are available:

Common config

Server-side settings for biome toggles and worldgen features

Client config

Client-side settings for visual effects and UI preferences

​
File locations

Configuration files are stored in your game directory’s config folder: 
config/regions_unexplored-common.toml
config/regions_unexplored-client.toml

​
How configuration works

1

Automatic generation

Config files are created automatically on first launch with default values and helpful comments
2

Edit values

Open the .toml files in any text editor and modify values according to the comments
3

Apply changes

Most changes require a game restart to take effect. The config files include “Requires restart” notes for settings that need it

​
Configuration structure

The configuration system uses annotations to organize settings into categories:
  • overworld_biome_toggles - Enable/disable individual overworld biomes
  • overworld_cave_biome_toggles - Enable/disable cave biomes
  • nether_biome_toggles - Enable/disable nether biomes
  • worldgen_surface_rules - Control surface generation features
  • client_options - UI and visual preferences
  • particles - Particle effect settings
  • block_color_options - Color customization for special blocks
All configuration values include default values, range restrictions (for numeric values), and comments explaining their purpose in the generated TOML files.

​
Validation and safety

The configuration system includes built-in validation:
  • Type checking - Values are validated against expected types
  • Range validation - Numeric values are clamped to allowed ranges
  • Automatic recovery - Invalid values fall back to defaults with warnings in the log
  • Automatic updates - Missing keys are added automatically when the config is loaded

​
Examples

config/regions_unexplored-common.toml
[overworld_biome_toggles]
# Set to false to disable the Baobab Savanna biome
TOGGLE_BAOBAB_SAVANNA = false

​
Reloading configuration

Configuration changes require a full game restart to take effect. The mod does not support hot-reloading of configuration files during gameplay.
To apply configuration changes:
  1. Save your changes to the TOML file
  2. Close Minecraft completely
  3. Restart the game
  4. Check the logs for any configuration warnings or errors

​
Troubleshooting

If configuration changes aren’t working:
Launch the game at least once to generate the default configuration files. They will be created automatically in the config folder.
Ensure you:
  • Saved the TOML file after making changes
  • Completely restarted the game (not just returned to the main menu)
  • Check the game log for any configuration errors
Check the logs for specific error messages. The config system will:
  • Log warnings about type mismatches
  • Log info about missing keys being added
  • Use default values when loaded values are invalid
Delete the config file to regenerate it with defaults if needed.
TOML files use specific syntax. Common mistakes:
  • Strings should be in quotes: "value"
  • Booleans are lowercase: true or false
  • Decimals need a decimal point: 1.0 not 1
  • Section headers use brackets: [category_name]

Build docs developers (and LLMs) love

Get started for freeTalk to us