Description
HyAtlas is an advanced, standalone, live interactive web map for your Hytale server. It runs completely behind the scenes without heavy dependencies, rendering your world directly into a beautiful, interactive web interface that players can access via their browsers.
It allows you to view real-time player locations, global world markers, and chunk generation in a Google Maps style interface. It has built-in caching, multithreading, and even automatic SSL (HTTPS) certificate generation for secure connections!
Update 1.0.1
* Fixed an issue where markers that no longer existed were automatically removed from the web map.
* Added smooth player movement on the web map.
* Added the ability to follow a player on the web map.
Features
* Live Real-Time Map: Watch players move across Orbis seamlessly.
* Smart Markers: Supports global points of interests and public markers with custom icons.
* Performance First: Extensive caching (Memory + Disk) and "Explored Only" modes to protect your server's TPS from dropping.
* Built-in SSL Deployment: Built-in Let's Encrypt ACME integration. Secure your map with `https://` out of the box!
* Multi-Language Support: Swap between English (EN) and Ukrainian (UA) dynamically.
* In-Game Commands: Includes pre-generation, cache wiping, and instant config reloading.
---
# Installation
1. Download the latest `HyAtlas-*.*.*.jar` release.
2. Place the file inside your Hytale server's mods/ directory.
3. Start the server. The mod will automatically generate a folder at mods/bodyy_HyAtlas with a config.json file.
4. Tweak config.json to your liking, and type /hyatlas reload in-game or in the server console to instantly apply changes!
5. Open your web browser and navigate to http://your-server-ip:8080 (or https://your-domain.com:8443 if SSL is configured).
---
# Configuration Settings
The config.json file controls everything about your HyAtlas map.
### General Settings
- httpPort (default: 8080) — The port address your map is hosted on.
- updateIntervalMs (default: 1000) — How often (in milliseconds) player positions are synchronized with the web map. Lower means smoother movement, but higher CPU usage.
- markerUpdateIntervalMs (default: 5000) — How often global world markers and points of interest are synchronized.
- enabledWorlds (default: []) — A list of worlds to load the map for. Keep empty [] to enable all worlds.
- lang (default: EN) — Interface language of the map. Change to UA for Ukrainian.
Visual & Map Generation Settings
- tileSize (default: 256) — The size of the rendered chunk images in pixels. maxZoom (default: 4) — The maximum zoom-out depth limit.
- renderExploredChunksOnly (default: true) — Crucial for performance! If true, the map will ONLY draw tiles where players have physically walked. If false, the map might try to render the entire void/unexplored areas.
- tileRefreshRadius (default: 5) — How many chunks around active players will continuously redraw and update changes (e.g. tracking block breaking/building).
- tileRefreshIntervalMs (default: 60000) — How often chunks around a player redraw the terrain blocks to disk.
Caching Settings
- useDiskCache (default: true) — Saves all pre-rendered map blocks as PNG files directly to your hard drive so the server doesn't compile them again on reboot.
- tileCacheSize (default: 20000) — Maximum number of map chunks preserved in RAM.
- chunkIndexCacheMs (default: 30000) — The time in milliseconds a chunk cache remains valid. enableTilePyramids (default: true) — Combines smaller tiles into composite larger tiles when scrolling out (improves browser experience and zoom fidelity).
SSL / HTTPS Settings
(Optional: Use if you want to attach a real domain to your map with a secure padlock icon)
- enableHttps (default: false) — Activates the HTTPS listener.
- httpsPort (default: 8443) — Port assigned to the HTTPS endpoint.
- domain (default: ) — Your actual internet domain (e.g., map.myhytaleserver.com).
- acmeEmail (default: ) — The recovery email linked to the Let's Encrypt SSL certificate authority.
- useProductionAcme (default: true) — Whether to use the real Let's Encrypt servers. Change to false if diagnosing setup issues to avoid API rate limits.
---
# Commands and Permissions
You need the hyatlas.admin permission role to use these options in-game.
* /hyatlas status — Check the health of your map server, active ports, and active web connections.
* /hyatlas reload — Refresh the `config.json` without rebooting the server.
* /hyatlas pregenerate <radius> — Stand anywhere in the world and use this command to instantly map the specified radius around you.
* /hyatlas clearcache — Wipe all memory and reset the map entirely.
* /hyatlas renewssl — Force a pull of a new Let's Encrypt browser certificate
Офіційний Сервер
Спробуйте HyAtlas на Обрій — українському сервері Hytale!
https://obriyhytale.pp.ua/map
Credits / Attribution
HyAtlas is an explicitly enhanced and maintained fork of the original EasyWebMap project. All credit for the foundational structure, concepts, and original mechanics goes to the original developer, cryptobench. This fork was created to continue the life of the project after original development stalled, introducing new features, modern fixes, performance optimizations, and complete multi-language localization.