Hytale

Asset Pack

The asset pack used by the server, containing all game items, textures, models, and other visual resources.

Automatic Update

Update the hytale server automatically

Patchline

What release channel you want to use

Boot Commands

Comma-separated commands to run on server start (executed synchronously in order)

Enable Source Query

Installs the hytale-sourcequery plugin so the server responds to A2S/Source query requests (player count, server name, status). Required for GameCP to monitor the server.

Enforce Permissions

Forces the server to apply predefined file and directory permissions. This is an experimental feature and may cause unexpected behavior. Use at your own risk.

Max View Radius

View distance in chunks. 12-16 recommended for performance. Higher values significantly increase RAM usage.

Default World

The world new players spawn into. If it doesn't exist, the server will create it.

Default Game Mode

The game mode assigned to new players joining the server

Allow Self Operator

Allows players to give themselves operator (admin) permissions using the /op command. Use with caution, as this grants full control over the server.

Auth Mode

Authentication mode

Game Profile (username)

Specify which Hytale profile should be used for server authentication. How to find your profile username: 1. Visit [Hytale Accounts](https://accounts.hytale.com/) 2. Click **Game Profiles** in the left side menu 3. Copy the username of the profile you want to use 4. Paste it into this field Leave empty to use your default/first profile automatically.

Override Session Token

Optional session token used to override the normal server authentication process. This option only takes effect when both override tokens are set. If left empty, the server will request authentication on startup. Intended for game server providers.

Override Identity Token

Optional identity token used to override the default authentication flow. This option only works when both override tokens are provided. If left empty, the server will prompt for authentication as usual. Intended for game server providers.

Use Persistent Authentication

(Not Recommended - Unencrypted) Enabling this option activates the egg's built-in authentication and credentials storage system for the game. If disabled, it is assumed that you will use the game's own authentication system.

Server Password

Access password for the server. Leave empty for public access.

Accept Early Plugins

Acknowledge that loading early plugins is unsupported and may cause stability issues

Backup Frequency

Backup interval in minutes

Enable Backups

Enable automatic backups

Maximum Backups

The maximum number of backups to keep. When this limit is reached, the oldest backups will be deleted automatically.

JVM Arguments

Additional Java Virtual Machine arguments for advanced configuration. Warning: Improper JVM settings can lead to poor performance, crashes, or failure to start. Only modify if you understand what these parameters do.

Leverage Ahead-Of-Time Cache

The server ships with a pre-trained AOT cache (HytaleServer.aot) that improves boot times by skipping JIT warmup. See [JEP 514](https://openjdk.org/jeps/514).

Memory Overhead

The amount of RAM (in MB) kept aside for the system so the server doesn't use everything. Java will get the rest.

Force Network Flush

Forces the server to immediately send all pending network data to clients, bypassing normal buffering. This can reduce delays for critical updates but may slightly increase network usage.

Network Compression

Reduces bandwidth usage at a slight CPU cost. Recommended for public servers.

Disable Sentry Crash Reporting

Important: Disable Sentry during active plugin development. Hytale use Sentry to track crashes. Disable it to avoid submitting your development errors

Event Debug

Enables detailed logging of server events for debugging purposes. Useful for troubleshooting issues or tracking event behavior, but may produce a lot of output.

Logger Level

Sets the logging level for specific components. Use a comma-separated list in the format LoggerName:LEVEL (for example, com.example:INFO) to control how much detail is logged.

Require Valid World Generation

Causes the server to exit with an error code if world gen is invalid.

Require Valid Prefabs

Forces the server to stop and exit with an error if any specified prefab types are invalid. Provide a comma-separated list of prefab categories (e.g. PHYSICS,BLOCKS,BLOCK_STATES,ENTITIES,BLOCK_FILLER) to check. Leave empty to skip validation.

Require Valid Assets

Causes the server to exit with an error code if assets are invalid.

Server Port (Internal)

Game port passed to start.sh for the --bind flag. Mirrors PORT for the Docker image entrypoint.

Query Port (Internal)

Port used by the Source Query plugin for A2S requests. Automatically set to the assigned query port.