Hytale - How to Use This Tool
- Understanding Hytale Server Configuration
- Server Config (config.json in root)
- World Config (config.json in world folder)
- Quick Setup Presets
- Common Configuration Examples
- Private Server with Friends
- Public Community Server
- PvP Arena World
- Troubleshooting
- Server Won’t Start
- World Not Loading Settings
- Performance Issues
Basic Settings
The name displayed to players in server lists
Shown when players connect
Leave empty for a public server. Set a password to restrict access.
Defaults
The world players spawn into when joining. Must match a world folder name.
The game mode for new players (e.g., Adventure).
Performance Settings
Maximum concurrent players (1-1000). Higher values require more RAM.
Render distance in chunks (1-64). Default: 12 (recommended). Lower values improve performance.
May reduce bandwidth but increases CPU usage
Advanced Settings
Developer option - leave disabled unless debugging
Player data storage system. Use default unless using custom plugins.
Need a Hytale server?
Instant setup with full config control.
Live Preview
Server Config{
"Version": 3,
"ServerName": "Hytale Server",
"MOTD": "",
"Password": "",
"MaxPlayers": 100,
"MaxViewRadius": 12,
"LocalCompressionEnabled": false,
"Defaults": {
"World": "default",
"GameMode": "Adventure"
},
"DisplayTmpTagsInStrings": false,
"PlayerStorage": {
"Type": "Hytale"
}
}Place this file as config.json in your Hytale server's root directory.
How to Use This Tool
This tool generates configuration files for Hytale dedicated servers. Use the tabs above to switch between Server Config (global server settings) and World Config (per-world settings).
- Select the config type you want to generate using the tabs
- Adjust the settings using the form controls
- Preview your config in the live JSON preview on the right
- Copy or download the generated JSON file
- Upload to your server in the correct location
Config File Locations
- Server Config: Place in your server’s root directory (same folder as
HytaleServer.jar) - World Config: Place in
universe/worlds/[world_name]/config.json
Understanding Hytale Server Configuration
The Hytale dedicated server uses JSON configuration files to control server behavior. There are two types of configuration:
Server Config (config.json in root)
This file controls global server settings that apply to all worlds:
- ServerName: The name shown to players in server lists
- MOTD: Message displayed when players connect
- Password: Leave empty for public servers, or set to restrict access
- MaxPlayers: Maximum concurrent players (affects RAM usage)
- MaxViewRadius: Render distance in chunks (lower = better performance)
- LocalCompressionEnabled: Network compression (saves bandwidth, uses more CPU)
World Config (config.json in world folder)
Each world can have its own configuration controlling gameplay:
- Seed: Determines world generation - same seed = same terrain
- UUID: Unique identifier (auto-generated)
- Gameplay settings: PvP, fall damage, NPC spawning
- World behavior: Ticking, time progression, saving
- System settings: Player data saving, chunk unloading
Quick Setup Presets
For World Config, we provide several presets to quickly configure common scenarios:
| Preset | Use Case | Key Settings |
|---|---|---|
| Survival Server | Standard gameplay | PvP off, damage on, NPCs spawn, full saving |
| PvP Arena | Competitive combat | PvP on, no NPCs, no saving |
| Creative Build | Building without interruptions | No damage, NPCs frozen, full saving |
| Minigame Lobby | Temporary world that resets | No damage, no saving, deletes on remove |
Performance Tip
Lower your MaxViewRadius to improve server performance. A view radius of 12 chunks is recommended for most servers.
Common Configuration Examples
Private Server with Friends
{
"ServerName": "Friends Only Server",
"Password": "your-secret-password",
"MaxPlayers": 10,
"MaxViewRadius": 12
}Public Community Server
{
"ServerName": "Community Hytale",
"MOTD": "Welcome to our community!",
"Password": "",
"MaxPlayers": 100,
"MaxViewRadius": 24
}PvP Arena World
Use the “PvP Arena” preset, which sets:
- PvP enabled
- NPCs frozen
- Player saving disabled
- World saving disabled
This creates a competitive arena where player progress doesn’t persist between sessions.
Troubleshooting
Server Won’t Start
- Verify your JSON is valid (no trailing commas, proper quotes)
- Check that
Versionmatches what your server expects (currently 3 for server, 4 for world) - Ensure file is named exactly
config.json
World Not Loading Settings
- Make sure the config is in the correct world folder:
universe/worlds/[name]/config.json - Verify the UUID is in the correct format with
$binaryand$typefields - Check file permissions allow the server to read the file
Performance Issues
- Reduce
MaxViewRadiusto 12 (recommended default) - Enable
IsUnloadingChunksto free memory - Consider reducing
MaxPlayersor upgrading your plan
Was this tool helpful?
Frequently Asked Questions
The server config.json goes in the root directory of your Hytale server, in the same folder as HytaleServer.jar. This file controls global server settings like server name, max players, and view distance.
Each world has its own config.json file located in universe/worlds/[world_name]/config.json. This file controls per-world settings like PvP, fall damage, and NPC spawning.
The UUID is a unique identifier for each world. It's automatically generated in a special binary format that Hytale expects. You don't need to create this yourself - our generator handles it automatically.
The world seed is a number that determines how the world generates. Using the same seed will create the same terrain layout. You can use any 64-bit integer as a seed, or click 'Randomize' to generate a random one.
The danger zone contains options that can delete world data. 'Delete on Universe Start' will delete the world every time the server starts - useful for temporary lobby worlds. 'Delete on Remove' deletes world files when the world is removed from the universe.
Free forever. No signup required. Just tools that work.