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