Gallery

Description

GlymeraWebMap — Your World, Live in the Browser

A live map of your server world that anyone can open in a web browser — like Dynmap, for Hytale. The plugin serves the map itself from your game server: no web hosting, no external services, no accounts. Install the jar, open http://<your-server-ip>:8123, and share the link with your players.

What is GlymeraWebMap?

A persistent, ever-growing map of your server. While players explore in-game, the plugin renders the world from Hytale's own cartography into map tiles and serves them on a built-in web page. Everything mapped once stays on the map forever — it keeps growing across restarts, slowly building a complete picture of your world that visitors can browse from anywhere, on any device, without launching the game.

Features

Live player markers. See who is online and where they are, updated every few seconds. Click a name in the online list to jump straight to that player and watch them uncover new land as they travel.
Pan & zoom viewer. Drag to pan, scroll to zoom, with a coordinate readout under the cursor. Clean dark theme, works on phones and tablets too.
Multi-world support. Every world gets its own map; switch between them with the world selector. New worlds appear automatically once a player visits them. Worlds that no longer exist drop out of the list, and a whitelist lets you choose exactly which worlds are public.
Persistent exploration. The map never forgets: terrain stays visible even when chunks unload or everyone logs off. Over days of play it grows into a full atlas of your server.
Completely self-hosted. The page, the tiles and all data live on your server and nowhere else. Nothing is sent to any external service.

For Admins — Setup in Two Steps

Drop the jar into your server's mods/ folder and start the server. That's the whole installation — the config writes itself with working defaults.
Open TCP port 8123 in your firewall or hoster panel (the one thing a plugin cannot do for you). The port can be changed in the config if 8123 is taken.

Then give the map your server's name — in-game, as OP:

/webmap title My Awesome Server

The name appears on the page within seconds. /webmap (OP-only) shows status and the URL to share.

Running several worlds? Pick the one the map opens on:

/webmap default <world>

/webmap default clear switches back to automatic (a world with players online).

Only want some worlds on the map? Use the world whitelist:

/webmap whitelist add <world>
/webmap whitelist remove <world>
/webmap whitelist clear

With an empty whitelist, every world is shown. /webmap worlds lists all worlds and whether they are shown or hidden.

Optional settings in mods/de.glymera_GlymeraWebMap/config.json:

playerMarkers: false — hide live player positions from the page (privacy)
port / bindAddress — where the web server listens
title — the page title, if you prefer editing the file over the command
defaultWorld — the world the page opens on (empty = automatic)
worldWhitelist — only these worlds appear on the map, e.g. ["default", "nether"] (empty = all worlds)
mapInstances — map temporary instance worlds such as a hub or dungeon that is spawned per visit (default: off)
render cadence and budget — sensible defaults, no tuning needed

Good to Know

The map is rendered from the game's own cartography at its native resolution, so it always matches what players see on their in-game map.
Tiles render near online players only, on background threads, with a hard per-pass budget — no impact on world tick performance, and an idle server does no map work at all.
Tiles are plain PNG files under mods/de.glymera_GlymeraWebMap/tiles/ — trivially easy to back up, and deleting them simply resets the map (it re-fills as players explore).
Browsers cache tiles aggressively; the page only re-downloads a tile when its pixels actually changed. A handful of open map pages costs your server next to nothing.
Works standalone — no other plugin required.

Data directory: mods/de.glymera_GlymeraWebMap/

Made with care by Glymera for the Hytale community

Changelog

GlymeraWebMap — Changelog

v5.0.0 (2026-10-12) — Hytale 0.7.0 (Update 7)

Rebuilt for Hytale 0.7.0 (Update 7 / Chapter 1). Requires server 0.7.0 or newer; this version does not run on 0.6.x, and the previous version does not run on 0.7.0 (the server removed the old block and chunk API).
Migrated to the 0.7.0 world API: block reads and writes now go through the chunk store and block sections (BlockOperations), chunk ticking through the engine's new marker component, spawn points through the asynchronous spawn provider.
Mod icon added (icon-256.png in the jar) so the plugin shows its picture in the world's mod list instead of a question mark.
Upgrade: delete the old jar from mods/, drop in the new one and keep the plugin's data folder — configs and saved data carry over unchanged. Restart the server.

