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