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
MapUpdateSchedulerwith 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
- Install the corresponding loader (Fabric / NeoForge / Forge)
- For Fabric, also install Fabric API
- Place the JAR file for your loader into the
modsfolder