v4.0.0 (2026-10-08) — instances no longer pile up, world whitelist

Fix: instance worlds no longer stack up in the world list. Native instances (for example a hub or dungeon) get a new world name every time they are spawned, and each one used to leave a permanent entry in the dropdown plus its own tile folder. Now:
Temporary instance worlds are not mapped and not listed by default. Set "mapInstances": true in the config if you want them on the map anyway.
Worlds that no longer exist are removed from the dropdown. Their old tiles stay on disk under mods/de.glymera_GlymeraWebMap/tiles/ and are safe to delete.
New: world whitelist. Choose exactly which worlds the map shows: in-game as OP with /webmap whitelist add <world>, /webmap whitelist remove <world> and /webmap whitelist clear, or in config.json as "worldWhitelist": ["default", "nether"]. An empty list means all worlds. Worlds that are not shown are not rendered, and their tiles are not served either.
New: /webmap worlds lists every world the map knows about and whether it is shown or hidden, with the reason.
If the world you are viewing gets hidden, the page switches to another world on its own.
Upgrade: replace the jar and restart. Existing configs get the new keys automatically; tiles and settings carry over.

v3.0.0 (2026-10-07) — choose the world the map opens on

New: default world. Set which world the page shows when it is opened, in-game as OP with /webmap default <world> (takes effect on the next page load) or in config.json as "defaultWorld". /webmap default clear goes back to automatic. If the world doesn't exist, the page falls back to the automatic choice.
Automatic choice is unchanged: a world with players online, otherwise the first one.
The world list in the dropdown is now sorted alphabetically (it was in random order before, so the "first" world could differ).
/webmap status now shows the default world.
Upgrade: replace the jar and restart. Existing configs get the new key automatically (empty = previous behaviour); tiles and settings carry over.

v2.0.0 (2026-08-28) — Hytale 0.6.0 (Update 6)

Rebuilt for Hytale 0.6.0 (Update 6). Requires server 0.6.0 or newer; this version does not run on 0.5.x, and older versions of this plugin do not run on 0.6.0.
Migrated to the 0.6.0 APIs (network protocol hytale/3, new command-permission API, block/chunk/entity API changes). Everything that was open to players before is open to players again.
Upgrade: delete the old jar from mods/, drop in the new one and keep the plugin's data folder — configs and saved data carry over unchanged. Restart the server.

v1.0.0 — Initial release: your world, live in the browser

A live map of your server world that anyone can open in a web browser — like Dynmap
for Hytale. The plugin serves the map itself on its own port (default 8123): no web
hosting, no external services, no setup beyond installing the plugin. Open
http://<your-server-ip>:8123 and share the link.

Features
- Persistent world map: terrain is rendered from Hytale's native cartography while
players explore. Everything mapped once stays on the map — it keeps growing across
restarts, building up a complete picture of your world over time.
- Live player markers: see who is online and where they are, updated every few
seconds. Click a name to jump to that player. Can be disabled in the config
(playerMarkers: false) if you prefer privacy.
- Pan & zoom viewer: drag to pan, scroll to zoom, works on phones too. Dark theme,
coordinate readout under the cursor, world selector for multi-world servers.
- Fully self-contained: the web page, tiles and data live entirely on your server.
Nothing is sent anywhere else.

Admin notes
- /webmap title <your server name> (OP-only, in-game) puts your server's name on
the web page - no file editing needed. The open page updates within seconds.
- Config: mods/de.glymera_GlymeraWebMap/config.json (port, bind address, page title,
player markers, render cadence). /webmap (OP-only) shows status in-game.
- Remember to open the chosen TCP port in your server's firewall.
- Map tiles are plain PNG files under mods/de.glymera_GlymeraWebMap/tiles/ — easy to
back up or wipe (wiping just resets the map; it re-fills as players explore).
- Rendering is budgeted and runs on background threads near online players only — no
impact on world tick performance.

Only Marc can read this.