Hytale

Server Name

Server name displayed in the server browser

Max Players

Maximum number of concurrent players

Server Port (Internal)

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

Accept Early Plugins

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

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.

Asset Pack

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

Auth Mode

Authentication mode

Automatic Update

Update the hytale server automatically

Backup Frequency

Backup interval in minutes

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

Enable Backups

Enable automatic backups

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 https://openjdk.org/jeps/514

Game Profile (username)

Specify which Hytale profile should be used for server authentication. How to find your profile username: 1. Visit 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.

Patchline

What release channel you want to use

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.

Maximum Backups

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

Boot Commands

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

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.

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.

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.

Query Port (Internal)

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

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.

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.

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.