FrostMap

FrostMap

A real-time web-based map viewer for Hytale servers

Overview

FrostMap automatically generates and serves a live, interactive map of your Hytale server world through a built-in web interface. Watch your world grow in real-time as players explore and build!

Features

Real-time Map Generation - Chunks are rendered as players explore

Web Server - Access your map from any browser

Multi-world Support - View all your server worlds in one interface

Optimized Performance - Composite tile system for efficient storage and loading

SSL Certificates - Let's Encypt certificate support via Nitrado:WebServer

Live player tracking - Show player positions live on the map

Live map updates - Shows map updates and expansion in real-time

Coming Soon

Markers - Show in-game markers on the map

Map Pre-Gen - Commands to pre-generate large portions of the map

Installation

Download the latest release

Place the .jar file in your server's mods folder

Installed the required Nitrado:WebServer dependency

Start your server - a default config will be generated

Access the map at https://<webserverurl>/HyFrost/FrostMap

Dependencies

The FrostMap plugin requires that you have the Nitrado:WebServer plugin installed for handling the website. This allows us to work well with other plugins that also utilize this system. More information available at https://www.curseforge.com/hytale/mods/nitrado-webserver

Configuration

Configuration file is generated at first startup:

WebServerEnabled (default: true) - Disable the web server

WriteThreads (default: 2) - Number of threads to use for writing tile updates

Debug (default: false) - Enable verbose debug logging

BatchFlushIntervalMs (default: 10000) - How often in ms to flush pending chunks to disk

BatchMaxQueueSize (default: 1000) - Maximum pending chunks before forced disk write

WebPLossless (default: true) - Should WebP tiles be lossless or lossy

WebPQuality (default: 80) - WebP quality for lossy tiles

WebPCompressionLevel (default: 5) - 0-7 value for level of tile image compression

ChunksPerTile (default: 16) - Chunk width per composite tile

Changing ChunksPerTile will reset existing tile data!

Commands

/frostmap status - Shows tile statistics and storage info

/frostmap rebuild - Rebuilds the tile index from disk

/frostmap rebuild --verbose - Rebuild with detailed progress output

How It Works

FrostMap hooks into the server's in-game map rendering system. Chunks generated by the in-game map are further rendered into composite PNG tiles and served through an embedded HTTP server. The web frontend uses Leaflet.js for smooth panning and zooming.

Made with ❄️ by HyFrost