Server Configuration

The Hytale server uses several JSON configuration files at the server root, plus per-world configuration inside each world’s save directory.

Root Files

These files live at the server root alongside HytaleServer.jar:

File	Description
config.json	Main server settings — name, MOTD, max players, timeouts, rate limits, modules, mods, updates
permissions.json	User permissions, group memberships, and group permission sets
bans.json	Permanent and timed bans
whitelist.json	UUID-based allowlist

All root files are auto-generated with defaults on first launch.

Per-World Configuration

Each world has its own config.json inside its save directory, controlling world-specific settings like PvP, time, weather, spawn, and chunk behavior. Worlds also reference a shared GameplayConfig asset for gameplay rules (death, combat, crafting, etc.).

See World Configuration for the full reference.

Mod Configuration

Mods define their own settings files using the withConfig() API, stored in mods/{group}_{name}/. See Configuration for the mod config system.

Directory Layout

server/
├── HytaleServer.jar
├── config.json              # server config
├── permissions.json         # permissions
├── bans.json                # ban list
├── whitelist.json           # whitelist
├── mods/
│   └── mygroup_mymod/
│       └── config.json      # mod config (from withConfig)
└── universe/
    ├── default/
    │   └── config.json      # world config
    └── pvp-arena/
        └── config.json      # world config