BetterMap

Hytale BetterMap Plugin

Enhance your world exploration with saved map data, customizable zoom, waypoints, shared mapping, and performance-optimized rendering.

Blacked out map issue using new hytale version

Please update to our latest version of our mod the 1.2.6 and check if you don't have any other mods that are not currently working properly in the new release. Here is our list we got so far of mods not working properly:

HyWay-v2.9.2

SeePlayersOnCompass

HyMarkers-1.0.0

Party Info & Pings by carsonkompon (PartyPlugin-1.5.3)

Maptrail (before the Maptrail 1.1.3 version)

partypro-0.6.9.jar

Landmark-0.0.5.jar

hytalede-safezone-0.4.0.jar

FriendWaypoint

Hytale Pre-release Version

If you need the pre-release version of our mod (that can't be compatible with the current release version of Hytale unfortunately) please join our discord server or download it from this other small independent platform in which we trust (Orbis.place) if you don't want to join our discord. Our discord link

What is this?

By default, the Hytale in-game map is fleeting. It only displays a small circular area around the player, and as soon as you walk away, the map "forgets" where you have been.

Hytale BetterMap changes this. This server plugin introduces a saved exploration feature. As you travel through the world, the plugin records the areas you have visited, effectively removing the "fog of war" permanently. Your map grows bigger the more you explore, allowing you to retrace your steps and navigate with ease.

Key Features

Persistent Exploration: The map retains all previously visited areas across sessions. Data is saved automatically to prevent loss during server crashes.

Waypoint System: Never lose a location again. Open the waypoint menu to add markers at your current position, customize their names and colors, and share them with other players. (Note: Global shared waypoints are now back in v1.2.3)

Teleport: Players with permission can teleport directly to their saved waypoints.

Linked Exploration (Shared Map): Optionally enable a shared map mode where all players contribute to a single global map, allowing you to see areas discovered by friends in real-time.

Compass Radar: Easily locate other players nearby directly on your compass. The range can be customized or toggled off by admins.

Location Overlay: Display your current coordinates and direction on-screen via a toggleable HUD (/bm location). (Temporarily disabled for compatibility fixes)

Customizable Zoom: You are no longer locked to the default zoom. Set your own Minimum (zoom out) and Maximum (zoom in) scales. Settings are saved per player.

Multi-World Support: Whitelist specific worlds for the mod to track, resolving compatibility issues with server hosts (like Apex) that change default world names.

Performance & Optimization

Dynamic Chunk Loading: The plugin intelligently manages memory by loading only the explored chunks nearest to the player and unloading distant ones.

Map Quality Settings: Admins can balance visual fidelity and performance by choosing between LOW, MEDIUM, or HIGH quality.

LOW: Loads up to 30,000 chunks (8x8 resolution).

MEDIUM: Loads up to 10,000 chunks (16x16 resolution).

HIGH: Loads up to 3,000 chunks (32x32 resolution).

Note: High quality strictly limits loaded chunks to prevent memory errors.

You can also manually set the maximum number of loaded chunks via /bm config maxchunk, within recommended limits.

Commands & Permissions

The command system has been updated. Basic features are now available to all players by default, while configuration commands require specific permissions.

You can either do /op add <player> to give full access or assign specific permissions as needed using /perm group add Adventure <permission>.

Public Commands (No Permission Required)

/bettermap (or /bm)

Displays current map settings and status.

/bm waypoint menu or /waypoint or /wp

Opens the Waypoint UI to manage, share, or delete waypoints.

/bm min <value>

Sets your personal minimum zoom scale (default base is 32).

/bm max <value>

Sets your personal maximum zoom scale (default base is 256).

Global Waypoints

Permission: dev.ninesliced.bettermap.command.waypoint.global

Allows the user to create, view, and manage global (shared) waypoints visible to all players.

Teleportation

Permission: dev.ninesliced.bettermap.command.teleport

Waypoint Teleport: Allows the user to teleport to locations via the Waypoint UI buttons.

Admin & Configuration Commands

Permission: dev.ninesliced.bettermap.command.config

/bm config radar <range>

Sets the radar range (use -1 for infinite).

/bm config location

Toggles the server-wide default for the location HUD.

/bm config hideplayers

Hides player cursors on the map.

/bm config hidewarps

Hides other players' warps on the map.

/bm config hideunexploredwarps

Hides warps in unexplored regions.

/bm config hidepois

Hides all POI markers on the map.

/bm config hideunexploredpoi

Hides POIs in unexplored regions.

/bm config waypointteleport

Toggles the ability to teleport to waypoints.

/bm config markerteleport

Toggles the ability to teleport to map markers.

/bm config shareallexploration

Toggles "Linked Map" mode (shared exploration data).

/bm config track / untrack

Adds or removes the current world from the active whitelist.

/bm config maxchunk <number>

Manually overrides the maximum number of loaded chunks.

/bm config autosave <minutes>

Sets the interval for auto-saving map data.

Reload Command

Permission: dev.ninesliced.bettermap.command.reload

/bm reload

Reloads the configuration file immediately.

Configuration & Data Storage

All plugin files are located within the server's mods directory.

Configuration File

You can modify the plugin settings in mods/bettermap/config.json.

Note: Changing mapQuality or maxChunksToLoad requires a server restart to take effect.

Default Configuration:

{ "explorationRadius": 16, "updateRateMs": 500, "mapQuality": "MEDIUM", "minScale": 10.0, "maxScale": 256.0, "debug": false, "locationEnabled": true, "shareAllExploration": false, "maxChunksToLoad": 10000, "radarEnabled": true, "radarRange": -1, "hidePlayersOnMap": false, "hideOtherWarpsOnMap": false, "hideUnexploredWarpsOnMap": true, "allowWaypointTeleports": true, "allowMapMarkerTeleports": true, "hideAllPoiOnMap": false, "hideUnexploredPoiOnMap": true, "hiddenPoiNames": [], "autoSaveInterval": 5, "allowedWorlds": [ "default", "world" ] } Saved Exploration Data

Map data is saved per world. You can find the saved exploration files here: mods/bettermap/data/

Examples:

Waypoint list using command /bettermap waypoint menu:

Waypoint on map:

Waypoint edit menu:

High Quality map:

Medium Quality map:

Low Quality map:

Credits

This project was created to improve the exploration quality of life in Hytale.

Created by: Paralaxe and Theobosse

Contributors: Xytronix

Team: Ninesliced

Found a bug? Have a suggestion? Please report it in the comments or on our discord server! Our discord link