How to Set Up a Hytale Server: Complete 2026 Installation & Configuration Guide

Ready to host your own Hytale server? Whether you're setting up a private world for friends or launching a public community server, this comprehensive guide walks you through every step of the process—from installing Java to optimizing performance for hundreds of players. By the end of this guide, you'll have a fully functional Hytale dedicated server ready for players to join. Let's get started. System Requirements Before diving into installation, ensure your server machine meets these minimum requirements: ComponentMinimumRecommended RAM4 GB8-16 GB CPU2 cores4+ cores Storage10 GB SSD50+ GB NVMe SSD JavaJava 25Java 25 (Adoptium recommended) Architecturex64 or arm64 supported OSWindows, Linux, or macOS Understanding Resource Usage Hytale server resource consumption depends heavily on player behavior: CPU Usage: Driven by player count and entity counts (NPCs, mobs, active creatures) RAM Usage: Driven by loaded world area—higher view distance and players exploring independently increases memory needs Pro Tip: Monitor RAM and CPU usage during gameplay to understand your server's typical consumption. If you notice high CPU usage, it may indicate memory pressure causing excessive garbage collection—try adjusting Java's -Xmx parameter. Step 1: Install Java 25 Hytale servers require Java 25. We recommend using Adoptium (formerly AdoptOpenJDK) for reliable, production-ready builds. Download Java 25 Visit adoptium.net Download the JDK 25 installer for your operating system Run the installer and follow the prompts Verify Installation Open a terminal or command prompt and run: java --version You should see output similar to: 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) If you see a different version or an error, ensure Java 25 is properly installed and added to your system PATH. Step 2: Obtain Server Files You have two options for getting the Hytale server files: Option A: Copy from Your Game Installation (Quick Testing) The easiest method for quick setup—copy files directly from your Hytale launcher installation: File Locations: Operating SystemPath 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 dedicated server location. Option B: Hytale Downloader CLI (Production Servers) For production environments, use the official Hytale Downloader CLI tool. This makes updates easier and supports automation: Download hytale-downloader.zip from the official Hytale support site Extract and read the included QUICKSTART.md Run the downloader to fetch the latest server files Common Commands: CommandDescription ./hytale-downloaderDownload latest release ./hytale-downloader -print-versionShow game version without downloading ./hytale-downloader -patchline pre-releaseDownload from pre-release channel Step 3: Start Your Server Navigate to your server directory and launch with: java -XX:AOTCache=HytaleServer.aot -jar HytaleServer.jar --assets Assets.zip The -XX:AOTCache flag uses the pre-trained Ahead-Of-Time cache that ships with the server, significantly improving startup times. First-Time Authentication After the first launch, you must authenticate your server. In the server console, run: /auth login device You'll see a device authorization prompt: =================================================================== DEVICE AUTHORIZATION =================================================================== Visit: https://accounts.hytale.com/device Enter code: ABCD-1234 =================================================================== Waiting for authorization (expires in 900 seconds)... Visit the URL shown in your browser Log in with your Hytale account Enter the code displayed in the console Return to the console—you should see "Authentication successful!" Important: Each Hytale game license supports up to 100 servers. For larger deployments, purchase additional licenses or apply for a Server Provider account. Step 4: Configure Ports and Firewall Hytale uses QUIC protocol over UDP (not TCP). This is important for firewall and port forwarding configuration. Default Port The default port is 5520. To use a different port: java -jar HytaleServer.jar --assets Assets.zip --bind 0.0.0.0:3500 Port Forwarding If hosting behind a router, forward UDP port 5520 (or your custom port) to your server machine. TCP forwarding is not required. Firewall Configuration Windows (PowerShell as Administrator): New-NetFirewallRule -DisplayName "Hytale Server" -Direction Inbound -Protocol UDP -LocalPort 5520 -Action Allow Linux (iptables): sudo iptables -A INPUT -p udp --dport 5520 -j ACCEPT Linux (ufw): sudo ufw allow 5520/udp NAT Considerations QUIC handles NAT traversal well in most scenarios. If players have trouble connecting: Ensure port forwarding is specifically for UDP, not TCP Symmetric NAT configurations may cause issues—consider a VPS or dedicated server Players behind carrier-grade NAT (common on mobile) should connect fine as clients Server File Structure Understanding your server's file structure helps with management and troubleshooting: PathDescription .cache/Cache for optimized files logs/Server log files mods/Installed mods universe/World and player save data bans.jsonBanned players list config.jsonServer configuration permissions.jsonPermission configuration whitelist.jsonWhitelisted players World Structure Worlds are stored in universe/worlds/. Each world has its own config.json with settings for: World seed and generation type PvP enabled/disabled Fall damage settings NPC spawning behavior Required plugins Each world runs on its own main thread, with parallel work distributed across a shared thread pool. Installing Mods Adding mods to your Hytale server is straightforward: Download mods (.zip or .jar files) from CurseForge or other trusted sources Place the mod files in your server's mods/ folder Restart the server Note: Many mods work server-side only—players joining your server will automatically receive the mod content without manual installation. Performance Optimization View Distance View distance is the primary driver of RAM usage. The default view distance of 384 blocks (12 chunks) is equivalent to approximately 24 Minecraft chunks. Recommendations: For small servers (1-10 players): Default settings work well For medium servers (10-50 players): Consider limiting to 8-10 chunks For large servers (50+ players): Limit to 6-8 chunks and monitor resources Recommended Plugins Major hosting providers maintain useful plugins for server management: PluginDescription Nitrado:WebServerBase plugin for web applications and APIs Nitrado:QueryExposes server status via HTTP (player counts, etc.) Nitrado:PerformanceSaverDynamically limits view distance based on resources ApexHosting:PrometheusExporterExposes detailed server and JVM metrics Disable Sentry During Development If you're developing plugins, disable crash reporting to avoid submitting development errors: java -jar HytaleServer.jar --assets Assets.zip --disable-sentry Server Commands Reference View all available server arguments with: java -jar HytaleServer.jar --help Common Arguments: ArgumentDescription --assets <path>Path to Assets.zip (default: ../HytaleAssets) --bind <address:port>Address to listen on (default: 0.0.0.0:5520) --auth-mode <mode>Authentication mode: authenticated or offline --backupEnable automatic backups --backup-dir <path>Backup directory location --backup-frequency <minutes>Backup interval (default: 30) --disable-sentryDisable crash reporting Multiserver Architecture Hytale natively supports routing players between servers—no reverse proxy like BungeeCord required. Player Referral Transfer connected players to other servers with an optional data payload: PlayerRef.referToServer(host, port, optionalData) Security Note: The payload passes through the client and can be tampered with. Use cryptographic signing (e.g., HMAC with a shared secret) to verify authenticity on the receiving server. Connection Redirect During connection handshake, redirect players to different servers for load balancing or regional routing. Disconnect Fallback When players disconnect unexpectedly (server crash, network issues), the client automatically reconnects to a pre-configured fallback server instead of returning to the main menu. Getting Your Server Listed Once your server is running, get it in front of players: Submit to HytaleCharts: Add your server to our server list for free exposure Official Server Discovery: Opt into Hytale's built-in server browser (coming soon) Build Your Community: Create a Discord server and social media presence Tips for Better Rankings: Maintain high uptime (99%+) Keep your server updated to the latest version Write a compelling server description with relevant keywords Encourage players to vote for your server Troubleshooting Common Issues Players Can't Connect Verify your firewall allows UDP on port 5520 Confirm port forwarding is set up for UDP (not TCP) Check that your server is authenticated Ensure players are on the same game version as your server High Memory Usage Reduce view distance Limit maximum player count Check for memory-intensive mods Adjust -Xmx parameter appropriately Server Lag Monitor entity counts (too many mobs/NPCs) Check CPU usage during peak times Use performance monitoring plugins Consider upgrading hardware if consistently maxed Authentication Issues Re-run /auth login device Ensure your Hytale account is in good standing Check you haven't exceeded the 100 server limit per license Key Takeaways Java 25 Required: Use Adoptium for reliable builds UDP Port 5520: QUIC protocol requires UDP, not TCP Authentication Required: Run /auth login device after first launch View Distance = RAM: Lower view distance to reduce memory usage AOT Cache: Use -XX:AOTCache=HytaleServer.aot for faster startup Mods Folder: Drop mods into mods/ and restart Native Multiserver: No proxy needed for server-to-server transfers Your Hytale server is now ready for players. Submit it to HytaleCharts to start building your community!