Installing Mods
Installing mods on your Hytale server is straightforward. Hytale was designed with extensive modding support from the ground up, making it easy to customize your server.
How to Install Mods
Download the Mod
Download mod files (.zip or .jar) from sources like CurseForge or the mod author's official page.
Place in mods/ Folder
Drop the mod file into the mods/ folder in your server directory. Create the folder if it doesn't exist.
Restart Your Server
Restart the server to load the mods. Check the console for any errors or missing dependencies.
For Mod Developers
When developing mods, use --disable-sentry to prevent submitting development errors to Hytale's crash reporting system.
Recommended Plugins
Nitrado, one of Hytale's official hosting partners, maintains open-source plugins for common server hosting needs. These are well-maintained and recommended for production servers.
by Nitrado
Base plugin for web applications and APIs. Provides the foundation for serving HTTP requests from your Hytale server.
Key Features:
- HTTP server
- API endpoints
- Web dashboard base
by Nitrado
Exposes server status information like player counts and server details via HTTP endpoints.
Key Features:
- Player counts
- Server status
- HTTP API
- Easy integration
by Nitrado
Dynamically limits view distance based on resource usage to maintain smooth performance under load.
Key Features:
- Auto view distance
- Resource monitoring
- Load balancing
- Performance optimization
Tips & Best Practices
Leverage AOT Cache
Always use the pre-trained AOT cache for faster boot times. Include -XX:AOTCache=HytaleServer.aot in your start command.
Limit View Distance
View distance is the main driver for RAM usage. Consider limiting maximum view distance to 12 chunks (384 blocks) for both performance and gameplay. This is roughly equivalent to 24 Minecraft chunks.
Test Mods Carefully
Always test mods on a development server first. Some mods may conflict or cause stability issues. Back up your universe/ folder before adding new mods.
Monitor Performance
Use plugins like PrometheusExporter to monitor server metrics. High CPU usage during normal operation often indicates memory pressure from garbage collection.