?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
WorldGen Editor

WorldGen Editor

A Minecraft mod that allows you to control world generation directly in the game via a JSON file!

94
3
94
3

Compatibility

Minecraft: Java Edition

1.21.1

Platforms

Supported environments

Server-side
Singleplayer

Links

Report issues View source Visit wiki
Donate on Patreon

Tags

Creators

Details

Published 3 weeks ago

WorldGen Editor

Replace this with a description Source Patreon

WorldGen Editor is a Minecraft world generation mod for creating island worlds from simple JSON preset files.

It is made for players, server owners, and modpack developers who want configurable archipelago-style worlds without rebuilding a full custom datapack by hand. The mod keeps Minecraft's normal noise generation as the base, then routes the Overworld through island-aware biome and density logic.

What It Does

  • Adds datapack-style world presets for island generation.
  • Adds three bundled world types:
    • WGE: Islands
    • WGE: Archipelago
    • WGE: Small Island
  • Adds configurable preset files in config/worldgen_editor/presets/.
  • Adds a main config file: config/worldgen_editor/worldgen_editor.json.
  • Supports island, ocean, and archipelago entry types.
  • Supports normal islands, ocean-carved straits/bays, and generated archipelago clusters.
  • Supports custom position, radius, stretch, rotation, base shape, coastline roughness, temperature, biome patch size, and noise settings.
  • Supports per-entry biome exclusions using exact biome ids and biome tags.
  • Supports climate-aware land and ocean fallback biome selection.
  • Supports configurable outer ocean biome, defaulting to minecraft:deep_ocean.
  • Keeps terrain generation soft, so islands still use vanilla-style terrain instead of flat forced shapes.
  • Keeps caves, ores, structures, vanilla surface logic, and terrain features as close to normal Minecraft generation as possible.
  • Includes a separate developer previewer for checking island layouts before generating a Minecraft world.

Main Config

The main file is:

config/worldgen_editor/worldgen_editor.json

{
  "enabled": true,
  "active_preset": "archipelago"
}

Preset files are stored here:

config/worldgen_editor/presets/default.json
config/worldgen_editor/presets/archipelago.json
config/worldgen_editor/presets/small_island.json

The bundled presets are:

  • default: a mixed example with a spawn island, an ocean cut, a larger island, and a warm archipelago.
  • archipelago: a spawn archipelago with many smaller islands plus extra islands around it.
  • small_island: one compact island for simple survival starts or testing.

Preset priority is:

world type preset > config active_preset > legacy continents.json

That means a world created with WGE: Archipelago uses presets/archipelago.json, even if the global config fallback says "active_preset": "default".

Basic example:

in previewer: i1

in game: i2

For a full explanation of all fields, see wiki in the GitHub.

How To Use

  1. Install the correct mod jar for your loader.
  2. Start Minecraft once so the config files can be created.
  3. Edit one of the files in config/worldgen_editor/presets/.
  4. Create a new world and select WGE world types, where you edited:
WGE: Islands
WGE: Archipelago
WGE: Small Island

If you edit the config while a world is already open, run:

/worldgen_editor reload

Reload affects only newly generated chunks. Existing chunks are not rebuilt.

Previewer

WorldGen Editor also has a separate previewer tool for development. It helps tune island positions, sizes, coastlines, roughness, ocean cuts, and archipelago layouts before opening Minecraft and generating a new test world.

WorldGen Editor preview github

The previewer is intended as a helper for planning layouts. Minecraft's final terrain still depends on vanilla world generation, the selected seed, and the active world preset.

Commands

/worldgen_editor enable
/worldgen_editor disable
/worldgen_editor status
/worldgen_editor preset <name>
/worldgen_editor reload

status shows the effective state, global config flag, per-world flag, selected world type preset, active preset, entry count, active config path, and world-state path.

preset <name> changes the config fallback preset. If the world was created with a WGE world type, that world type remains the main source of truth for newly generated chunks.

Notes

  • The mod is intended for new worlds.
  • Existing chunks are not automatically regenerated.
  • For clean results after major config changes, create a new world or delete the affected region files carefully.
  • continents.json is only a legacy fallback for old configs. New configs use worldgen_editor.json and presets/*.json.
  • The previewer is a helper tool for developers and modpack makers. It is not required to play with the mod and does not simulate every part of Minecraft world generation.

Links