Hytale Server Manual

Your complete guide to setting up, configuring, and managing a dedicated Hytale server.

Intended Audience: Server administrators and players hosting dedicated servers.

Server SetupJava files, requirements

Running a Hytale ServerCommands, ports, files

Tips & TricksMods, AOT, Sentry

Multiserver ArchitectureRedirects, Proxies

Misc DetailsJVM, Protocols

Future AdditionsAPI, Payments

Introduction

This article covers the setup, configuration, and operation of dedicated Hytale servers. Intended for server administrators and players hosting dedicated servers.

Server Setup

The Hytale server can run on any device with at least 4GB of memory and Java 25. Both x64 and arm64 architectures are supported.

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

Note: Without specialized tooling, it can be hard to determine how much allocated RAM a Java process actually needs. Experiment with Java\'s `-Xmx` parameter. Increased CPU usage due to GC is a symptom of memory pressure.

Installing Java 25

Install Java 25. We recommend Adoptium.

Confirm Installation

java --version

openjdk 25.0.1 2025-10-21 LTS
OpenJDK Runtime Environment Temurin-25.0.1+8
OpenJDK 64-Bit Server VM Temurin-25.0.1+8

Server Files

1. Manual Copy

Best for quick testing. Annoying to keep updated.

%appdata%\\Hytale\\install\\release\\package\\game\\latest

Copy `Server` folder and `Assets.zip`.

2. Hytale Downloader CLI

Best for production. Easy to keep updated.

Download CLI

Running a Hytale Server

Launch Command

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

Authentication

> /auth login device

DEVICE AUTHORIZATION

Visit: https://accounts.hytale.com/device

Enter code: ABCD-1234

> Authentication successful!

Required for API communication. Limit of 100 servers per game license.

Network Config

Port5520 UDP
ProtocolQUIC

Remember: UDP only. TCP is not required.

Firewall

# Windows PowerShell

New-NetFirewallRule ... -Protocol UDP -LocalPort 5520 ...

# Linux (ufw)

sudo ufw allow 5520/udp

File Structure

config.jsonServer configuration

universe/Worlds and player data

mods/Installed mod files

logs/System logs

whitelist.jsonAccess list

permissions.jsonPermissions

Tips & Tricks

Mods & Plugins

Download mods from CurseForge and drop them in `mods/`.

Recommended Plugins

Nitrado:WebServer - API base
Nitrado:PerformanceSaver - View distance optimizer
ApexHosting:PrometheusExporter - Metrics

AOT Cachejava -XX:AOTCache=HytaleServer.aot ...

Improves server boot times significantly.

View Distance

Recommended: 12 chunks (384 blocks).

Hytale defaults are high (384 blocks ≈ 24 MC chunks). Lower this to save RAM.

Multiserver Architecture

Hytale supports native routing between players and servers. No reverse proxy like BungeeCord is required.

Player Referral

Transfers a connected player to another server. Client opens a new connection.

WARNING: Sign payloads cryptographically to prevent tampering.

Disconnect Fallback

Clients simplify reconnect to a fallback server if the main server crashes.

Soon

Misc Details

JVM ArgumentsUse standard flags like -Xmx.
Protocol UpdatesStrict hashing currently. Future updates will allow ±2 version tolerance.
Maven Artifactscom.hypixel.hytale:Server

Future Additions

Server Discovery: In-game catalogue with verified player counts.
Parties: Group server joining.
Payments: Integrated payment gateway.
API: Official endpoints for player data and telemetry.

Source: Official Hytale Documentation

Contents