Modrinth · Fabric · Client mod

FastPackLoad

FastPackLoad is a client-side mod. Install it on your computer; the server does not need it.

Faster resource pack loading, and no more freeze when you join a server with a big pack. Client-side only, no Fabric API needed.

Downloads
4.1K
Author
ItzStanleex
Loader
Fabric
Minecraft
1.21.10 – 26.3
Updated
–

Setup

Install FastPackLoad on your client

Client-side mods only run on your computer. More server RAM does not change their performance.

  1. 01

    Install the loader locally

    Install Fabric for your Minecraft version in your launcher.

  2. 02

    Download the file

    Download the FastPackLoad file for your loader and your exact Minecraft version, for example 26.3.

  3. 03

    Add it to the mods folder

    Put the .jar file in your local .minecraft/mods folder and remove older duplicates.

  4. 04

    Launch

    Launch Minecraft with the loader profile. Nothing needs to change on the server.

On the server
Not needed
On the client
Required
Loader
Fabric
Minecraft
26.3, 26.2, 26.1.2 +4 more
License
LicenseRef-All-Rights-Reserved

Releases

Published releases

Pick the file that matches your server’s loader and Minecraft version. The server and players need the same release.

FastPackLoad · Modrinth
Original description by the project author

FastPackLoad

Vanilla does a lot of unnecessary resource pack work on the render thread. With a large
server pack that shows up as a multi-second freeze when you join or switch servers, sometimes
long enough for Windows to grey the window out as "not responding".

FastPackLoad removes most of that work.

What it changes

Pack discovery runs in parallel. Vanilla opens every pack and parses its metadata one at
a time, on the main thread, before the loading screen even appears.

Zip packs are indexed once. Vanilla walks the whole archive every time a reloader asks
about a resource folder, rebuilding and decoding every entry name on each pass.

Font work comes off the render thread. Glyph coverage is resolved across cores, and with
hundreds of fonts it is resolved by a different algorithm entirely. A warm-up loop that only
does anything for TrueType fonts is skipped when a pack has none.

Atlas mipmaps are generated across cores. Vanilla builds every sprite's mipmaps in a
single task on one worker, while the rest of the reload pool has nothing to do.

The loading screen stops waiting around. A finished reload still sits through a grace
period and a fade, up to three seconds of nothing. That one is a behaviour change, so it has
its own switch.

A vanilla race is fixed. The lazy ZipFile handle in the pack reader is unsynchronised,
even though a reload reads packs from several threads at once. That can leak a file handle
per race, or hand a reader an archive another thread just closed, which surfaces as
IllegalStateException: zip file closed part-way through loading.

Measured

On a server whose pack ships 746 font providers:

before after
Render thread frozen 4384 ms 448 ms
Full reload ~7.2 s ~3.7 s

Your numbers will differ. Packs that are light on fonts have less to gain.

When it still freezes

A watchdog samples the render thread and, if frames stop arriving, logs the stack it is stuck
in, along with the package that stack points at. Every reload also logs a short summary of
what blocked and for how long, so a slow pack can be pointed at instead of guessed about.

Notes

Client-side only; nothing is required on the server. No Fabric API dependency. Every change
can be switched off individually in config/fastpackload.json if you need to rule something
out.

FAQ

FastPackLoad questions

Question not listed? Ask our team.

Does FastPackLoad need to be installed on the Minecraft server?

No. Modrinth marks FastPackLoad as unsupported on the server side. Install it only in your local mods folder. Your server can stay unchanged unless the project page lists an additional dependency.

Which version and loader does FastPackLoad require?

Use a file for Fabric and your exact Minecraft version. Supported versions include 26.3, 26.2, 26.1.2. Files for different loaders are not interchangeable.

FastPackLoad is not working – what should I check?

First check the Minecraft version, loader version and required dependencies. Because the mod is client-side, more server RAM will not fix it.

Looking for mods for your own server?

The catalog lists mods that run on Minecraft servers.

Browse all mods