Hytale Server Configuration: File Structure and Settings Guide

Understanding your Hytale server’s file structure and configuration options is essential for customizing and managing your server effectively. This guide covers all the important files and directories.

Server Directory Structure

HytaleServer/
├── .cache/              # Cache for optimized files
├── logs/                # Server log files
├── mods/                # Installed mods (.zip or .jar)
├── universe/            # World and player save data
│   └── worlds/          # Individual world folders
├── bans.json            # Banned players list
├── config.json          # Main server configuration
├── permissions.json     # Permission configuration
├── whitelist.json       # Whitelisted players
├── HytaleServer.jar     # Server executable
└── HytaleServer.aot     # Ahead-of-time cache for faster startup

Configuration Files

config.json

The main server configuration file. Key settings include:

• Server name and description
• Max players
• Game modes
• World settings

permissions.json

Defines player permissions and groups. Use this to:

• Create admin groups
• Assign specific permissions to players
• Set up moderation hierarchies

whitelist.json

List of players allowed to join when whitelist is enabled.

bans.json

List of banned players with reasons and durations.

Universe Structure

The universe/worlds/ directory contains all playable worlds. Each world has its own config.json:

{
  "Version": 4,
  "Seed": 1767292261384,
  "WorldGen": {
    "Type": "Hytale",
    "Name": "Default"
  },
  "IsTicking": true,
  "IsPvpEnabled": false,
  "IsFallDamageEnabled": true,
  "IsGameTimePaused": false,
  "IsSpawningNPC": true,
  "IsSavingPlayers": true,
  "IsSavingChunks": true,
  "IsUnloadingChunks": true
}

Key World Settings

Launch Arguments

View all available arguments:

java -jar HytaleServer.jar --help

Common Launch Options

Example Launch Command

java -jar HytaleServer.jar --assets ../Assets.zip --bind 0.0.0.0:5520 --backup --backup-frequency 15

Logs Directory

Server logs are stored in the logs/ directory. Check these when troubleshooting:

• Connection issues
• Plugin errors
• World generation problems
• Crash reports

Backups

Enable automatic backups to protect your world data:

java -jar HytaleServer.jar --assets PathToAssets.zip --backup --backup-dir /path/to/backups --backup-frequency 30