Hytale Server Setup Guide

This guide covers setting up a dedicated Hytale server. All information is from the official Server Manual.

System Requirements

• Minimum RAM: 4GB
• Java: Version 25 (required)
• Architectures: x64 and arm64 supported

Resource Usage

Resource	Main Driver
CPU	High player or entity counts (NPCs, mobs)
RAM	Large loaded world area (high view distance, players exploring)

Installing Java 25

Download and install Java 25 from Adoptium.

Verify the installation:

java --version

Expected output:

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)

Getting Server Files

Option 1: Copy from Launcher

Find files in your launcher installation:

OS	Path
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 Assets.zip to your server location.

Option 2: Hytale Downloader CLI (Recommended)

Download the CLI tool from downloader.hytale.com.

Command	Description
./hytale-downloader	Download latest release
./hytale-downloader -print-version	Show game version
./hytale-downloader -patchline pre-release	Download from pre-release channel

Running the Server

Start the server:

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

Authentication

After first launch, authenticate your server:

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

> Authentication successful! Mode: OAUTH_DEVICE

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

Changing Port

Default port is 5520. Change it with:

java -jar HytaleServer.jar --assets PathToAssets.zip --bind 0.0.0.0:25565

View All Options

java -jar HytaleServer.jar --help

Next Steps

• File Structure - Understand server directory layout
• Configuration - Configure your server
• Network Setup - Firewall and port forwarding