Hytale Server Configuration
Configure your Hytale server through the Startup tab in the Game Panel.
Startup Tab Settings
All server settings are configured in the Startup tab. After making changes, restart your server for them to take effect.
Critical Security Setting
Allow Operators - READ THIS FIRST!The Allow Operators setting is enabled (1) by default.When enabled, ANY player can make themselves an operator on your server. This gives them full admin permissions!For public servers: Set Allow Operators to 0 to prevent random players from gaining admin access.For private servers with trusted friends: You can leave it 1 for convenience.
All Startup Variables
| Variable | Default | Description |
|---|
| Allow Operators | 1 | When 1, any player can op themselves. Set to 0 for public servers! |
| Auth Mode | authenticated | Authentication mode. Use authenticated for online play, offline for LAN only |
| Automatic Update | 1 | Automatically update the server on restart |
| Memory Overhead | 0 | RAM (in MB) reserved for the system. Java gets the rest. See recommendations below |
| Enable Backups | 1 | Enable automatic world backups |
| Backup Frequency | 30 | Backup interval in minutes |
| Asset Pack | Assets.zip | Asset pack file sent to players |
| Patchline | release | Release channel (release for stable) |
| Game Profile | Empty | Hytale profile username for server auth (leave empty for default) |
| Accept Early Plugins | 1 | Acknowledge that early plugins may cause stability issues |
| Disable Sentry | 1 | Disable crash reporting (recommended during plugin development) |
| Leverage AOT Cache | 1 | Use Ahead-Of-Time cache for faster boot times |
| JVM Arguments | (optimized defaults) | Advanced Java settings - only modify if you know what you’re doing |
Memory Overhead Recommendation
The Memory Overhead setting reserves RAM for the system while Java (the server) uses the rest.
Recommended Memory Overhead: Set to 2048 (2GB) for most servers.This ensures the system has enough RAM while maximizing what’s available to Java.
| Server RAM | Recommended Overhead | Java Gets |
|---|
| 8GB | 2048 | ~6GB |
| 12GB | 2048 | ~10GB |
| 16GB | 2048 | ~14GB |
Game Profile Setting
If you have multiple Hytale profiles, you can specify which one to use for server authentication:
- Visit accounts.hytale.com
- Click Game Profiles in the left menu
- Copy the username of the profile you want to use
- Paste it into the Game Profile field
Leave empty to use your default/first profile automatically.
Auth Mode
| Mode | Description |
|---|
authenticated | Online mode - players must have valid Hytale accounts |
offline | Offline/LAN mode - no account verification |
Only use offline mode for private LAN servers. Online servers should always use authenticated.
Operator Management
If you set Allow Operators to 0, you’ll need to manually manage operators.
Granting Operator Status
Use in-game commands or server console to grant operator status to trusted players.
Removing Operator Status
Similarly, use commands to remove operator status from players who should no longer have it.
Keep a list of your trusted operators. With Allow Operators disabled, only you (and existing operators) can grant op status to others.
Best Practices
For Public Servers
- Set
Allow Operators to 0
- Manually op only trusted players
- Keep
Auth Mode as authenticated
- Set
Memory Overhead to 2048
- Keep backups enabled
For Private Servers
Allow Operators can stay 1 if you trust all players- Share server IP only with friends
- Still recommended to manage ops carefully
Applying Changes
After modifying any settings:
- Save your changes in the Startup tab
- Go to the Console tab
- Restart your server (not just stop/start)
- Changes take effect after restart
Early Access Notice: Settings and options may change as Hytale develops. Check back for updates to this documentation.
