promotional bannermobile promotional banner

WorldGen Editor

A Minecraft mod that allows you to control world generation directly in the game via a JSON file!
A tool that allows you to easily edit JSON with a preview of the approximate shape of the island! Tool github: https://github.com/waterflane/WorldGen-Editor-Preview

A tool that allows you to easily edit JSON with a preview of the approximate shape of the island! Tool github: https://github.com/waterflane/WorldGen-Editor-Preview

An image of how generation change looks in-game

An image of how generation change looks in-game

item image
waterflane | WorldGen Editor
Create a server, get 25% off your first monthaffiliate logo
Create Server
affiliate banner image

Description

WorldGen Editor

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

The WorldGen Editor Team

profile avatar
  • 4
    Projects
  • 3.1K
    Downloads

Hi, my name is Kirill, and I'm a Minecraft enthusiast. I make builds and sometimes post useful server mods. I'm also into coding and math.

Donate

More from waterflane

  • CraftRecall project image

    CraftRecall

    Client-side mod that recalls your last crafted recipe and reuses it with a saved, mouse-adjustable amount.

    • 22
    • July 22, 2026
  • Disabler project image

    Disabler

    A mod that allows you to block dimensions, items, and the spawning of mobs, structures, and biomes.

    • 2.5K
    • July 1, 2026
  • Copy Block ID project image

    Copy Block ID

    A minimal client-side utility that lets you copy hovered item, fluid, block, items in JEI/REI, block and entity IDs in world with Ctrl+C.

    • 209
    • June 27, 2026
  • CraftRecall project image

    CraftRecall

    Client-side mod that recalls your last crafted recipe and reuses it with a saved, mouse-adjustable amount.

    • 22
    • July 22, 2026
  • Disabler project image

    Disabler

    A mod that allows you to block dimensions, items, and the spawning of mobs, structures, and biomes.

    • 2.5K
    • July 1, 2026
  • Copy Block ID project image

    Copy Block ID

    A minimal client-side utility that lets you copy hovered item, fluid, block, items in JEI/REI, block and entity IDs in world with Ctrl+C.

    • 209
    • June 27, 2026