Modscraper Modscraper Minecraft
FastMapCodec logo

FastMapCodec

Mod

Provides more efficient BaseMapCodec.decode implementation

Type

Mod

Modrinth Downloads

552

Modrinth ID

CN7axcWy

Last Updated

Oct 9, 2026

Description

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:

nekotxs/BaseMapCodec-bench

The fix has also been submitted upstream to Mojang's DataFixerUpper:

Mojang/DataFixerUpper#110

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.

Compatibility

Mod Loaders

Fabric Neoforge

Game Versions

1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 +7 more

Recommended Gear

Affiliate

Hardware and extras that pair well with this mod.

As an Amazon Associate I earn from qualifying purchases.

Similar Mods

Included in Modpacks (1)

External Resources