Genesis - World Previewer & Pregenerator

🤖 AI Disclosure

Genesis is made by Alkeari.

AI is solely used for the following items:

• Minimal assistance with code: bug fixes and updates
• Restructuring code for organization and clarity
• README
• Changelog
• Translations

One file per loader covers Minecraft 1.14 to 26.3 on Fabric, 1.14.4 to 26.3 on Forge, with a separate Forge file for 1.12.2, and 1.20.2 to 26.3 on NeoForge; Requirements lists the few versions Forge skips.

⭐ What It Does

The Map

• A biome map before you create the world - the GENESIS button on Create New World samples the real generator with your seed and every installed mod.
• Readable in seconds - coarse passes fill the view first, on up to 4 background threads, never more than 30 percent of your processor's.
• Sampled above the terrain - so cave biomes never bleed into the surface map.
• Every biome has a color - modded ones included, with a live legend.
• Pan, zoom and measure - from 25 chunks across to thousands, with a scale bar and a coordinate and biome readout under the cursor.
• Export the map - EXPORT MAP saves the view as a labeled PNG in Pictures/Genesis.
• Readable at any size - every screen keeps its proportions at any GUI Scale and window size.

Structures

• Find structures before you go - marked where the seed places them and named on hover. Terrain can stop one, so a mark is a likely spot.
• Markers that leave the map visible - show or hide structure groups, and nearby structures fold into numbered markers.
• From Minecraft 1.18.2 - older versions show biomes alone; Forge 1.12.2 marks the base game's structures.

Layers, Seed and Spawn

• Choose what the map draws - the LAYERS panel switches biome colors, borders, the legend, markers, overlays and each structure group, with Clean, Explorer and All presets.
• Choose your spawn - right-click the map to place the new world's spawn point; RESET goes back to the world's own.
• Seed tools - type a seed, RANDOM for a fresh one, COPY to the clipboard. Leaving the screen writes the seed back to Create New World.

Your Current World

• A map of the world you are playing - press G in game for a biome map of your current dimension, in singleplayer or on a server running Genesis.

Pre-Generation

• Pre-generate before you play - choose a radius and thread count, then follow a bar with a chunk counter and an ETA.
• On your terms - PAUSE, RESUME, CANCEL, or ENTER WORLD to keep it running behind a HUD.
• Or use commands - /genesis pregen with cancel, pause, resume and status, plus /genesis info.

On Minecraft 1.12.2

• Its own Forge build - the same map, world map and pre-generation in a simpler form, with a Gentle, Normal or Fast speed in place of threads.
• Simpler screens - eight fixed zoom steps, a shorter Layers panel and settings list, and an approximate spawn mark on the preview.

Accuracy

• Honest about what it cannot read - a spot whose biome cannot be read is drawn gray, and an Accuracy section marks anything approximate in amber and says why.

📋 Requirements

• Minecraft 1.14 to 26.3 on Fabric, and 1.13.2 on Legacy Fabric with its own file (LEGACY-FABRIC).
• Minecraft 1.12.2 with its own file, 1.14.4, 1.15 to 1.15.2, 1.16.1 to 1.16.5, 1.17.1, 1.18 to 1.20.4, 1.20.6, 1.21, 1.21.1 and 1.21.3 to 26.3 on Forge, including the NeoForge 1.20.1 fork.
• Minecraft 1.20.2 to 26.3 on NeoForge.
• Fabric API and Cloth Config on Fabric from 1.14, with Fabric Loader 0.20.1 or later, which covers every version. Legacy Fabric 1.13.2 needs neither; its settings are in the config file.
• Forge's build for your Minecraft version, such as 14.23.5 on 1.12.2, 28 or later on 1.14.4, 36 or later on 1.16.5, 47.1 or later on 1.20.1 and 66 or later on 26.3.
• NeoForge's build for your Minecraft version, such as 20.4 or later on 1.20.4, 21.0 or later on 1.21 and 1.21.1, and 26.3.0 or later on 26.3.
• The Java your Minecraft version runs on: 8 through 1.16.5, 16 on 1.17 and 1.17.1, 17 on 1.18 to 1.20.4, 21 on 1.20.5 to 1.21.11, and 25 from 26.1.

