Chunky Pregeneration Guide: mustard.gorgarath.net
This document records the Chunky pregeneration settings and procedures used for creating and maintaining the mustard.gorgarath.net modded Minecraft world dimensions.
The goal of pregeneration is to:
- Reduce server lag caused by first-time chunk generation.
- Prevent players exploring new terrain from competing with normal server activity.
- Allow Distant Horizons to provide smoother long-distance views.
- Account for additional terrain generation from mods.
These values are based on the current modded server configuration and hardware environment and may require adjustment if the modpack, player count, storage capacity, or server hardware changes significantly.
This document should be updated when world-generation settings, pregeneration procedures, supported dimensions, or server generation requirements change.
Important: Pregenerated chunks retain the terrain, biome, and structure generation produced when they were generated. Changes to world-generation mods, datapacks, or world-generation configuration do not retroactively regenerate existing chunks. Pregeneration should therefore be performed after the world-generation configuration has been finalized.
Document Scope
This document covers:
- Chunky pregeneration procedures for the currently supported dimensions.
- Recommended generation centers, radii, and related operational guidance.
- Steps to follow after world-generation configuration changes.
- Final pregeneration values used to prepare the world for play.
It does not document general modpack configuration, Pterodactyl resource allocation, or JVM startup settings. Those are documented separately.
Pregeneration Procedure
Before starting pregeneration:
- Confirm the server has sufficient storage space available.
- Confirm current performance settings are appropriate.
- Stop normal player activity if possible.
- Perform pregeneration during a maintenance window if possible.
- Complete the fresh-world preparation and actual pack-priority checks before accepting a new world for pregeneration. A prepared initial selection alone does not guarantee highest priority over every dynamically registered pack.
All nine recommended selections are square. Center the Overworld with
chunky spawn; center the other eight dimensions at 0,0. Set the world,
shape, center and radius explicitly for each task rather than inheriting
a previous selection. These are recommended targets, not claims that generation
has completed; retain the actual selection and completion records for prior runs.
Dimension identifiers used below should match the namespace IDs registered by the server. Verify these values against the active mod configuration if dimensions are added, removed, renamed, or changed.
Chunk generation performance may be affected by:
- CPU allocation and pinning.
- C2ME configuration.
- Java memory settings.
- Server performance configuration.
- Active server workloads.
Overworld
The Overworld remains the exception to origin-based centering: use the actual
world spawn point. Select the Overworld and square shape, then run chunky spawn
before setting the radius so Chunky uses the server's current world spawn.
Run:
chunky world minecraft:overworld
chunky shape square
chunky spawn
chunky radius 7500
chunky start
Recommended Overworld radius:
7500 blocks
Reasoning:
- Covers the primary player exploration area.
- Supports Distant Horizons usage.
- Reduces terrain-generation spikes during exploration.
- Accounts for large modded world-generation, including:
- Terralith
- Tectonic
- Regions Unexplored
- Dynamic Trees
- Structure generation mods
- Additional biome and world-generation mods
Approximate generation area:
- Square region extending approximately 7,500 blocks from the center in each direction.
- Bounding area of approximately 15,000 × 15,000 blocks.
- Approximately 880,000 chunks generated within the configured square radius.
Nether
The Nether does not require chunky spawn.
The Nether is centered at 0,0 to provide predictable coverage around the dimension origin and support portal travel.
Run:
chunky world minecraft:the_nether
chunky shape square
chunky center 0 0
chunky radius 2000
chunky start
Recommended Nether radius:
2000 blocks
Reasoning:
- Provides a large portal network area.
- Equivalent to approximately 16,000 Overworld blocks of travel.
- Covers common exploration distances.
- Avoids unnecessary generation of unused terrain.
The End
The End should be centered at 0,0.
Run:
chunky world minecraft:the_end
chunky shape square
chunky center 0 0
chunky radius 3000
chunky start
Recommended End radius:
3000 blocks
Reasoning:
- Provides additional exploration space beyond the dragon island.
- Supports additional End generation from mods.
- Accounts for:
- Better End
- Additional structures and biome generation
Aether
The Aether should be centered at 0,0.
Run:
chunky world aether:the_aether
chunky shape square
chunky center 0 0
chunky radius 3000
chunky start
Recommended Aether radius:
3000 blocks
Reasoning:
- Modded dimensions often spread structures farther apart.
- Players are likely to explore the dimension rather than only visit briefly.
- Reduces generation spikes during exploration.
The Bumblezone
The Bumblezone should be centered at 0,0.
The dimension is centered around generated hive structures and unique terrain rather than a traditional overworld-style spawn area. Centering at the origin provides predictable coverage for exploration and resource gathering.
Run:
chunky world the_bumblezone:the_bumblezone
chunky shape square
chunky center 0 0
chunky radius 1500
chunky start
Recommended Bumblezone radius:
1500 blocks
Reasoning:
- Provides sufficient exploration space for normal gameplay.
- Covers a large area around the central hive structures.
- Reduces generation delays while exploring the dimension.
- Avoids excessive storage usage for a dimension that is typically visited less frequently than the primary dimensions.
Deeper Darker Otherside
The Deeper Darker Otherside should be centered at 0,0.
Unlike the Overworld, the Otherside dimension does not require spawn-based centering. The origin provides predictable coverage for dimension exploration and allows players to encounter generated structures and terrain without requiring a large unnecessary pregeneration area.
Run:
chunky world deeperdarker:otherside
chunky shape square
chunky center 0 0
chunky radius 2500
chunky start
Recommended Deeper Darker Otherside radius:
2500 blocks
Reasoning:
- Provides enough exploration space for sculk-based terrain and structures.
- Reduces generation spikes when exploring the dimension.
- Accounts for the dimension being primarily exploration-focused rather than a primary building area.
- Balances pregeneration time and storage requirements against expected usage.
Twilight Forest
The Twilight Forest should be centered at 0,0.
The dimension is a major exploration and progression area containing large structures, dungeons, bosses, villages, and additional world-generation content. Centering at the origin provides predictable pregeneration coverage before player-created portals and exploration routes have been established.
Run:
chunky world twilightforest:twilight_forest
chunky shape square
chunky center 0 0
chunky radius 3000
chunky start
Recommended Twilight Forest radius:
3000 blocks
Reasoning:
- Provides a large exploration area for Twilight Forest progression.
- Covers significant biome, structure, dungeon, and boss-generation space.
- Accounts for additional Twilight Forest structure generation and village content.
- Reduces generation spikes during progression and long-distance exploration.
- Balances pregeneration time and storage requirements against expected usage.
Eternal Starlight
Eternal Starlight should be centered at 0,0.
The dimension is a large exploration-focused world containing numerous biomes, structures, resources, and progression content. Centering at the origin provides predictable coverage before player-created exploration patterns have been established.
Run:
chunky world eternal_starlight:starlight
chunky shape square
chunky center 0 0
chunky radius 3000
chunky start
Recommended Eternal Starlight radius:
3000 blocks
Reasoning:
- Provides a substantial exploration area across the dimension's varied biomes.
- Supports exploration of Eternal Starlight structures, resources, and progression content.
- Accounts for Trial Chamber generation being relocated from the Overworld into Eternal Starlight.
- Reduces generation spikes during long-distance exploration.
- Balances pregeneration time and storage requirements against expected usage.
The Sweetland
The Sweetland should be centered at 0,0.
The dimension is a secondary exploration area with Overworld-like terrain, including multiple biomes, mountains, oceans, structures, and unique mobs. Centering at the origin provides predictable pregeneration coverage before player exploration begins.
Run:
chunky world test:sweetland
chunky shape square
chunky center 0 0
chunky radius 2000
chunky start
Recommended Sweetland radius:
2000 blocks
Reasoning:
- Provides sufficient exploration space for the dimension's biomes and structures.
- Reduces generation delays while exploring the dimension.
- Supports normal exploration without pregenerating an unnecessarily large secondary dimension.
- Balances pregeneration time and storage requirements against expected usage.
After Configuration Changes
If changing:
- CPU pinning.
- C2ME settings.
- Java memory settings.
- Server performance settings.
Before stopping or restarting the server:
save-all flush
Stop the server cleanly.
After restarting, check progress:
chunky progress
Resume an existing task:
chunky continue
Optional console reduction:
chunky quiet 60
This reduces Chunky progress messages while allowing generation to continue and helps keep the logs cleaner.
Recommended Final Values
| Dimension | Radius (blocks) | Center | Shape |
|---|---|---|---|
| Overworld | 7,500 | chunky spawn |
Square |
| Nether | 2,000 | 0,0 |
Square |
| The End | 3,000 | 0,0 |
Square |
| Aether | 3,000 | 0,0 |
Square |
| The Bumblezone | 1,500 | 0,0 |
Square |
| Deeper Darker Otherside | 2,500 | 0,0 |
Square |
| Twilight Forest | 3,000 | 0,0 |
Square |
| Eternal Starlight | 3,000 | 0,0 |
Square |
| The Sweetland | 2,000 | 0,0 |
Square |
Related Documentation
The following documents provide additional information about the server configuration and world-generation environment.
| Document | Purpose |
|---|---|
server-environment.md |
Server deployment configuration, resources, storage, and environment settings |
server-startup.md |
JVM arguments, Java runtime configuration, and startup settings |
server-configuration.md |
Non-default server and game-related configuration changes |
modpack.md |
Modpack role and world-generation context |
server-management.md |
Future-world rebuild and maintenance workflow |
server-backup-strategy.md |
Backup considerations before world-generation operations |
Change History
2026-10-19
- Completed the nine-dimension recommendation table and made square selections explicit, retaining spawn-based Overworld centering and origin-based centering for the other eight dimensions; preserved the distinction from previous generation records.
- Linked fresh-world preparation and effective full-pack priority verification before pregeneration.
2026-09-25
- Linked the modpack, server-management, and backup-strategy documents for world-rebuild planning.
2026-09-19
- Standardized document structure and Markdown style to match repository conventions.
2026-08-23
-
Added pregeneration guidance for Twilight Forest, Eternal Starlight, and The Sweetland following expansion of the server's supported dimensions.
-
Documented recommended pregeneration radii and origin-centered generation for the new dimensions. Updated Eternal Starlight guidance to account for Trial Chambers being relocated from the Overworld into the Eternal Starlight dimension.
2026-08-22
- Reviewed and updated pregeneration recommendations for the current server configuration.
2026-08-03
-
Reviewed and updated pregeneration recommendations for the current server configuration.
-
Documented dimension namespace verification, corrected Chunky generation area calculations, clarified pregeneration procedures, and updated operational guidance for configuration changes.
2026-07-26
-
Updated documentation structure to match the infrastructure documentation format.
-
Documented current Chunky pregeneration procedures, supported dimensions, recommended generation values, and operational considerations.