World Pre Generator Mod — Guide

Mechanics

World Pre Generator operates by hooking into the server's chunk loading system. Unlike standard exploration, it processes chunks in a controlled queue to prevent memory overflows.

Generation Modes

1. SERIAL: This is the default and safest mode. It generates one chunk at a time, ensuring the server remains responsive to other tasks. It is recommended for low-spec servers.
2. SEMI_PARALLEL: This mode initiates multiple chunk generation tasks simultaneously. While Minecraft's engine (as of 1.20.1+) still processes the actual generation serially, this mode reduces the overhead between chunks, significantly increasing overall speed.

Task Persistence

One of the mod's most powerful features is its ability to survive restarts. If a server crashes or is shut down during a 10,000-block radius generation, the mod will pick up exactly where it left off once the server is back online. This is handled via a dedicated data file stored within the world folder.

Memory Safety

The mod monitors the server's available RAM. If the memory usage exceeds safe thresholds, the generator will temporarily throttle its speed to allow the Garbage Collector to clear unused objects, preventing OutOfMemory (OOM) crashes.

Technical Specifications

Compatibility

• Modded Biomes: Fully compatible with Biomes O' Plenty, Terrablender, and Oh The Biomes You'll Go.
• Modded Dimensions: Works with The Twilight Forest, Blue Skies, and Aether dimensions.

Performance Tips

• Pre-Launch Generation: It is best practice to run the pre-generator while no players are online to allow the mod to utilize maximum CPU resources.
• Disk Space: Be aware that pre-generating a large radius (e.g., 20,000+ blocks) will significantly increase the world file size. Ensure your hosting plan has sufficient SSD/HDD space before starting a massive task.
• Radius Calculation: A radius of 1,000 chunks results in a 32,000 x 32,000 block area, which is usually sufficient for most survival communities.