📥 Installation

1. Install your loader, plus Fabric API and Cloth Config if you are on Fabric.
2. Install with the CurseForge app, or download the jar for your loader into your mods folder. Each loader's jar works on every Minecraft version listed for it above.
3. Open Create New World. A GENESIS button sits on the screen.

⚙️ Configuration

Every setting is on the Genesis Settings screen: open it from the Layers panel of either map, from the Config button in the mod list on Forge and NeoForge, or from Mod Menu on Fabric if you have it.

The files hold the same settings: config/genesis-client.toml, and config/genesis-common.toml for the server_ settings and check_for_updates, on Forge or NeoForge, and config/genesis.json on Fabric. Each default is in parentheses.

• Screens - ui_size (0): 0 sizes every Genesis screen to the window, 1 to 3 make it larger.
• Preview - preview_enabled (true), preview_threads (0, the mod chooses), and three radii in chunks: preview_initial_radius (64), preview_expand_radius (16), preview_max_radius (192).
• Maps - spawn_from_map (true), show_structures (true), map_default_zoom (4), map_zoom_in_limit (25), map_zoom_out_limit (0.2), map_coarsest_step (8).
• Markers and overlays - marker_icon_size (11), marker_coverage_cap (25), overlay_readout_corner (top_left), overlay_scale_bar_corner (bottom_left).
• Export - export_pixels_per_chunk (4), export_grid_blocks (512).
• Pre-generation - pregen_default_radius (128), pregen_default_threads (4), hud_position (top), hud_width_percent (60).
• Server world map - server_world_map (true), server_world_map_structures (true). Off keeps the world's layout from players.
• Server pre-generation - server_pregen_shape (square), server_pregen_max_radius (2048), server_pregen_max_threads (16).
• Server pauses - server_pregen_pause_with_players (false), server_pregen_pause_mspt (0), server_pregen_pause_free_memory_mb (0). 0 never pauses.
• Updates - check_for_updates (true): once per game start, reads https://alkeari.com/updates/genesis.json and says in chat when a newer Genesis is out. Nothing else is sent.

Forge 1.12.2 keeps a shorter list under the same names in config/genesis-112.properties, with the Layers panel's choices.

A change on the settings screen takes effect when you go back to the map, and a number outside its range keeps the value it had.

🖥️ Compatibility

• Existing worlds. The preview only runs on the Create New World screen, so it changes nothing about a world you already have. Pre-generation can be pointed at one from a command.
• Client or server. The biome preview is client-side and safe to install on the client alone. Pre-generation, choosing the spawn point and the world map need Genesis on the server too; singleplayer already has it.
• It does not touch generation. The preview reads the generator; it changes no chunk, structure or loot table.
• GeoGradient is detected automatically: the map shows its latitude-based climate bands from your GeoGradient settings. At its default globe size a band spans thousands of blocks, so zoom out to see them.
• Superflat previews exactly. Other custom generators are drawn with vanilla climate and marked approximate on the map.
• Commands are operator level 2 on a server and unrestricted in singleplayer; status and info are open to everyone.

🐛 Support

• Leave a comment on this page.
• Include your Minecraft version, your loader and its version, the mod version, and your other mods.
• The mod's text is also in German, Spanish, French, Italian, Japanese, Korean, Polish, Brazilian Portuguese, Russian and Simplified Chinese.
• Those translations are machine written; if a line reads wrong, say which one and how it should read.

📄 License

License terms are in the Alkeari License Agreement.

Every release, its changes and how to send feedback are on the project page at alkeari.com/projects/genesis.

If you want to see how it works, you can read the source code at github.com/Alkeari/Genesis-PUBLIC.

💛 Donate

