Hytale server configuration: complete guide to the config.json file

The config.json file is the main configuration file for a Hytale server. It defines the essential parameters of the server: hosting capacity, default rules, player storage and certain network options. It is this file that is read at server start-up to initialise your Hytale server environment.

---

General structure of config.json

{
  "Version": 3,
  "ServerName": "Hytale Server",
  "MOTD": "",
  "Password": "",
  "MaxPlayers": 100,
  "MaxViewRadius": 32,
  "LocalCompressionEnabled": false,
  ...
}

Main server parameters

ServerName

Name of the server as it appears to players.
This is a purely descriptive field, with no technical impact.

MOTD

Optional message displayed to players when they log in.
If it is empty, no message is displayed.

Password

Used to password-protect the server.
An empty field means that the server is public.

MaxPlayers

Maximum number of players that can be connected simultaneously.
This value must be consistent with the resources available (CPU/RAM).

MaxViewRadius

Maximum server-side visibility distance.
A high value increases the server load, particularly on world generation and synchronisation.

LocalCompressionEnabled

Enables or disables local data compression.
Deactivated by default(false).

---

Default world and gameplay settings

"Defaults": {
  "World": "default",
  "GameMode": "Adventure"
}

• World defines the world loaded by default at start-up.
• GameMode defines the initial game mode applied to players.

These parameters are used as default values, particularly when creating or connecting for the first time. By default, the server creates a universe/worlds/default folder which contains all the server’s information about the map and the players.

---

Connections and limitations

"ConnectionTimeouts": {
  "JoinTimeouts": {}
},
"RateLimit": {}

These sections are present but empty in this configuration.

They are designed for :

• define connection times (timeouts)
• limit certain network actions (rate limiting)

As things stand, no specific behaviour is applied.

---

Extensions, modules and logs

"Modules": {},
"LogLevels": {},
"Mods": {}

These blocks are reserved for :

• activation of server modules
• configuring log levels
• loading mods

No modules or mods are defined in this file.

---

Displaying and storing players

"DisplayTmpTagsInStrings": false,
"PlayerStorage": {
  "Type": "Hytale"
}

• DisplayTmpTagsInStrings is disabled: no specific display of temporary tags.
• PlayerStorage.Type defines the storage system for player data.
  The Hytale type corresponds to the game’s native system.