How Better Chunk Loading Works

Chunk loading is one of the biggest sources of lag when you fly, sprint, or travel by rail. The server has to generate and stream terrain faster than you can move through it, and that race shows up as stutter, missing ground, and chunk walls popping into view. Better Chunk Loading tackles this from two angles at once.

First, it watches your movement and predicts where you are heading, then pre-loads the chunks in that direction asynchronously. Instead of reacting after you have already arrived, the server stays a step ahead, so terrain is ready before you get there. Second, it makes the vanilla chunk loading around a player lazier and less reactive, shrinking the area that gets constantly loaded and unloaded as you move. Less churn means less work for the server thread and a smoother ride for you.

What You Can Configure

Every feature has its own toggle, and the key values are exposed in a single config file. You can tune the size and distance of the prediction area that gets pre-loaded ahead of you, how aggressively the vanilla loaded area around a moving player gets resized to match your speed, and whether each individual feature is on or off.

You will find the config at config/betterchunkloading.json inside your main instance folder. Edit it, restart the server, and the new values take effect.

Server-Side Only, No Client Install

One of the nicer things about this mod is that it only needs to live on the server. Players connecting with a vanilla client, or with whatever modpack they already run, do not have to install anything extra. That makes it a low-friction add for a survival server, a network, or a modpack where you do not want to dictate what clients run. The one thing you do need is the Cupboard library, which this mod depends on. Drop both jars into the server mods folder and you are set.

Need a refresher on getting a server modded in the first place? The how to install Minecraft mods guide walks through the basics, and the Minecraft Fabric and Minecraft Forge pages cover each loader's server setup. For a very different take on chunk progression, the Chunk By Chunk mod starts you with a single chunk and unlocks more as you play.

Is It Still Being Maintained?

The last release is from April 2025. That is over a year ago at the time of writing, so do not expect fresh builds for brand new Minecraft versions without checking the project page yourself. The mod is stable on the versions it targets, and the source repo is still up if you want to read the code or report issues, but it is not seeing regular updates.

Frequently Asked Questions

Does it help with single-player lag?

It can. Single-player runs an internal server, so the same chunk-loading gains apply. The effect is most noticeable when you are moving fast, like flying with an elytra or riding a fast horse.

Do I need to install it on my client?

No. It is a server-side mod, so only the server needs the jar. Clients connect normally with no extra setup.

What is the Cupboard dependency?

Cupboard is a small library the mod uses internally. You install it like any other mod by placing the jar in the mods folder alongside Better Chunk Loading.

Can I use it with other performance mods?

Yes. The mod lists no known incompatibilities, and it plays well with optimization staples. It targets a different bottleneck than chunk-generation threading mods, so the two approaches stack instead of competing.

Will it reduce how far I can see?

No. It changes when and how aggressively chunks load, not the render distance you have configured. Distant terrain still loads, just in a smarter order.