Guide

How to Set Up a Dedicated Hytale Server on Windows

Setting up a dedicated Hytale server on Windows allows you to fully control your game world, customize the experience for your community, and invite friends to play on a persistent, private environment. Hytale officially launched into early access on January 13, 2026, making dedicated server hosting a viable and exciting option for players eager to explore its vast possibilities.

While professional hosting providers offer streamlined, managed solutions, self-hosting a Hytale server on your personal Windows machine is entirely feasible for those with the necessary hardware and technical understanding. This guide will walk you through the precise steps to get your own Hytale server up and running.

Understanding Hytale Server Requirements

Before you begin, ensure your Windows machine meets the following specifications. These recommendations are crucial for a stable and enjoyable server experience, especially as player counts increase or modifications are introduced.

Operating System: Windows 10 or Windows 11 (64-bit) is officially supported.
Java Runtime: Hytale servers specifically require Java 25. It is highly recommended to obtain a clean, reliable build from sources like Adoptium to avoid compatibility issues.
CPU: For smaller groups (up to 4 players), a dual-core x64 processor running at 3.5 GHz or higher is recommended. Hytale’s core game logic is primarily single-threaded, meaning that a higher clock speed often contributes more to performance than a greater number of cores for low player counts. However, CPU load will increase significantly with more players, complex world interactions, or numerous entities.
RAM: While the official minimum specification for RAM is 4 GB, this is often insufficient for smooth gameplay, particularly with multiple players or if the world loads many chunks simultaneously. Such low allocation can lead to frequent server crashes and performance bottlenecks. A more practical starting point is 6-8 GB of RAM for 4-8 players. For larger communities or if you plan to use extensive modifications, you should allocate more. RAM usage directly correlates with the size of the loaded world area and the server’s view distance settings.
Storage: A Solid State Drive (SSD) with at least 20 GB of free space is strongly recommended. An NVMe drive is even better for optimal performance. Slow storage devices can cause noticeable hitches and lag spikes, especially during initial world generation or when new chunks are being loaded.
Network: A minimum upload and download bandwidth of 2 Mbps is required. However, for a smoother experience with multiple players and larger world interactions, 4 Mbps to 10 Mbps is recommended. The Hytale server primarily communicates using UDP port 5520, leveraging the QUIC protocol for efficient data transfer.

Step-by-Step Guide: Setting Up Your Hytale Server

Follow these detailed instructions to configure and launch your dedicated Hytale server on Windows.

1. Install Java 25

The Hytale server software relies on a specific Java runtime environment. Incorrect versions of Java are a common cause of server startup failures.

Download the appropriate Java 25 runtime environment for Windows (64-bit) from a reputable source like Adoptium.
Run the installer and follow the on-screen prompts to complete the installation.
After installation, open the Windows Command Prompt (search for cmd in the Start Menu).
Type java --version and press Enter. Verify that the output confirms Java 25 is installed and correctly recognized by your system.

2. Obtain Hytale Server Files

There are two primary methods to acquire the necessary server files.

Option A (For Quick Testing/Local Play): Copy from Game Installation

This method is suitable for quickly setting up a server for personal use or testing, but it may not always provide the latest server build and requires you to have the Hytale game client installed.
1. Navigate to your Hytale game installation directory. On Windows, this is typically located at %appdata%\Hytale\install\release\package\game\latest. You can paste this path directly into your File Explorer address bar.
2. Inside this directory, locate the Server folder and the Assets.zip file.
3. Copy both the Server folder and the Assets.zip file to a new, dedicated folder you’ve created for your server (e.g., C:\HytaleServer).
Option B (Recommended for Production & Easy Updates): Use the Hytale Downloader CLI

This is the preferred method for maintaining an up-to-date server, as it directly downloads the latest server files and assets from official sources.
1. Download the official Hytale Downloader Command Line Interface (CLI) tool. This will typically be a hytale-downloader.zip file available from official Hytale resources or trusted community sites.
2. Extract the contents of the downloaded hytale-downloader.zip file to a temporary location.
3. Run the executable (e.g., hytale-downloader.exe). This tool will guide you through an OAuth2 authentication process to link with your Hytale account and automatically download the latest server software and asset files into a designated directory.
4. Once the download is complete, ensure the Server folder and Assets.zip file are placed in your chosen server directory (e.g., C:\HytaleServer).

3. Create a Dedicated Server Directory

It’s good practice to keep your server files organized.

Create a new folder on your Windows machine where you want to host your server. A good example is C:\HytaleServer.
Place the Server folder and Assets.zip file (obtained in Step 2) directly into this new directory.

4. Create a Start Script (`run.bat`)

A batch script simplifies launching your server and allows you to allocate specific resources.

Open Notepad or any other text editor.

Paste the following line into the text editor:

java -Xms128M -Xmx6096M -jar Server/HytaleServer.jar --assets Assets.zip PAUSE

