Hytale config files reference

Every file the Hytale server reads on boot, what's inside it, and which knobs are worth turning.

How to edit configs

Same as a Minecraft server:

1. Open the Game Panel and pick your server.
2. Stop the server. Hytale reads its configs on boot — changes made while running won't apply, and some files are rewritten on shutdown.
3. Open Files from the sidebar.
4. Click the file name (not the row) to open the in-browser editor.
5. Edit, hit Save, then start the server.

For multi-file edits or large prefab uploads, use SFTP — see File manager & SFTP.

server.config

The primary settings file. Sits at the server root next to the launcher jar.

server-name=My Hytale Server
motd=Welcome — PvE community
max-players=20
port=27500
gamemode=adventure
world-name=overworld
view-distance=10
enable-pvp=false
difficulty=normal
allow-flight=false
verify-accounts=true

• server-name — display name shown in the server browser. Free text.
• motd — message of the day. Two-line tagline under your server name.
• max-players — hard ceiling on concurrent players. Match it to your plan.
• port — listening port. Do not change unless you've added an extra allocation on the Network tab.
• gamemode — adventure, creative, minigames or roleplay. Determines the default ruleset.
• view-distance — chunks rendered around each player. 8–12 is sane; higher values destroy CPU.
• enable-pvp — global PvP toggle. Individual zones can override.
• difficulty — peaceful, easy, normal, hard.
• verify-accounts — Hytale's equivalent of online-mode. Leave this on.

worldgen.json

Controls seed, biome distribution and structure spawn rates. Touch only if you know what you want — small numeric changes can wreck a world's feel.

{
  "seed": "auto",
  "world-size": "large",
  "zones": {
    "z1-emerald-grove": { "weight": 1.0 },
    "z2-howling-sands": { "weight": 0.6 },
    "z3-frozen-peaks":  { "weight": 0.4 }
  },
  "structures": {
    "ruins":  { "rarity": 0.02 },
    "shrines": { "rarity": 0.005 }
  }
}

• seed — set to a string to reproduce a known world; "auto" generates a random one.
• world-size — small, medium, large. Bigger worlds eat disk.
• zones — relative weights for biome zones. A weight of 0 excludes the zone entirely.
• structures — per-structure spawn rarity. 0.0–1.0 scale.

permissions.json

Granular role / permission system, similar to Minecraft's LuckPerms. Define groups, give them permission nodes, assign players to groups.

{
  "groups": {
    "default":   { "nodes": ["chat.send", "world.build"] },
    "moderator": { "nodes": ["*.kick", "*.mute", "world.teleport"] },
    "admin":     { "nodes": ["*"] }
  },
  "players": {
    "<PlayerUUID>": "admin"
  }
}

Other files at the server root

• banlist.json — banned players. Edit only when the server is stopped.
• whitelist.json — allowed players when whitelist mode is on.
• logs/ — rotated daily. Newest is latest.log.
• worlds/ — every world you've generated. The active one is named by world-name in server.config.
• plugins/ — server-side plugins and scripted content packs that load on boot.
• backups/ — automatic snapshot directory if you've enabled the schedule.

Applying changes

Hytale doesn't currently support a /reload command. Every config change requires a server restart — use the dashboard's Restart button, or schedule a nightly restart from the Schedules tab.

Questions? Open a ticket — and once the official schema lands, this page will get screenshots of the in-panel config editor too.