MapBoost

MapBoost

Map update frequency optimization mod — Fabric / NeoForge / Forge

Basic Info

| Property | Value |
|———-|——-|
| Mod ID | mapboost |
| Version | 1.0.0 |
| Author | mccmcaozr |
| License | All Rights Reserved (closed source) |
| Environment | Server (client optional) |
| Minecraft | >=1.21 (1.21 ~ 1.21.11, 26.1 ~ 26.2) |
| Java | 21+ |

Loader Support

| Loader | Minimum Version | JAR Filename |
|——–|—————–|————–|
| Fabric | Loader 0.15.0 + Fabric API | mapboost-fabric-1.0.0.jar |
| NeoForge | 21.1.236 | mapboost-neoforge-1.0.0.jar |
| Forge | 52.1.15 | mapboost-forge-1.0.0.jar |

Compatibility

• Recommended: Sodium, Lithium
• Optional: Iris, Xaero’s Minimap, Xaero’s World Map

Overview

MapBoost applies dynamic throttling to MapState.update (Mojang: MapItemSavedData.tickCarriedBy): refreshes more frequently when the player is moving, and reduces frequency when stationary.

Core Features

• MapUpdateScheduler with per-map independent intervals
• Player position-aware interval adjustment
• Globally unique mapId + cross-Mixin duck typing (MapStateIdAccess)
• Expired map cleanup
• Player disconnect cleanup
• Does not erroneously reset update timer during flush

Cross-Loader Mapping Differences

| Fabric (Yarn) | NeoForge/Forge (Mojang) |
|—————|————————|
| MapState | MapItemSavedData |
| FilledMapItem | MapItem |
| MapState.update | MapItemSavedData.tickCarriedBy |
| MapState.putColor | MapItemSavedData.setColor |
| FilledMapItem.getMapState | MapItem.getSavedData |
| World | Level |
| PlayerEntity | Player |
| BlockPos | BlockPos (unchanged) |

Installation

1. Install the corresponding loader (Fabric / NeoForge / Forge)
2. For Fabric, also install Fabric API
3. Place the JAR file for your loader into the mods folder