🎮 Hytale F2P Launcher 🚀

💻 Cross-Platform Multiplayer 🖥️

Available for Windows 🪟, macOS 🍎, and Linux 🐧

An unofficial cross-platform launcher for Hytale with automatic updates and multiplayer support!

⚠️ WARNING: READ QUICK START before Downloading & Installing the Launcher! ⚠️

🛑 PROBLEM WITH GITHUB REPO Join the HF2P Discord TO DOWNLOAD THE LATEST VERSION 🛑

👍 If you like the project, feel free to support us via Buy Me a Coffee! ☕
Any support is appreciated and helps keep the project going.

⭐ If you find this project useful, please give it a STAR! ⭐

View Gallery

Featured Servers 🆕	Settings Page ⚙️
Downloadable Mods from CurseForge 🛠️	My Mods Menu 🔧
In-Game Screenshot - Spawn Point 🎮	In-Game Screenshot - Gameplay Terrain 🌳

🎯 Core Features

• 🔄 Automatic Updates - Smart version checking and seamless game updates
• 💾 Data Preservation - Intelligent UserData backup and restoration during updates
• 🌐 Cross-Platform - Full support for Windows x64, Linux x64 (X11/Wayland, SteamDeck), and macOS Silicon
• ☕ Java Management - Automatic Java runtime detection and installation
• 🎮 Multiplayer Support - Automatic multiplayer client installation (Windows, macOS & Linux !)

🛡️ Advanced Features

• 📁 Custom Installation - Choose your own installation directory
• 🔍 Smart Detection - Automatic game and dependency detection
• 🗂️ Mod Support - Built-in mod management system
• 📰 News Feed - Stay updated with the latest Hytale news
• 🎨 Modern UI - Clean, responsive interface with dark theme

^{Note 1} Using Discrete/Dedicated GPU (dGPU) must have 8 GB RAM minimum, while using Integrated GPU (iGPU) must have 12 GB RAM.

• Java JDK 25:
  • Oracle
  • or Alt 1: Adoptium
  • or Alt 2: Microsoft.
• Latest Visual Studio Redist:
  • Download via All-in-One by Techpowerup
  • Or Microsoft Visual C++ Redistributable

• Make sure you have already installed newest GPU driver especially proprietary NVIDIA, consult your distro docs or wiki.
  • Also make sure that your GPU can be connected to EGL, try checking it first (again, consult your distro docs or wiki) before installing Hytale game via our launcher.
• [Not needed in update v2.2.0+] Install libpng package to avoid SDL3_Image error:
  • libpng16-16 libpng-dev for Ubuntu/Debian-based Distro
  • libpng libpng-devel for Fedora/RHEL-based Distro
  • libpng for Arch-based Distro

1. Prerequisites: Ensure you have installed all Windows Prerequisites listed above.
2. Download: Get the latest Hytale-F2P-Launcher.exe from the Releases page.
3. SmartScreen Note: Since the executable is currently unsigned, Windows may show a "Windows protected your PC" popup.
   • Click More info, then click Run anyway.
4. Launch: Once installed, you can launch the app directly from your Desktop or the Start menu.
5. Whitelist in Windows Firewall #192
   • Open the Windows Start Menu and search for Allow an app through Windows Firewall
   • Click "Change settings" (you may need Admin privileges) and Locate HytaleClient.exe in the list.
   • Ensure both the Private and Public checkboxes are checked. Click OK to save.

1. Prerequisites: Ensure you have installed all Linux Prerequisites above.
2. Download: Choose the package that fits your distribution from the Releases page:
   • Universal: .AppImage
   • Arch Linux: .pkg.tar.zst
   • Fedora/RHEL/openSUSE: .rpm
   • Debian/Ubuntu: .deb
3. Permissions & Execution:
   • AppImage: Make the file executable and run it:

     chmod +x hytale-f2p-launcher.AppImage
     ./hytale-f2p-launcher.AppImage

   • Ubuntu/Debian-based or Fedora/RHEL-based: Install the DEB/RPM:

     # Fedora/RHEL-based
     sudo dnf install hytale-f2p-launcher.rpm
     # Debian/Ubuntu
     sudo apt install -y libasound2 libpng16-16 libpng-dev libicu76 # Not needed in v2.2.0+
     sudo dpkg -i hytale-f2p-launcher.deb

   • Arch Linux (pacman): Install the package using:

     # Stable Build
     sudo pacman -U hytale-f2p-launcher.pkg.tar.zst
     # Development Build
     yay -S hytale-f2p-git # or
     paru -S hytale-f2p-git
     # Manual Build
     git clone https://aur.archlinux.org/hytale-f2p-git.git
     cd hytale-f2p-git
     makepkg -si

1. Download: Get the latest .dmg file from the Releases page.
2. Mount: Double-click the .dmg file to open it.
3. Install: Drag the Hytale F2P Launcher icon into your Applications folder.
4. First Run: If macOS prevents the app from opening because it is from an "unidentified developer":
   • Open System Settings > Privacy & Security.
   • Scroll down to the Security section.
   • Look for the message regarding "Hytale F2P Launcher" and click Open Anyway.
   • Authenticate with your password and click Open.

The .zip version is useful for users who prefer a portable installation or need to bypass specific permission issues.

1. Extract: Download and unzip the file to your desired location (e.g., ~/Applications).
2. Remove Quarantine: macOS often "quarantines" apps downloaded via browser. If the app won't open, open Terminal and run:

   xattr -rd com.apple.quarantine /path/to/Hytale-F2P-Launcher.app

