GameServerGuides
    Back to Setup Guides
    Windows

    Hytale Server Setup on Windows

    Complete guide to installing and running a Hytale dedicated server on Windows using Java 25.

    1Install Java 25 LTS

    Hytale requires Java 25 LTS. We recommend using Adoptium Temurin.

    1. Download Java 25 from Adoptium Temurin Releases
    2. Run the installer and follow the prompts
    3. Verify installation by opening Command Prompt and running:
    java --version

    You should see output like: openjdk 25.0.1 2025-10-21 LTS

    2Get the Server Files

    Copy the server files from your Hytale game installation.

    1. Navigate to your Hytale installation folder:
      %appdata%\Hytale\install\release\package\game\latest
    2. Create a new folder for your server, e.g., C:\HytaleServer
    3. Copy the Server folder and Assets.zip file to your server folder

    Alternative: Hytale Downloader

    For production servers, use the Hytale Downloader CLI for easy updates.

    3First Server Launch

    Start the server for the first time to generate configuration files.

    cd C:\HytaleServer\Server
java -jar HytaleServer.jar --assets ..\Assets.zip

    Performance Tip

    For faster startup, use AOT caching:

    java -Xms4G -Xmx8G -XX:AOTCache=HytaleServer.aot -jar HytaleServer.jar --assets ..\Assets.zip

    4Authenticate Your Server

    Unlike other games, Hytale servers must be linked to your account. Each account can create up to 100 servers.

    1. In the server console, type the authentication command:
    /auth login device
    1. A code will be displayed (e.g., ABCD-1234)
    2. Go to accounts.hytale.com/device
    3. Enter the code and authorize
    4. Your server is now authenticated!

    Important

    The authentication code expires after 900 seconds (15 minutes). Complete the process before it expires.

    5Configure Windows Firewall

    Hytale uses the QUIC protocol over UDP. Open the required port in Windows Firewall.

    # Run in PowerShell as Administrator
New-NetFirewallRule -DisplayName "Hytale Server" -Direction Inbound -Protocol UDP -LocalPort 5520 -Action Allow

    Port Forwarding Required

    If hosting from home, forward UDP port 5520 on your router. TCP forwarding is NOT required.

    6(Optional) Custom Port

    To use a different port, specify it in the startup command:

    java -jar HytaleServer.jar --assets ..\Assets.zip --bind 0.0.0.0:25565

    Connecting to Your Server

    Once your server is running and authenticated, players can connect using:

    • Direct Connect: Use your public IP and port (e.g., 123.45.67.89:5520)
    • Find your IP: Visit whatismyip.com