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.
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
Off-tick structure location
Buried treasure and shipwreck structure lookups run on a separate thread instead of the server tick loop.
Lighter map color handling
Map images are drawn with a fixed black value and transparent pixels, avoiding the costly palette calculation.
Inventory map state updates
Loaded explorer maps update their persisted state once while they are inside a player's inventory.
Issue tracker for newer versions
Treasure map problems on later releases can be reported through the public issue tracker.
Gallery
Compatibility
Latest build for each game version and loader.
1.20.x5 of 5 versions with builds
1.19.x5 of 5 versions with builds
Only full game releases are shown. This mod publishes no snapshot builds.
Requirements
Dependencies declared by the latest file for each loader.
Required 1
How it compares
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.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| MC-249136 Fix | Fabric and Quilt | 1.19 – 1.20.4 | Server-side only | 2023-12-09 |
| Maps of the Unknown | Fabric and Quilt | 1.18.2 – 26.3 | Server-side only | 2026-09-23 |
| BeeFix | Fabric and Quilt | 1.18.2 – 1.19 | Server-side only | 2022-09-22 |
Questions
Does MC-249136 Fix require Fabric API?
Does a player need to install MC-249136 Fix?
Which Minecraft versions have files?
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
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!
Official listing
- Modrinth page
- modrinth.com/mod/mc-249136-fix
- Owner
- fennifith
- Published
- 2023-08-10
- Updated on Modrinth
- 2023-12-09
- Facts verified
- 2026-10-15