Adjust RAM Allocation: The -Xmx6096M part specifies the maximum amount of RAM (in megabytes) that your server can use. In this example, 6096M allocates 6 GB. Adjust this value based on your available RAM and the recommendations in the “Understanding Hytale Server Requirements” section. For example, for 8 GB, you would use -Xmx8192M. The -Xms128M sets the initial RAM allocation.
Save the file in your server directory (e.g., C:\HytaleServer) as run.bat. Make sure to select “All Files” as the “Save as type” in Notepad to prevent it from being saved as run.bat.txt.

5. First Boot and Server Authentication

The first time you run the server, it will require authentication to link with your Hytale account.

Double-click the run.bat file you created. A server console window will open.
During the initial startup, the server will prompt you for authentication. When prompted, type /auth login device into the server console and press Enter.
The console will then display a code and instructions to visit a specific URL (usually a Hytale authentication page) in your web browser. Follow these instructions to link your server instance to your Hytale account online.
After successful authentication, some guides suggest typing /auth persistence Encrypted into the server console. This command is believed to enable persistent authentication, so you don’t have to re-authenticate every time the server starts.

6. Configure Firewall and Port Forwarding

For players outside your local network to connect to your server, you must configure network access.

Windows Firewall:

You need to create a rule in your Windows Firewall to allow incoming UDP traffic on port 5520.
1. Open “Windows Defender Firewall with Advanced Security” (search for it in the Start Menu).
2. In the left pane, click “Inbound Rules.”
3. In the right pane, click “New Rule…”
4. Select “Port” and click “Next.”
5. Select “UDP” and enter 5520 in the “Specific local ports” field. Click “Next.”
6. Select “Allow the connection” and click “Next.”
7. Ensure all profiles (Domain, Private, Public) are checked, or at least “Private” if you’re on a home network. Click “Next.”
8. Give the rule a descriptive name, such as “Hytale Server UDP 5520,” and an optional description. Click “Finish.”
9. Alternatively, you can use PowerShell (run as Administrator) to add the rule:
```
New-NetFirewallRule -DisplayName "Hytale Server" -Direction Inbound -Protocol UDP -LocalPort 5520 -Action Allow
```
Router Port Forwarding:

This is crucial for external players. You need to configure your home router to direct incoming traffic on UDP port 5520 to the internal IP address of the Windows machine hosting your Hytale server.
1. Find your server machine’s internal IP address. Open Command Prompt and type ipconfig. Look for “IPv4 Address” under your active network adapter.
2. Access your router’s administration page. This is usually done by typing your router’s gateway IP (often 192.168.1.1 or 192.168.0.1) into a web browser. Consult your router’s manual or manufacturer’s website for specific instructions, as steps vary widely by model.
3. Look for a section named “Port Forwarding,” “NAT,” “Virtual Servers,” or similar.
4. Create a new rule:
  - Protocol: UDP
  - External/Public Port: 5520
  - Internal/Private Port: 5520
  - Internal IP Address: Enter the internal IP address of your Hytale server machine.
5. Save and apply the changes.

Tips for Hytale Server Hosting

Monitor Resources: Regularly check your server’s CPU, RAM, and disk I/O usage using Windows Task Manager. If you notice consistent high usage or lag, consider upgrading your hardware or reducing server load (e.g., by lowering view distance).
Dedicated Hosting vs. Self-Hosting: While self-hosting is cost-effective for small, private groups, professional Hytale server hosting providers offer significant advantages for larger or public communities. These include guaranteed 24/7 uptime, dedicated resources, DDoS protection, and simplified management interfaces. Self-hosting also exposes your home IP address, which can be a security concern.
Keep Server Files Updated: Always use the Hytale Downloader CLI (Option B in Step 2) to ensure your server runs the latest version. This is vital for compatibility with the latest game client updates, performance improvements, and security patches.
Performance Tuning: The server’s view distance setting can significantly impact RAM consumption and overall performance. Experiment with lower view distances if you experience performance issues, especially on less powerful hardware.

Common Mistakes to Avoid

Insufficient RAM Allocation: One of the most frequent causes of server instability and crashes is allocating too little RAM in your run.bat script (the -Xmx value). While 4 GB is a stated minimum, 6-8 GB is a more practical starting point for smooth operation with even a few players.
Incorrect Java Version: The Hytale server specifically requires Java 25. Using an older version (like Java 8 or Java 17) or a different Java distribution can prevent the server from starting or cause unexpected errors.
Firewall or Port Forwarding Oversights: Forgetting to properly configure both your Windows Firewall and your router’s port forwarding for UDP port 5520 will prevent any external players from connecting to your server, even if it appears to be running correctly on your machine.
Outdated Server Files: Running an old server version can lead to compatibility issues with players using the latest game client, potentially preventing them from joining or causing desynchronization issues.
Ignoring Hardware Limitations: Attempting to host a large-scale server with many players or complex modifications on hardware that does not meet the recommended specifications will inevitably result in poor performance, lag, and a frustrating experience for everyone.

A note of caution: one report mentioned a potential security flaw related to a --allow-op command, though details are scarce and it’s unclear if this has been addressed. Always practice good security hygiene when self-hosting, such as keeping your system and server software updated.