If you would like to donate, you can do so on Ko-fi, Patreon, PayPal, Stripe, GitHub Sponsors or Buy Me a Coffee.

🤖 AI Disclosure

Genesis is made by Alkeari.

AI is solely used for the following items:

• Minimal assistance with code: bug fixes and updates
• Restructuring code for organization and clarity
• README
• Changelog
• Translations

One file per loader covers Minecraft 1.14 to 26.3 on Fabric, 1.14.4 to 26.3 on Forge, with a separate Forge file for 1.12.2, and 1.20.2 to 26.3 on NeoForge; Requirements lists the few versions Forge skips.

⭐ What It Does

The Map

• A biome map before you create the world - the GENESIS button on Create New World samples the real generator with your seed and every installed mod.
• Readable in seconds - coarse passes fill the view first, on up to 4 background threads, never more than 30 percent of your processor's.
• Sampled above the terrain - so cave biomes never bleed into the surface map.
• Every biome has a color - modded ones included, with a live legend.
• Pan, zoom and measure - from 25 chunks across to thousands, with a scale bar and a coordinate and biome readout under the cursor.
• Export the map - EXPORT MAP saves the view as a labeled PNG in Pictures/Genesis.
• Readable at any size - every screen keeps its proportions at any GUI Scale and window size.

Structures

• Find structures before you go - marked where the seed places them and named on hover. Terrain can stop one, so a mark is a likely spot.
• Markers that leave the map visible - show or hide structure groups, and nearby structures fold into numbered markers.
• From Minecraft 1.18.2 - older versions show biomes alone; Forge 1.12.2 marks the base game's structures.

Layers, Seed and Spawn

• Choose what the map draws - the LAYERS panel switches biome colors, borders, the legend, markers, overlays and each structure group, with Clean, Explorer and All presets.
• Choose your spawn - right-click the map to place the new world's spawn point; RESET goes back to the world's own.
• Seed tools - type a seed, RANDOM for a fresh one, COPY to the clipboard. Leaving the screen writes the seed back to Create New World.

Your Current World

• A map of the world you are playing - press G in game for a biome map of your current dimension, in singleplayer or on a server running Genesis.

Pre-Generation

• Pre-generate before you play - choose a radius and thread count, then follow a bar with a chunk counter and an ETA.
• On your terms - PAUSE, RESUME, CANCEL, or ENTER WORLD to keep it running behind a HUD.
• Or use commands - /genesis pregen with cancel, pause, resume and status, plus /genesis info.

On Minecraft 1.12.2

• Its own Forge build - the same map, world map and pre-generation in a simpler form, with a Gentle, Normal or Fast speed in place of threads.
• Simpler screens - eight fixed zoom steps, a shorter Layers panel and settings list, and an approximate spawn mark on the preview.

Accuracy

• Honest about what it cannot read - a spot whose biome cannot be read is drawn gray, and an Accuracy section marks anything approximate in amber and says why.

📋 Requirements

• Minecraft 1.14 to 26.3 on Fabric, and 1.13.2 on Legacy Fabric with its own file (LEGACY-FABRIC).
• Minecraft 1.12.2 with its own file, 1.14.4, 1.15 to 1.15.2, 1.16.1 to 1.16.5, 1.17.1, 1.18 to 1.20.4, 1.20.6, 1.21, 1.21.1 and 1.21.3 to 26.3 on Forge, including the NeoForge 1.20.1 fork.
• Minecraft 1.20.2 to 26.3 on NeoForge.
• Fabric API and Cloth Config on Fabric from 1.14, with Fabric Loader 0.20.1 or later, which covers every version. Legacy Fabric 1.13.2 needs neither; its settings are in the config file.
• Forge's build for your Minecraft version, such as 14.23.5 on 1.12.2, 28 or later on 1.14.4, 36 or later on 1.16.5, 47.1 or later on 1.20.1 and 66 or later on 26.3.
• NeoForge's build for your Minecraft version, such as 20.4 or later on 1.20.4, 21.0 or later on 1.21 and 1.21.1, and 26.3.0 or later on 26.3.
• The Java your Minecraft version runs on: 8 through 1.16.5, 16 on 1.17 and 1.17.1, 17 on 1.18 to 1.20.4, 21 on 1.20.5 to 1.21.11, and 25 from 26.1.