1. Open your Singleplayer World
2. Pause the game (Esc) > select Online Play > Turn on Allow Other Players to Join > Set password if needed > Press Save.
3. Check the status Connected via UPnP, it means you can use the Invite Codes for your friends.
4. If your friends can't connect to your hosted Online-Play feature OR if it's showing "Restricted (no UPnP), please follow the Tailscale/Playit.gg/Radmin tutorial in SERVER.md.

See TROUBLESHOOTING.md for detailed Troubleshooting guide.

See BUILD.md for comprehensive build instructions.

• 👚 Avatar Not Saving Bug Fix: FINALLY, the long-awaited avatar saves is now working! 🙌 Show off your avatar skin in our Discord #-media text channel! 👀
• 🚀 HytaleClient Fails to Launch and Persists in Task Manager Bug Fix: Major bug fix for all affected Windows users! No more ghost processes of HytaleClient.exe in Task Manager! And no more launch fail, that's hella one of an achievement 🔥 (If problem persists please create issue on Github 😢)
• 🚦 EPERM Bug Fix in 'Repair Game' Button: Repair game will not produce Error Permission (EPERM) any more.
• 🚨 'Server Failed to Boot' Bug Fix: Happy news for internet-limited countries (e.g. 🇷🇺 Russia, 🇹🇷 Turkey, 🇧🇷 Brazil, etc.)! The launcher now using proxy to access our patched JAR & check game version release status!🎉 Make sure you're already allow the HytaleClient.exe on Public & Private Windows Firewall 😉!
• ⚡ GPU Detection System Enhancements: The detection system will now detect your GPU with CimInstance instead of WmicObject, which deprecated for most Windows 11 updates. Also, it's show how much your VRAM on each iGPU and dGPU! 🔍
• ⚠️ Failed to Deserialize Packets Bug Fix: Shared libzstd library didn't get detected in Fedora/Bazzite/RHEL-based Linux Distros due to incorrect checking library order. 📑
• 📟 UUID Persistence Bug Fix: Correlates to the avatar not saving bug, this fixes the persistence UUID when changing username. 🔖
• 🌐 Turkish Translation Fix: 🇹🇷 Turkey players should feel at home now. 🏠

• 🔃 Game Patches Auto-Update Improvement: No need to install 1.5GB for every updates! Game updates now reduced to almost ~90% (Hytale Game Update 3 to 4 only take ~150MB).
• 🩹 Improved Patch System Pre-Release JAR: In previous version, only Release JAR could be patched. Now it also can be used for Pre-Release JAR!
• 🔗 Fix Mods Manager Issue: Mods now can be downloaded seamlessly from the launcher, use Profiles to install your preferred mod. It will also automatically copy from selected Profile/<profilename> to the Mods folder.
• 💾 New User Data Location: UserData Migration to Centralized Location. User data now preserves in HytaleSaves located beside HytaleF2P folder.
• 🎮 SteamDeck and Ubuntu/Debian-based Library Fix: Replace bundled libzstd.so with system version to fix glibc 2.41+ crash.
• 🍎 Launcher auto-update Improvement for macOS: Fix auto-install fails on unsigned app. Added option to download the new launcher version on Github website.
• 🌎 New Translations: Added France 🇲🇫, German 🇩🇪, Indonesian 🇮🇩, Russia 🇷🇺, and Swedish 🇸🇪 translations to the launcher.
• 🔐 Fixes Tar Vulnerability: Updates tar from version 6.2.1 to 7.5.7 for vulnerability issue.
• ⚙️ Improved Settings Pane UI: Settings are now shown in two columns instead of one. No more doom scrolling just to change your language.
• ⭐ Added Features Servers: Don't know which one to play? Join our Featured Servers!
• 💬 Removed Chat Pane and Add Discord Feature: Useless chat feature, we got Discord. Join it, NOW. Also added Discord RPC features to Github and our Discord Server. SHOW OFF TO YOUR FRIENDS.
• 🔍 Investigation on Avatar Not Saving Bug: We are currently investigating this issue.

• @amiayweb - Lead Developer & Project Creator
• @Relyz1993 - Server Helper & Second Developer & Project Creator

• @sanasol - Main Issues fixer | Multiplayer Patcher
• @Terromur - Main Issues fixer | Beta tester
• @fazrigading - Main Issues fixer | Beta tester | Github Release Maintainer
• @ericiskoolbeans - Beta Tester
• @chasem-dev - Issues fixer
• @Rahul-Sahani04 - Issues fixer
• @xSamiVS - Issues fixer | Language Translator

• @GreenKod - Code refractor
• @Citeli-py - Linux fix & packages version in early release
• @crimera - Generate new UUID for new username string feature
• @letha11 - CSS filename typo fix
• @colbster937 - Icon upscaler
• @ArnavSingh77 - Close game launcher on start feature, improve app termination behavior
• @TalesAmaral - BUILD.md link fix in README.md

• @BlackSystemCoder - Russian Language Translator
• @walti0 - Polish Language Translator

This launcher is created for educational purposes only.

🏛️ Not Official - This is an independent fan project not affiliated with, endorsed by, or associated with Hypixel Studios or Hytale.

🛡️ No Warranty - This software is provided "as is" without any warranty of any kind.

📝 Responsibility - The authors take no responsibility for how this software is used.

🛑 Takedown Policy - If Hypixel Studios or Hytale requests removal, this project will be taken down immediately.

❤️ Support Official - Please support the official game by purchasing it legally when available.