Description
Features
- Surface & Cave Maps — Displays detailed terrain with automatic switching between surface and underground views.
- Cave Navigation — Features elevation shading, distinct water and lava colors, and a focused 2× cave zoom.
- Customizable Minimap — Choose from four map sizes, multiple surface zoom levels, square or circular shapes, and rotating or fixed orientations.
- Interactive Positioning — Adjust map placement using an interactive canvas and fine position controls.
- Appearance Settings — Customize border thickness, border color, and optional compass display.
- Entity & Location Markers — Display nearby mobs, players, graves, and Hytale map markers using icons or colored dots.
- Dynamic Entity Markers — Features smoother movement, adjustable marker scaling, hostile mob colors, and distance-based fading.
- Customizable Info Panel — Display coordinates, direction, biome, weather, time, player statistics, and other useful information.
- Tabbed Settings GUI — Customize your minimap through an organized menu with live previews and Save/Reset controls.
- Per-Player Settings — Each player can customize their own minimap independently.
- Singleplayer & Multiplayer Support — Designed for personal worlds and dedicated servers.
How to Use
Use /minimap to open the settings menu.
Customize your map's size, shape, orientation, placement, appearance, markers, and information panel.
Choose between three terrain modes:
- Auto — Automatically switches between surface and cave views.
- Surface — Always displays the surface map.
- Cave — Always displays nearby underground terrain.
Cave maps use a fixed 2× zoom for clearer navigation. Your selected surface zoom is restored when returning above ground in Auto mode.
Press Save to apply your settings. Changes remain a draft until saved.
Configuration
Green Minimap provides an in-game settings GUI with dedicated tabs for map customization, appearance, positioning, markers, and information display.
Available options include map sizing, zoom, orientation, border styling, compass visibility, entity markers, marker scaling, and screen positioning.
The optional information panel can display coordinates, direction, chunk, zone, biome, world, weather, day/time, health, stamina, oxygen, mana, signature energy, game mode, and player count.
Fit Background to Text adjusts the information panel to fit its enabled content.
Settings are saved separately for each player and are preserved between sessions.
Installation
- Place the mod .jar inside: AppData\Roaming\Hytale\UserData\Mods
- Enable the mod inside of your world settings.
- Start or restart the server/world.
For dedicated multiplayer servers, place the JAR inside the server's mods folder and restart the server.
Use /minimap to open the settings menu.
Important Notes
- Cave rendering uses nearby loaded terrain and does not force distant terrain to load.
- Previously available terrain remains visible while replacement map tiles load.
- Hostile mobs are displayed with red markers, while passive or defensive mobs use green markers.
- Entity markers fade when moving outside the nearby height range to reduce clutter between cave levels.
- Existing Hytale map markers are managed through the normal world map.
- Reset All resets draft settings. Press Save to keep the changes.
- Optional plugin logging and diagnostics are disabled by default.
Support & Usage
If you encounter an issue, please include your Hytale log and relevant config.yml settings when reporting it.
Consider following MrGreenGames if you enjoy this mod! 💚
🟢 Feel free to use this mod in your modpacks and videos!
If you feature the mod in a video or showcase, linking back to the original mod page in your description is greatly appreciated, but not required.
🔴 Please do not redistribute or repurpose the mod.
You may not reupload the mod to other websites, launchers, or platforms, nor reuse its models, textures, data, or other assets in separate projects.
Do not place the mod behind ad-based or redirect services such as AdFly, and do not sell the mod or include it in any paid modpack.
💚 This mod is intended to remain free and accessible to everyone.


