GlymeraMinimap — A Smooth, Server-Side Minimap

A clean live minimap for Hytale — no client mod required. The map is rendered on the server from the game's own world-map data and streamed straight to each player's screen, so everyone gets it automatically just by joining.

GlymeraMinimap is built to live alongside your other HUDs. It is sent as a direct packet instead of claiming the single custom-HUD slot, so scoreboards, other overlays and custom HUDs keep working at the same time.

Requires Hytale 0.7 or newer (Update 7). Older server versions need an older release from the Files tab.

What is GlymeraMinimap?

A circular minimap in the corner of your screen that pans smoothly under a centred player marker as you walk — no frame-by-frame refreshes, no jitter. It shows the terrain around you, the creatures and players nearby, and where you died, with your coordinates underneath. Keep it classic north-up, or switch it to rotate with your view — your heading up, the world turning under you.

Works out of the box — no setup needed, every player gets the map automatically. Admins can optionally set where it starts, lock it in place, or switch it off in chosen worlds (see For Admins).

For Players

• A live top-down map in the corner, with your coordinates underneath, N / O / S / W compass letters and a directional arrow.
• North-up or rotate-with-view — your choice. By default the map is classic north-up. Flip "Rotate with view" in the settings (or /mm rotate on) and the map turns with your view direction instead — your heading is always up. The compass letters detach and slide around the rim so they always point at the true world directions, and arrow + map always add up to your exact heading. Per player, saved across sessions.
• Smooth panning. The map glides as you move instead of snapping frame by frame, and it fills in as you explore new ground.
• Pick your own corner and size. Place the map in any of the four screen corners from the settings page, and set its size with /mm size. Both are saved per player and follow you across sessions.
• See what's around you. Nearby creatures appear as coloured dots, other players as arrows:
  • white = friendly, yellow = neutral, red = hostile
  • a neutral creature turns red while it's actively hunting — so you spot danger before it reaches you. (This live-aggression colouring is unique to GlymeraMinimap.)
• A death marker that points the way. When you die, a white X marks the spot. While that spot lies outside the visible map, the X sticks to the rim of the minimap in the direction of your death, so you always know which way to walk; once the spot comes into view it sits on the exact location. Works north-up and in rotation mode.
• Hide far-off mobs. Optionally only show creatures near your own height, so deep caves and mobs far above don't clutter the map.
• Your settings, your way. An in-game settings page lets each player toggle the map, set the zoom, choose a corner, choose which markers to show, and tune the mob-height filter. Every player has their own settings, with no admin gate by default (a server admin can optionally lock them — see For Admins).

In-Game Settings Page — /mm settings

A clickable page that updates instantly, in place:

• Minimap — on / off
• Rotate with view — map turns with your heading / stays north-up
• Corner — top-left, top-right, bottom-left, bottom-right
• Zoom — visible radius in blocks
• Other players — show / hide player markers
• Creatures — show / hide creature markers
• Death marker — show / hide
• Limit mob height — only show creatures near your height
• Mob height range — the ± band for the height filter

(Map size is set with the /mm size command rather than on this page — resizing redraws the HUD, and doing that from an open page would briefly garble it, so it lives as a command.)

Commands

Every player configures their own minimap — corner and size included — with no permission gate by default. A server admin can optionally lock this; see For Admins.

For Admins

GlymeraMinimap works out of the box — drop the jar in and every player gets the map. A few optional controls let you fit the minimap to your server:

Set the default minimap for new players — /mm admin (OP only)

Opens the same settings page, titled "Admin: Default Minimap for New Players", but it edits the server default instead of your own minimap. Whatever you set here — the screen corner, zoom, rotation mode, which markers show, and so on — is what a brand-new player starts with on their first join.

This is handy when the default top-left corner overlaps your scoreboard or other HUDs: set the default to another corner once, and every new player gets it there automatically.

• OP only — non-OP players can't open it.
• Players who have joined before keep their own saved settings; this applies to first-time joiners.

Server config — mods/de.glymera_GlymeraMinimap/config.json

Every key is explained by a _key line right above it in the file. The file is created on the first start:

{
  "allowPlayerChanges": true,
  "deathMarkerEdge": true,
  "deathMarkerSize": 18,
  "disabledWorlds": []
}

• allowPlayerChanges — true (default): players freely move, resize and tune their own minimap. false: non-OP players are locked to the admin default; their settings page and the /mm tuning commands are turned off. OPs are never restricted.
• deathMarkerEdge — true (default): while the death spot is outside the visible map, the death marker sticks to the rim pointing towards it. false: the marker is only drawn while the spot is inside the visible map. Players can still hide their own death marker with the "Death marker" toggle.
• deathMarkerSize — size of the death marker in pixels, 8–40 (default 18).
• disabledWorlds — world names in which the minimap is never shown, e.g. ["arena", "maze"]. Worlds whose own config has the world map disabled (dungeon, lobby or adventure-map worlds) are hidden automatically and need not be listed.

Data directory: mods/de.glymera_GlymeraMinimap/ — per-player settings under players/, the server default in default.json, and the server config in config.json. Everything survives updates; just replace the jar.

Installation

1. Place GlymeraMinimap-15.0.0.jar in your server's mods/ folder (remove any older GlymeraMinimap jar).
2. Start (or restart) the server.
3. Done. The map appears for every player automatically.

Performance

GlymeraMinimap is built to scale to a full server:

• No per-frame map redraws. The map is one image that the client pans under the player marker; a new image is streamed only when you move into new ground or the terrain changes, at most a couple of times per second. That is why the map glides instead of stepping, and why it does not hitch the client on every update.
• The server tick stays light. The per-player loop only does cheap work on the world thread — read position, pan the map, scan nearby markers, push tiny UI updates.
• Heavy rendering runs off the main thread. The terrain image is composited and encoded on a dedicated background pool, so there are no tick lag spikes even with many players online.
• Compact images. Terrain images are sent as 8-bit palette PNGs — about a quarter fewer bytes per update than 32-bit images, with an unchanged picture. Identical images are de-duplicated and never re-sent.
• Bandwidth-aware, even at high speed. Even a player fast-travelling across the world can't saturate the connection; the full image is throttled and otherwise just panned client-side.
• Rotation mode is budgeted the same way. While you actively turn, the map updates in fine steps (8 per second) using small reduced-size packets, and the moment your view settles it sharpens back to full resolution. North-up players pay nothing at all.
• Small, bounded memory per player (cached arrow/marker icons, a handful of cycling terrain frames).

Comfortably handles dozens of players at once on typical hardware.

Good to Know

• The terrain comes from the game's own cartography (the areas the world has generated), so the map fills in as you and others travel.
• The map is circular with a border ring, north-up by default — or rotating with your view if you prefer (per player).
• Rendered via direct packets, so it coexists with other custom HUDs instead of fighting over the single HUD slot.
• BetterMap users: BetterMap improves the full-screen world map (M), GlymeraMinimap is the corner minimap — the two do different jobs, and both plugins load side by side on the same server.
• Hides itself automatically in worlds that have no world map (and in any world you list in disabledWorlds), and comes back by itself in the next world that has one. World changes, teleports and elevators never leave a frozen or stale minimap behind.
• Robust at any travel speed — fast-flying through unexplored terrain won't disconnect you.

Data directory: mods/de.glymera_GlymeraMinimap/

Made with care by Glymera for the Hytale community