MapGen - Real World Map Generator for Hytale
A powerful Hytale plugin that generates beautiful, high-resolution maps using authentic terrain data from Hytale's WorldMapManager API.
Features
- Real Terrain Data: Uses Hytale's WorldMapManager API for authentic maps
- Multiple Map Sizes: From quick 5x5 chunks to massive 100x100 chunk maps
- Player-Centered: Maps generated around your current location
- Progress Tracking: Real-time updates during generation
- Auto-Saved: Saved to maps/ folder with world names and timestamps
Available Commands
Unified Command System
All map generation is now handled through the unified /mapgen command:
/mapgen - Shows help and all available options
/mapgen small - Quick 5x5 chunk map
/mapgen 256 - Medium 16x16 chunk map
/mapgen large - Detailed 25x25 chunk map
/mapgen 4k - High-res 30x30 chunk map
/mapgen 8k - Ultra high-res 60x60 chunk map
/mapgen world - Massive 100x100 chunk map (This can take a moment)
/mapgen all - Generate all sizes at once (This can take a moment)
/mapgen help - Shows detailed help with examples
Examples:
/mapgen 4k - Generate 4K map
/mapgen help - Show detailed help
Map Sizes & Details
| Command |
Size |
Chunks |
Resolution |
Generation Time |
Use Case |
small |
5x5 |
25 |
160x160 |
~5 seconds |
Quick overview |
256 |
16x16 |
256 |
1024x1024 |
~15 seconds |
Medium detail |
large |
25x25 |
625 |
800x800 |
~30 seconds |
High detail |
4k |
30x30 |
900 |
3840x3840 |
~45 seconds |
4K quality |
8k |
60x60 |
3600 |
7680x7680 |
~3 minutes |
8K quality |
world |
100x100 |
10000 |
6400x6400 |
~8 minutes |
World-scale |
File Output
Maps are automatically saved to the maps/ folder with descriptive filenames:
Format: worldname_terrain_size_timestamp.png
Examples:
testing_terrain_30x30chunks_20260201_035605.png
myworld_terrain_60x60chunks_20260201_120000.png
Technical Details
How It Works
- WorldMapManager API: Uses Hytale's official map generation system
- Chunk Processing: Processes each chunk individually for accuracy
- Real Data: No artificial effects - pure terrain data from the game
- Geometric Shading: Uses Hytale's built-in height-based shading
- Player Position: Centers maps around your current location
Performance
- Async Processing: Non-blocking generation won't freeze the server
- Progress Updates: Real-time feedback during generation
- Memory Efficient: Processes chunks individually to minimize memory usage
- Error Handling: Graceful fallbacks for unloaded chunks
Installation
- Download the latest
MapGen-[version].jar
- Place in your Hytale
UserData/Mods/ folder
- Restart your Hytale server
- Use
/mapgen or /map to see all available commands
Requirements
- Hytale Server (latest version)
- Java 25 or higher
- Sufficient disk space for map images
Support
Need help or have questions?
Discord Community: https://discord.gg/YUxuTa4ZzX - Get help, report bugs, and discuss features
Credits
Created by Patrick Jr.
CurseForge: https://www.curseforge.com/members/patrickjr/projects
License
All rights reserved. This mod is provided as-is for use with Hytale servers.