Description
Recommended mods
FastMiniMap
FastMiniMap is a server-side minimap HUD for Hytale. Terrain rendering, HUD delivery, and live updates all happen on the server, so players do not need a separate client mod just to see the minimap.
The mod is designed to work cleanly with MultipleHUD and other HUD mods without taking over the only custom HUD slot.
Features
- North-up terrain minimap rendered from WorldMap chunk tiles
- Rounded or circular minimap styles with configurable border color, thickness, and corner radius
- Configurable center marker color with optional static diamond or directional pointer mode
- Optional cardinal labels and coordinate bar
- Per-player world-scoped profiles with an in-game
/minimapsettings page - MultipleHUD coexistence without fighting for the default HUD slot
- Per-player background sessions so the minimap does not run on the main game thread
- Separate terrain, overlay, and marker update paths to reduce unnecessary churn
- Seamless live chunk refreshes that reuse the last good tile instead of flashing black
- Mob overlay when MobMapMarkers is installed
- Player overlay when PlayerAvatarMarker is installed
- Resource-backed localization for the HUD and settings page
Configuration
Config path: UserData/Saves/<World>/plugins/FastMiniMap/fastminimap-config.json
Player-profile path: UserData/Saves/<World>/plugins/FastMiniMap/player-settings/<player-uuid>/<world-key>.json
| Key | Default | Description |
|---|---|---|
schemaVersion |
2 |
Config schema version written by FastMiniMap for future migrations |
anchorPreset |
"TOP_RIGHT" |
Default HUD corner for new player profiles |
hudOffsetRight |
24 |
HUD right edge offset in pixels |
hudOffsetTop |
24 |
HUD top edge offset in pixels |
displaySize |
220 |
Terrain image size in pixels (128-320) |
visibleRadiusBlocks |
50 |
Half-width of the visible area in blocks |
tickIntervalMs |
50 |
Render-check interval in milliseconds |
settingsCommandEnabled |
true |
Enables or disables opening the in-game settings GUI with /minimap |
showPlayerMarker |
true |
Show the center marker |
showPlayerMarkerPointer |
false |
Replace the center marker with a directional pointer |
showCardinals |
true |
Show the N / E / S / W labels |
showCoordsBar |
true |
Show the coordinate bar below the map |
showMobOverlay |
true |
Enable mob markers from provider mods |
showPlayerOverlay |
true |
Enable player avatar overlays from provider mods |
borderColor |
"D4A843" |
Map border color as hex RRGGBB or AARRGGBB |
centerMarkerColor |
"E04444" |
Center marker color as hex RRGGBB or AARRGGBB |
borderThickness |
3 |
Border stroke thickness in pixels |
cornerRadius |
18 |
Rounded minimap corner radius in pixels |
mapShape |
"ROUNDED" |
Minimap shape: ROUNDED or CIRCLE |
Player-specific settings are stored separately per world and can be changed instantly in game with /minimap when settingsCommandEnabled is true.
Commands
/minimapopens the FastMiniMap settings page whensettingsCommandEnabledistrue- FastMiniMap intentionally has no permission layer; the config flag is the only public gate
Compatibility
- Standalone: fully functional without any other mods
- Coexists with MultipleHUD when it is installed
- Gains mob overlay with MobMapMarkers installed
- Gains player avatar overlay with PlayerAvatarMarker installed
FastMiniMap owns the minimap terrain, HUD, center marker, session loop, and overlay compositing. MobMapMarkers provides mob dots and mob icons for the minimap provider surface, and PlayerAvatarMarker provides player avatar dots and avatar images for that same provider surface.