Chunk Preloader

⚠️ WARNING: THIS WILL CAUSE LAG AND LOWER YOUR TPS WHILE IT RUNS ⚠️

This mod generates a large number of chunks in the background. While it is actively generating (usually from the moment you first join a new world until the progress bar finishes), you should expect noticeably lower TPS, stutter, and general lag - this is expected, not a bug. The Max ms per tick setting controls the trade-off: higher values finish faster but cause more severe lag, lower values are gentler but take longer. On weaker hardware, or on a server with multiple players already online, keep this value low and expect the impact to be more noticeable. Performance returns to normal once the progress bar disappears.

Pregenerates the terrain around spawn the moment a new world starts, so you (and anyone else on the server) don't get chunk-loading stutter while exploring near spawn later. Progress is shown as a small bar in the top-right corner while it works, and it saves its progress per-world, so a restart resumes instead of starting over.

Features

• Automatic spawn pregeneration - as soon as the first player joins a new world, the mod starts generating a circular area of chunks around spawn in the background.
• Won't freeze your game - generation happens in small batches spread across ticks (configurable), instead of all at once.
• Progress HUD - a bar and percentage in the top-right corner shows how far along the preload is; it fades away a few seconds after finishing.
• Resumable - progress is saved per-world, so closing and reopening a world (or restarting a server) continues where it left off rather than restarting.
• In-game settings screen - adjust the radius, generation speed, and whether the HUD shows at all, without editing files by hand.
• Mod Menu support - the settings screen is also reachable from Mod Menu's mod list, if you have Mod Menu installed.

Requirements

• Minecraft 26.2
• Fabric Loader 0.19.0 or newer
• Fabric API
• Cloth Config (pulled in automatically as a dependency)
• Mod Menu (optional - only needed for the Mod Menu integration, not for the mod to function)

Installation

1. Install Fabric Loader for Minecraft 26.2 through your launcher.
2. Download Fabric API and Cloth Config, matching 26.2, and place both in your mods folder.
3. Place chunkpreload-1.0.0.jar in the same mods folder.
4. (Optional) Add Mod Menu to mods as well, if you'd like to reach the settings screen from the mod list instead of a keybind.
5. Launch with the Fabric profile.

How to open the settings

There are two ways to reach the settings screen:

• Keybind: go to Options → Controls, scroll to the "Chunk Preloader" category, and bind a key to "Open Chunk Preloader Config" (it's unbound by default - pick anything free). Press that key anytime in-game to open it.
• Mod Menu: if Mod Menu is installed, find "Chunk Preloader" in its mod list and click the settings/gear icon.

Settings

Setting	Default	What it does
Radius (chunks)	100	How far out from spawn to pregenerate, in chunks.
Max ms per tick	40	How much time per server tick may be spent generating. Higher finishes faster but risks lag spikes.
Show progress HUD	On	Toggles the top-right progress bar. Generation keeps running either way - this only hides the display.

Settings are also stored in config/chunkpreload.json if you'd rather edit them directly.

Good to know

• Changing the radius only affects worlds that haven't started preloading yet. An in-progress world keeps the total it originally locked in; to make an existing world use a new radius, its saved preload progress needs to be reset first.
• In singleplayer, opening the literal pause/Escape menu freezes the whole world (this is normal Minecraft behavior, not specific to this mod) - generation pauses along with everything else. Clicking into "Options" from the pause menu keeps things ticking. On a dedicated or LAN server, this doesn't come up at all.