Hytale server config reference

Your Hytale server’s settings live in config.json in the server’s main folder. Each world has its own config.json too, for rules like PvP and fall damage. Change the common settings in Settings, and the rest in the files.

Where the files are

Open Files in the panel. These are in the server’s main folder:

How to change settings

You have three ways in:

1. Settings has easy fields for the server name, message of the day, player limit and password. The panel writes them into config.json for you.
2. Settings > Advanced opens the real config files in the editor.
3. Files in the browser, or SFTP with any client such as FileZilla. Use your server’s address, port 2022, and the login from the SFTP card in Files.

The editor checks that your JSON is valid before it saves. A missing comma or bracket is the most common reason a server won’t start after an edit.

Server settings in config.json

These are the settings most owners change. The file has more keys than this; leave the others as they are.

A short example of the parts you’re likely to change:

{
  "ServerName": "Orbit",
  "MOTD": "Welcome to Orbit. Be kind.",
  "Password": "",
  "MaxPlayers": 20,
  "MaxViewRadius": 12,
  "Defaults": {
    "World": "default",
    "GameMode": "Adventure"
  }
}

Don’t replace your whole file with this. Change the values in your own file and keep everything else.

Since Update 7, a MaxViewRadius outside 1 to 32 no longer stops the server. Hytale clamps it and prints a warning in the Console.

World settings

Each world has its own config.json in universe/worlds/<world>/. On a new server the world folder is called default.

Turn PvP on by setting "IsPvpEnabled": true, then restart.

Operators, permissions, whitelist and bans

Type these in the Console in the panel. Players with the right permission can also type them in game chat.

Things to know:

• Operators are stored in permissions.json, in a group called OP that has every permission (*). Everyone else is in Default.
• Roles. Since Update 5, Hytale’s permissions are not tied to game mode, and you can give friends a group with only the permissions they need instead of full operator. Groups and their permissions also live in permissions.json.
• Whitelist. Since Update 6 the whitelist runs on the hytale.server.join permission. The /whitelist commands grant and remove it. Add yourself before you turn it on.
• Bans are saved in bans.json. A ban removes the player at once, including any other connection their account has open.
• The admin, allow and ban lists under Settings > Players do the same jobs without typing commands.

Startup options

Settings > Startup has a field for extra launch options. Wilderack already sets the port, the memory limit and the path to Assets.zip, so don’t add those. Options you might use:

Which changes need a restart