How to Create a Hytale Server: Complete Guide

1. Prerequisites

To host a Hytale server, you need a device with:

• At least 4 GB of memory (RAM)
• Java 25 installed
• A stable internet connection

Note: Resource usage depends on the number of players and their play style. Monitor RAM and CPU usage to adjust settings accordingly.

2. Installing Java 25

Download and install Java 25 from Adoptium.

Verify the installation with the following command:

java --version

You should see an output similar to:

openjdk 25.0.1 2025-10-21 LTS
OpenJDK Runtime Environment Temurin-25.0.1+8 (build 25.0.1+8-LTS)
OpenJDK 64-Bit Server VM Temurin-25.0.1+8 (build 25.0.1+8-LTS, mixed mode, sharing)

3. Obtaining the server files

Two methods are available:

Method 1: Manually copy from the launcher

Locate the files in the Hytale launcher installation directory:

• Windows: %appdata%\Hytale\install\release\package\game\latest
• Linux: $XDG_DATA_HOME/Hytale/install/release/package/game/latest
• macOS: ~/Application Support/Hytale/install/release/package/game/latest

Copy the Server folder and the Assets.zip file to your server directory.

Method 2: Use the Hytale Downloader CLI

Download the Hytale Downloader and run the following command:

./hytale-downloader

To download the latest server version and assets.

4. Starting the server

Navigate to the server directory and run:

java -jar HytaleServer.jar --assets PathToAssets.zip

Authentication

On first launch, authenticate your server by following the instructions:

> /auth login device
===================================================================
DEVICE AUTHORIZATION
===================================================================
Visit: https://accounts.hytale.com/device
Enter code: ABCD-1234
Or visit: https://accounts.hytale.com/device?user_code=ABCD-1234
===================================================================
Waiting for authorization (expires in 900 seconds)...

Go to the provided link and enter the code to authorize the server.

Note: There is a limit of 100 servers per Hytale game license. For more capacity, purchase additional licenses or request a Server Provider account.

5. Network configuration

The server uses port 5520/UDP by default.

Opening the port on the firewall

Depending on your system, use the following commands:

• Windows (PowerShell):

New-NetFirewallRule -DisplayName "Hytale Server" -Direction Inbound -Protocol UDP -LocalPort 5520 -Action Allow

• Linux (iptables):

sudo iptables -A INPUT -p udp --dport 5520 -j ACCEPT

• Linux (ufw):

sudo ufw allow 5520/udp

Port forwarding

If you are using a router, forward port 5520/UDP to your server’s local IP address.

6. File structure

Main directories and files:

7. Tips and tricks

Installing mods

Download mods (.zip or .jar files) from sources such as CurseForge and place them in the mods/ directory.

View distance

View distance has a strong impact on RAM usage. A value of 12 chunks (384 blocks) is recommended for a good balance between performance and gameplay experience.

Disable Sentry

To avoid sending error reports during plugin development, use the following option:

java -jar HytaleServer.jar --assets PathToAssets.zip --disable-sentry

8. Useful arguments

Here are some useful arguments to customize server startup:

To view all available arguments:

java -jar HytaleServer.jar --help

9. Delegate your server hosting

You can also subscribe to a Hytale server hosting service to avoid dealing with technical installation.

For example, Oxygenserv provides a complete control panel with the ability to install, manage, and update mods or extensions in just a few clicks, without handling complex files. This is complemented by resource management tools (RAM, CPU), log access, scheduled restarts, and real-time server monitoring, ensuring stability, performance, and service continuity.

With this solution, administrators can focus on gameplay, content creation, and community management, while relying on a reliable infrastructure and dedicated technical support.

10. Next steps

Check out the Multiserver Architecture section to learn more about managing multiple servers, player redirections, and advanced architectures.

For more information, see the official Hytale manual.

List your Hytale server on our ranking to increase its visibility.