WorldPreview

Minecraft mod that displays a world preview on the loading screen during chunk generation.

Key Features:

• Legality for leaderboards - fully allowed for use in Java Edition record lists
• Full map required - to confirm a record, the entire generated chunk map must be shown in the recording
• Automatic F3 detection - switching to F3 + Esc menu automatically classifies your run as using F3
• Maximum compatibility - works with all allowed mods, including the newest versions of specnr's multi-instance macros and FinestPigeon's spawn reset macros for SSG modes

How It Works:

The mod makes no changes to the world generation process. It simply takes already generated chunks, converts them to a format the Minecraft client can display, and shows these chunks on the loading screen as a preview.

Server-Side:

On the server side, the only change is that Minecraft receives the random value for player spawn slightly earlier. Since randomness remains random, this doesn't affect the final outcome.

Important Limitations:

The reset system becomes blocked when the chunk map reaches 100% - this is intentionally implemented to maintain game balance.

Usage

The preview automatically activates when creating a new world.

Players can interact with the preview in five ways:

Direct Commands:

• Exit world generation: Pressing the "Save and exit to menu" button instantly interrupts generation and returns to the title screen
• F3 + Esc: Simultaneously pressing F3 and Esc switches to the F3+Esc menu mode - this will classify your run as using F3

Hotkeys: (customizable in Controls menu)

• Exit generation hotkey: Default "g" key (English layout) instantly interrupts world generation
• Cycle chunk map: "h" key toggles between 4 positions for displaying the chunk map
• Freeze preview: "j" key pauses preview updates (helps reduce CPU load)

For Macro Creators

The mod logs three message types:

• "Starting preview at (x, y, z)" - start of preview display (reset buttons unlocked)
• "Leaving world generation" - exiting world generation process (reset buttons locked)
• "Freezing Preview / Unfreezing Preview" - enabling/disabling preview freezing

The reset limitation remains - restarting becomes blocked when chunk map reaches 100%.