Tips & Tricks
Tips & Tricks
Optimize your Hytale server performance and leverage community plugins.
View Distance
Section titled “View Distance”View distance is the main driver for RAM usage.
Recommendation: Limit maximum view distance to 12 chunks (384 blocks).
For comparison:
- Minecraft servers default to 10 chunks (160 blocks)
- Hytale’s 384 blocks equals roughly 24 Minecraft chunks
- Expect higher RAM usage with default settings
Tune this value based on your expected player count and available resources.
Ahead-Of-Time Cache
Section titled “Ahead-Of-Time Cache”The server ships with a pre-trained AOT cache (HytaleServer.aot) that improves boot times by skipping JIT warmup.
java -XX:AOTCache=HytaleServer.aot -jar HytaleServer.jar --assets PathToAssets.zipSee JEP-514 for technical details.
Disable Sentry During Development
Section titled “Disable Sentry During Development”Hytale uses Sentry for crash reporting. Disable it during plugin development to avoid submitting your development errors:
java -jar HytaleServer.jar --assets PathToAssets.zip --disable-sentryRecommended Plugins
Section titled “Recommended Plugins”Community plugins maintained by hosting partners Nitrado and Apex:
| Plugin | Description | Repository |
|---|---|---|
| WebServer | Base plugin for web applications and APIs | Nitrado/hytale-plugin-webserver |
| Query | Exposes server status via HTTP | Nitrado/hytale-plugin-query |
| PerformanceSaver | Dynamically limits view distance based on resources | Nitrado/hytale-plugin-performance-saver |
| PrometheusExporter | Exposes server and JVM metrics | ApexHosting/hytale-plugin-prometheus |
JVM Arguments
Section titled “JVM Arguments”Common JVM parameters for server optimization:
| Argument | Purpose |
|---|---|
-Xms | Initial heap size |
-Xmx | Maximum heap size |
-XX:AOTCache | Use ahead-of-time compilation cache |
Example with memory limits:
java -Xms2G -Xmx4G -XX:AOTCache=HytaleServer.aot -jar HytaleServer.jar --assets PathToAssets.zipSee Guide to JVM Parameters for more options.
Memory Troubleshooting
Section titled “Memory Troubleshooting”Automatic Backups
Section titled “Automatic Backups”Enable automatic backups:
java -jar HytaleServer.jar --assets PathToAssets.zip --backup --backup-frequency 30This backs up every 30 minutes. Adjust frequency based on your needs.