How to Configure Your Hytale Server (config.json)

Complete Hytale server config.json reference — server name, players, view radius, game mode, mods, authentication, and auto-updates.

Hytale uses JSON config files. The main config is config.json in the server root.

HytaleServer.jar

Assets.zip

config.json

permissions.json

whitelist.json

bans.json

auth.enc

config.json

Server Config (config.json)

Setting	Default	Description
`ServerName`	`"Hytale Server"`	Browser display name
`MOTD`	`""`	Message shown on login
`Password`	`""`	Join password (empty = public)
`MaxPlayers`	`100`	Max concurrent players (1–1000)
`MaxViewRadius`	`32`	Chunk render distance (biggest RAM driver — use 12 for performance)
`Defaults.World`	`"default"`	Default world folder name
`Defaults.GameMode`	`"Adventure"`	`"Adventure"` or `"Creative"`

Per-World Config (universe/worlds/<name>/config.json)

Setting	Default	Description
`Seed`	random	World generation seed
`IsPvpEnabled`	`true`	Player vs player combat
`IsFallDamageEnabled`	`true`	Fall damage
`IsSpawningNPC`	`true`	Monster/animal spawning
`IsAllNPCFrozen`	`false`	Freeze all AI
`IsGameTimePaused`	`false`	Freeze day/night cycle
`IsSavingPlayers`	`true`	Persist inventory/position
`IsUnloadingChunks`	`true`	RAM management (keep true)

Death Penalty

"Death": {
  "ItemsLossMode": "None",
  "ItemsAmountLossPercentage": 0,
  "ItemsDurabilityLossPercentage": 0,
  "RespawnController": {"Type": "HomeOrSpawnPoint"}
}

ItemsLossMode	Effect
`None`	Keep everything
`All`	Drop everything
`Configured`	Lose percentage based on settings above

Ports

Port	Protocol	Purpose
5520	UDP	Game (QUIC protocol)

📝 Note: Hytale uses QUIC over UDP, not TCP. Only UDP needs to be forwarded.

Authentication

Servers must authenticate with Hytale's services on first start:

Run the server — a device code appears
Visit https://accounts.hytale.com/device
Enter the code and authorize with your Hytale account
Run /auth persistence Encrypted to persist across restarts

Auto-Updates

"Update": {
  "Enabled": true,
  "CheckIntervalSeconds": 3600,
  "AutoApplyMode": "Disabled"
}

AutoApplyMode: "Disabled", "WhenEmpty", "Scheduled"