Welcome to this ultimate guide! Do you dream of building your own world on Orbis and inviting your friends? Creating a Hytale server can seem daunting at first, especially when you read the technical documentation. Don’t panic: we’ve broken down the official manual to offer you a simple, clear, and accessible method, even if you’ve never touched a server in your life.
⚙️ Technical Prerequisites
Before you begin, make sure your machine (PC or dedicated server) meets these requirements:
- RAM: 4 GB minimum.
- Processor: x64 or arm64.
- Java 25: This is essential. Hytale requires Java 25 LTS version .
Tip: We recommend installing Adoptium (Temurin) to get Java 25. Once installed, check your version by typing
java --versionin your Windows or Linux terminal. You should get something like this:
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)📥 Step 1: Retrieve the files from the server
There are two methods, but to start, the manual method is the simplest:
- Go to the folder where your Hytale game is installed on your PC.
- The path usually looks like this:
%appdata%\Hytale\install\release\package\game\latest. - Look for the folder named “Server” and the file “Assets.zip” .
- Copy these two items into a new, clean folder on your desktop (name it
MyHytaleServer).
The second method is the “Hytale Downloader CLI”, the recommended method for production servers and easy updates.
The Hytale Downloader (Linux & Windows) is a command-line tool that allows you to download files and assets from the server using secure OAuth2 authentication. You might end up with a file with a rather long name, such as “hytale-downloader-linux-amd64”. Rename it to something like “hytale-downloader-linux-amd64 hytale-downloader ” to make things easier later!
| Order | Description |
./hytale-downloader | Download the latest available version. |
./hytale-downloader -print-version | Displays the game version without starting the download. |
./hytale-downloader -version | Displays the current version of the hytale-downloader tool. |
./hytale-downloader -check-update | Check if an update for the tool is available. |
./hytale-downloader -download-path game.zip | Download the files to a specific file (here game.zip). |
./hytale-downloader -patchline pre-release | Download the files from the “pre-release” channel. |
./hytale-downloader -skip-update-check | Ignore automatic update checks at launch. |
🚀 Step 2: First Launch and Authentication
Unlike other games, your Hytale server must be linked to your account to function. Each Hytale account can create up to 100 servers.
- Open a command prompt in your folder.
- Start the server with this command:
java -jar HytaleServer.jar --assets PathToAssets.zipshould be replaced with the actual path to the asset file on their machine (ex:C:\MyServer\Assets.zip). - Authentication: The server will display a message asking you to log in.
- Type the command
/auth login deviceinto the server console. - A code (e.g., ABCD-1234) will be displayed.
- Go to accounts.hytale.com/device and enter the code.
- Once validated, your server is officially authorized!
- Type the command
> /auth login device
===================================================================
AUTORISATION DE L'APPAREIL
===================================================================
Rendez-vous sur : https:<em>//accounts.hytale.com/device </em>
Saisissez le code : ABCD-1234
Ou rendez-vous sur : https:<em>//accounts.hytale.com/device?user_code=ABCD-1234 </em>
===================================================================
En attente d'autorisation (expiration dans 900 secondes)...
[L'utilisateur termine l'autorisation dans le navigateur]
> Authentification réussie ! Mode : OAUTH_DEVICE📂 Step 4: Personalize your world
Once launched, your folder will fill up with new files. Here are the most important ones for you:
| Path | Description |
|---|---|
.cache/ | Cache for optimized files |
logs/ | Server log files |
mods/ | Mods installed |
universe/ | Player and world save data |
bans.json | Banned players |
config.json | Server configuration |
permissions.json | Configuring permissions |
whitelist.json | players on the white list |
💡 Tips for a smooth server
- More RAM: If you have many players, increase the memory limit in your launch command (e.g.,
-Xmx8Gto 8 GB). - Startup speed: The Hytale server offers an AOT caching system. To start faster, use:
java -XX:AOTCache=HytaleServer.aot -jar HytaleServer.jar --assets Assets.zip
💡Modify and allow port connections
The default port is 5520. Change it if necessary.
java -jar HytaleServer.jar --assets PathToAssets.zip --bind 0.0.0.0:25565
Firewall and network configuration
Hytale uses the QUIC protocol over UDP (not TCP). Configure your firewall and port forwarding accordingly.
If your server is located behind a router, forward UDP port 5520 (or your custom port) to your server machine. TCP forwarding is not necessary.
Firewall rules
Pare-feu Windows Defender :
New-NetFirewallRule -DisplayName "Hytale Server" -Direction Inbound -Protocol UDP -LocalPort 5520 -Action AllowLinux (iptables) :
sudo iptables -A INPUT -p udp --dport 5520 -j ACCEPTLinux (ufw):
sudo ufw allow 5520/udp