
Modrinth · Minecraft mod
FastMapCodec
Provides more efficient BaseMapCodec.decode implementation
Quick answer
Which FastMapCodec release matches 26.3?
FastMapCodec 1.0.4 targets 1.21, 1.21.1, 1.21.2 with NeoForge. Installation on the client is optional. Installation on the dedicated server is optional. No extra mods listed for this file.
Where it goes
Is FastMapCodec required on the client, server, or both?
Installation on the client is optional. Installation on the dedicated server is optional.
The source marks this as usable on both the client and server.
What else does FastMapCodec 1.0.4 need?
1.0.4 on 26.3. Every mod below is checked against that same setup.
This file does not list any required mods. Do not add a library just because a different file uses it.
This file does not list any required or optional mods.
Before you install it
Add FastMapCodec without breaking your instance.
Built for FastMapCodec 1.0.4 on 26.3. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use 1.0.4. It targets 1.21, 1.21.1, 1.21.2 with NeoForge; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
This file does not list any required mods. Do not add a library just because a different file uses it.
- 03
Put it on the correct side
Installation on the client is optional. Installation on the dedicated server is optional.
- 04
Pick the file you checked
Use the “Get this file” button beside 1.0.4. It opens that exact file at the source.
About this project
What does FastMapCodec add?
Mainly fixes TPS freeze on player join caused by large advancement files (and the same class of freeze anywhere else in the game, or in other mods, that arises from decoding a large map through DFU).
It is okay to use this mod on server only or client only.
Fixes O(N²) behavior in Mojang's BaseMapCodec (part of com.mojang:datafixerupper) when decoding large map-based Codecs. Since the fix lives in BaseMapCodec itself, it applies to every codec built on top of it - UnboundedMapCodec, SimpleMapCodec, and anything else sharing the same decode/encode logic - not just player advancements.
This bug was introduced in 1.21 and is present up to modern versions.
Benchmarks comparing this mod's fix to vanilla behaviour (with some context) are available here:
The fix has also been submitted upstream to Mojang's DataFixerUpper:
If Mojang accepts the PR, this mod won't be needed on newer versions.
NeoForge disclaimer
On NeoForge, this mod uses some cursed techniques to modify DFU behaviour, which may cause incompatibility with other mods. If you notice any issues, please open an issue on GitHub.
It is known to be incompatible with Sodium Extra.
This only applies to NeoForge — the Fabric version is not affected.
Project description from Modrinth.
Pick your setup
FastMapCodec by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
26.2
2 loader builds26.1.2
2 loader builds26.1.1
2 loader builds26.1
2 loader builds1.21.11
2 loader builds1.21.10
2 loader builds1.21.9
2 loader builds1.21.8
2 loader builds1.21.7
2 loader builds1.21.6
2 loader builds1.21.5
2 loader buildsShowing the newest 12 of 17 game versions. Older files are in the list below.
Check the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
FastMapCodec versions and loaders
1.0.4
fastmapcodec-neoforge-1.0.4.jar
18 Aug 2026
1.0.4
fastmapcodec-fabric-1.0.4.jar
18 Aug 2026
Looking for an older file? The official Modrinth project page is in Resources.