ModsFinder

MC-249136 Fix

by fennifith

MC-249136 Fix targets the server lag spikes that occur when a server locates buried treasure and shipwreck structures for explorer maps.

FabricQuiltServer-side onlyGNU Lesser General Public License v3.0 onlyOpen source1.19 – 1.20.4

What it does

The mod implements a minimal workaround for MC-249136, a bug where locating buried treasure and shipwreck structures causes a significant server lag spike. Structure location is moved off the server tick loop onto a separate thread, so the work no longer stalls the tick. The author states that nothing else was changed to improve structure location performance, and the fix is limited to keeping gameplay from being significantly impeded.

Map rendering is changed as well. Minecraft's map color palette is costly to compute, so the mod draws the image using a fixed black color value instead of calculating colors, and pixels meant to be black are drawn as fully transparent pixels. A second change makes the handling of state persistence for loaded maps update once inside a player's inventory. The author notes that MC-249136 appears fixed in newer Minecraft versions and that treasure map problems on later releases should be reported on the issue tracker.

The mod runs on the server alone, so players join without installing it. It requires Fabric API and is published for Fabric and Quilt with files for this range. The latest file is 1.0.2 for 1.20.4, released 2023-12-09 on the beta channel. The code is open source under the GNU Lesser General Public License v3.0 only.

Key features

  1. Off-tick structure location

    Buried treasure and shipwreck structure lookups run on a separate thread instead of the server tick loop.

  2. Lighter map color handling

    Map images are drawn with a fixed black value and transparent pixels, avoiding the costly palette calculation.

  3. Inventory map state updates

    Loaded explorer maps update their persisted state once while they are inside a player's inventory.

  4. Issue tracker for newer versions

    Treasure map problems on later releases can be reported through the public issue tracker.

Compatibility

Latest build for each game version and loader.

No stable releases
Every published file is a beta or alpha build.
1.20.x5 of 5 versions with builds
1.20.41.0.21.0.2
1.20.31.0.21.0.2
1.20.21.0.21.0.2
1.20.11.0.21.0.2
1.201.0.21.0.2
1.19.x5 of 5 versions with builds
1.19.41.0.21.0.2
1.19.31.0.21.0.2
1.19.21.0.21.0.2
1.19.11.0.21.0.2
1.191.0.21.0.2
ReleaseBetaAlphaNot available

Only full game releases are shown. This mod publishes no snapshot builds.

Requirements

Dependencies declared by the latest file for each loader.

Required 1

Fabric APILightweight and modular API providing common hooks and intercompatibility measures utilized by mods using the Fabric toolchain.
Required

How it compares

Full comparison

Maps of the Unknown is also server-side only and open source under the MIT License, with Fabric and Quilt files for 1.18.2 – 26.3, a wider range than this mod's 1.19 – 1.20.4. BeeFix is server-side only and open source under the MIT License, covering 1.18.2 – 1.19 for Fabric and Quilt, so it targets an older range.

ModLoadersGame versionsEnvironmentUpdated
MC-249136 FixFabric and Quilt1.19 – 1.20.4Server-side only2023-12-09
Maps of the UnknownFabric and Quilt1.18.2 – 26.3Server-side only2026-09-23
BeeFixFabric and Quilt1.18.2 – 1.19Server-side only2022-09-22

Questions

Does MC-249136 Fix require Fabric API?

Yes. Fabric API is listed as a required dependency, and the mod is published for Fabric and Quilt.

Does a player need to install MC-249136 Fix?

No. Server owners install it, and players connect with no copy of their own.

Which Minecraft versions have files?

Files exist for 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3 and 1.20.4, with the latest file for 1.20.4.

In the catalog

MC-249136 Fix is one of 3,545 Optimization mods on ModsFinder, and one of 2,575 Optimization mods for Fabric. 13,907 mods support Minecraft 1.20.4.

More from fennifith

All projects

Similar mods

What the author says

MC-249136 appears to have been fixed in newer versions of Minecraft! As such, I've decided not to update this mod for 1.20.5-onwards. If you still encounter problems with treasure maps in 1.20.5+, please create an issue to let me know!
fennifith, on the Modrinth page

Official listing

Owner
fennifith
Published
2023-08-10
Updated on Modrinth
2023-12-09
Facts verified
2026-10-15

Tags