📥 Installation

1. Install your loader, plus Fabric API and Cloth Config if you are on Fabric.
2. Install with the Modrinth App, or download the jar for your loader into your mods folder. Each loader's jar works on every Minecraft version listed for it above.
3. Open Create New World. A GENESIS button sits on the screen.

⚙️ Configuration

Every setting is on the Genesis Settings screen: open it from the Layers panel of either map, from the Config button in the mod list on Forge and NeoForge, or from Mod Menu on Fabric if you have it.

The files hold the same settings: config/genesis-client.toml, and config/genesis-common.toml for the server_ settings and check_for_updates, on Forge or NeoForge, and config/genesis.json on Fabric. Each default is in parentheses.

• Screens - ui_size (0): 0 sizes every Genesis screen to the window, 1 to 3 make it larger.
• Preview - preview_enabled (true), preview_threads (0, the mod chooses), and three radii in chunks: preview_initial_radius (64), preview_expand_radius (16), preview_max_radius (192).
• Maps - spawn_from_map (true), show_structures (true), map_default_zoom (4), map_zoom_in_limit (25), map_zoom_out_limit (0.2), map_coarsest_step (8).
• Markers and overlays - marker_icon_size (11), marker_coverage_cap (25), overlay_readout_corner (top_left), overlay_scale_bar_corner (bottom_left).
• Export - export_pixels_per_chunk (4), export_grid_blocks (512).
• Pre-generation - pregen_default_radius (128), pregen_default_threads (4), hud_position (top), hud_width_percent (60).
• Server world map - server_world_map (true), server_world_map_structures (true). Off keeps the world's layout from players.
• Server pre-generation - server_pregen_shape (square), server_pregen_max_radius (2048), server_pregen_max_threads (16).
• Server pauses - server_pregen_pause_with_players (false), server_pregen_pause_mspt (0), server_pregen_pause_free_memory_mb (0). 0 never pauses.
• Updates - check_for_updates (true): once per game start, reads https://alkeari.com/updates/genesis.json and says in chat when a newer Genesis is out. Nothing else is sent.

Forge 1.12.2 keeps a shorter list under the same names in config/genesis-112.properties, with the Layers panel's choices.

A change on the settings screen takes effect when you go back to the map, and a number outside its range keeps the value it had.

🖥️ Compatibility

• Existing worlds. The preview only runs on the Create New World screen, so it changes nothing about a world you already have. Pre-generation can be pointed at one from a command.
• Client or server. The biome preview is client-side and safe to install on the client alone. Pre-generation, choosing the spawn point and the world map need Genesis on the server too; singleplayer already has it.
• It does not touch generation. The preview reads the generator; it changes no chunk, structure or loot table.
• GeoGradient is detected automatically: the map shows its latitude-based climate bands from your GeoGradient settings. At its default globe size a band spans thousands of blocks, so zoom out to see them.
• Superflat previews exactly. Other custom generators are drawn with vanilla climate and marked approximate on the map.
• Commands are operator level 2 on a server and unrestricted in singleplayer; status and info are open to everyone.

🐛 Support

• Report bugs and ask questions on this mod's Nexus Mods page, where every report is tracked.
• Include your Minecraft version, your loader and its version, the mod version, and your other mods.
• The mod's text is also in German, Spanish, French, Italian, Japanese, Korean, Polish, Brazilian Portuguese, Russian and Simplified Chinese.
• Those translations are machine written; if a line reads wrong, say which one and how it should read.

📄 License

License terms are in the Alkeari License Agreement.

Every release, its changes and how to send feedback are on the project page at alkeari.com/projects/genesis.

If you want to see how it works, you can read the source code at github.com/Alkeari/Genesis-PUBLIC.