Guide

How to Uninstall and Reinstall Hytale

Effectively managing your Hytale installation, whether for troubleshooting persistent issues or simply seeking a fresh start, involves straightforward processes for both the game client and dedicated servers. Understanding these steps ensures a smooth experience, allowing you to quickly get back to exploring Orbis or managing your community.

Uninstalling the Hytale Client

The Hytale client comprises both the game launcher and the game files themselves. Depending on your needs, you can uninstall just the game while keeping the launcher, or perform a complete removal of both.

Uninstalling the Hytale Launcher (and typically the game)

This method removes the Hytale Launcher application from your system, and often, by default, the associated game files as well. You may be prompted to choose whether to retain your game data during this process.

For Windows Users:

Click the Start button, typically found in the bottom-left corner of your screen.
In the search bar that appears, type “Hytale” and press Enter.
When the Hytale application appears in the search results, right-click on it.
From the context menu, select “Uninstall”.
Follow the on-screen instructions of the Hytale Uninstall Wizard. Pay close attention to any prompts asking if you wish to keep your game files and data. By default, proceeding through the wizard will remove both the launcher and the game.
Alternatively, you can navigate to the Control Panel > Programs and Features, locate “Hytale” in the list of installed programs, and click “Uninstall” from there.

For macOS Users:

Open your Applications folder. You can do this by clicking on “Finder” in your Dock, then selecting “Applications” from the sidebar.
Locate the “Hytale Launcher” application icon.
Right-click (or Control-click) on the “Hytale Launcher” icon.
Select “Move to Trash” from the context menu.
To complete the uninstallation, right-click on the “Trash” icon in your Dock and select “Empty Trash”.

Uninstalling the Hytale Game (while keeping the Launcher)

If you wish to remove only the game files, perhaps to free up disk space or resolve game-specific issues, but want to keep the launcher installed and ready for a quick reinstallation, you can do so directly through the Hytale Launcher.

Open the Hytale Launcher application on your computer.
Look for the settings button, which is typically represented by a gear icon, usually located in the top corner of the launcher window. Click on it.
Within the settings menu, you should find an option labeled “Uninstall” or similar. Select this option.
The launcher will likely ask for confirmation before proceeding. Confirm the uninstallation to remove the Hytale game files from your system.

Reinstalling the Hytale Client

Reinstalling the Hytale client is a straightforward process that ensures you have the latest and most stable version of the game. It begins with downloading the official launcher.

Download the Launcher: Visit the official Hytale website at hytale.com. Navigate to the download section and obtain the latest version of the Hytale Launcher installer for your operating system. Always download from the official source to ensure authenticity and security.
Run the Installer: Locate the downloaded installer file (e.g., in your Downloads folder) and execute it. On Windows, it is often recommended to right-click the installer and select “Run as administrator” to prevent potential permission-related issues during installation.
Sign In: Once the launcher is installed and opens, you will be prompted to sign in with your Hytale account credentials. Enter your username and password.
Install the Game: After successfully signing in, the launcher will present you with the option to download and install the Hytale game itself. Follow the prompts to begin the download and installation process. Ensure you have a stable internet connection for this step, as the game files can be substantial.

Tips for Client Installation and Uninstallation

Backup Saves: Before performing a full uninstall, especially if you’re not prompted to keep game files, it’s wise to manually back up your single-player world saves. These are typically found in a universe folder within your Hytale installation directory. Copy this folder to a safe location on your computer.
Fresh Download is Key: When reinstalling, always download a fresh copy of the launcher from the official Hytale website. Using an old installer might lead to outdated components or corrupted files.
Administrator Privileges: Running the launcher installer, and sometimes the launcher itself, as an administrator (on Windows) can resolve many installation and runtime issues related to file permissions.
Check Disk Space: Hytale, like many modern games, requires significant disk space for installation, updates, and temporary files. Before installing or updating, ensure you have ample free space on your hard drive.
Stable Network Connection: Use a stable and reliable internet connection, preferably wired, for downloading the game. Intermittent connections can cause corrupted downloads or installation failures. If you face persistent download issues, try during off-peak hours or consider using a VPN if network restrictions are suspected.
Antivirus/Firewall Interference: Occasionally, antivirus software or firewalls can mistakenly flag parts of the Hytale installer or game files as threats, preventing proper installation or launch. If you encounter issues, try temporarily disabling your antivirus/firewall during the installation process, remembering to re-enable them immediately afterward.
Clear Cache: Hytale can accumulate cache data over time, including previous game builds after updates, which can consume significant disk space. Regularly clearing your cache can help. On Windows, you might find cache data in a path similar to %AppData%/Hytale/cache.
Verify Files/Reset Settings: If you’re experiencing issues but want to avoid a full reinstall, check the launcher’s settings for options to “Verify Game Files” or “Reset Game Settings.” These tools can often fix corrupted data or configuration problems without requiring a complete re-download.

Common Mistakes & Troubleshooting (Client)

Launcher not opening/crashing:
- Try running the launcher as an administrator.
- If your shortcut points to an updater stub instead of the actual launcher, navigate to the install folder (e.g., %appdata%\Roaming\Hytale\install\release\package\launcher\[version folder]) and run hytale-launcher.exe directly.
- Delete the temp_assets folder located in %AppData%/Hytale/cache and then restart the launcher.
- Corrupted installation files are a common cause; a clean reinstall is often the most effective fix.
Download/Patch Errors (“Error applying update,” “Error downloading patch”):
- Insufficient disk space is a frequent culprit. Free up space and retry the download.
- Completely restart the Hytale launcher (close it fully and reopen) before retrying the download.
- Heavy server load can cause these errors; try again during off-peak hours when fewer users are downloading.
- A corrupted cache or a stuck launcher state can often be resolved by uninstalling and redownloading a fresh launcher installer.
“Java Runtime Not Found” Error: This indicates that the Hytale Launcher cannot locate a compatible Java Development Kit (JDK). Manually download and install JDK 25 (or the version specified by Hytale documentation). Then, if the launcher has a settings option to specify the Java path, point it to your newly installed JDK.
Only uninstall file downloaded: This can occur on specific system configurations, such as ARM64 Windows devices. If you find that only an uninstall file is downloaded, use a file archive utility like 7-Zip to open the Hytale Install Launcher file. Inside, you should be able to manually locate and run the hytale launcher.exe file to proceed with the installation.

Managing Your Hytale Server: Reinstallation and Backups

For dedicated Hytale server administrators, managing the server often involves using a hosting provider’s control panel. Reinstalling a server typically means wiping existing files to install a fresh copy of the server software, while backups are paramount for preserving your world data and configurations.

Reinstalling or Resetting a Hytale Server (General for Hosting Panels)

The exact steps may vary slightly depending on your hosting provider, but the general process remains consistent:

Log in to your Server Panel: Access the control panel provided by your Hytale server hosting provider.
Backup Data (Optional but Highly Recommended): Before initiating any reinstall, it is crucial to back up your server data.
- Look for a ‘Backups’ tab or section within your panel and create a new backup.
- For manual backups, ensure the server is completely shut down. Then, use the File Manager or SFTP access provided by your host to download the entire universe folder (which contains all your world data) and the mods folder (if you use server-side modifications). Save these securely to your local computer.
Navigate to Reinstall Option: Within your server panel, search for options like ‘Settings’, ‘Advanced’, ‘Server Actions’, or ‘Reinstall Server’. Select the ‘Reinstall Server’ or ‘Factory Reset’ option.
Confirm Reinstallation: You will likely be prompted to confirm this action, as it will typically delete all existing server files. Some panels offer options such as “Wipe All Files” for a completely fresh start, or “Backup Before Reinstall” as a last-minute safeguard. Choose the appropriate options for your needs.
Start Server: Once the reinstallation process is complete (which may take a few minutes), start your server from the control panel. It will now be running a fresh installation of the Hytale server software.

Backing Up a Hytale Server World

Regular backups are your best defense against data loss due to corruption, accidental deletion, or server issues.

Shut Down the Server: Always shut down your Hytale server completely via your hosting panel before attempting to back up files. This prevents data corruption during the copy process.
Access Server Files: Use your hosting provider’s File Manager or an SFTP client (like FileZilla) to connect to your server’s file system.
Locate and Download: Find the universe folder (containing all your world data) and the mods folder (if you have server-side mods). Download both of these folders to a secure location on your local computer.

Restoring a Hytale Server World

If you need to revert to a previous state or transfer a world, restoring from a backup is essential.

Shut Down the Server: Ensure your Hytale server is completely shut down via your hosting panel.
Access Server Files: Use your File Manager or SFTP client to connect to your server’s file system.
Prepare for Upload: Locate the current universe folder on your server. You can either delete it (if you’re confident in your backup) or, preferably, rename it (e.g., to universe_old) to keep a copy until you confirm the restore is successful.
Upload Backup: Upload your backed-up universe folder into the main directory of your server. It is critical that the uploaded folder is named exactly universe (all lowercase) for the server to recognize it.
Verify Mods (If Applicable): If your backup included specific mods, ensure that these same mod files are present and correctly configured in the server’s mods folder. The world might not load correctly without its associated mods.
Restart the Server: Once the upload is complete, restart your Hytale server from the control panel. The server should now load your restored world.

Tips for Server Reinstallation and Management

Always Backup: This cannot be stressed enough. Before any significant server action—be it a reinstall, an update, or a major configuration change—create a fresh backup of your world and mod files.
Shut Down Server for File Operations: Always ensure the server is completely shut down before you download, upload, or modify any server files. Performing these actions while the server is running can lead to data corruption.
“Wipe All Files” for a Fresh Start: If you’re troubleshooting deep-seated issues or want to eliminate all previous configurations, select the “Wipe All Files” option during a reinstall.
Check Folder Structure: When restoring a world, meticulously verify the folder structure. If you find a path like universe/universe/data after uploading, it means your universe folder is nested too deeply. You’ll need to move the contents of the inner universe folder up one level so that the server directly sees universe/data.

Common Mistakes & Troubleshooting (Server)

Server starting a new world after restore: This is almost always due to an incorrect folder structure (e.g., the universe folder is nested too deeply) or the server not being fully shut down when the files were replaced. Double-check the folder path and ensure the server was offline during the file transfer.
Corrupted world saves: Regular backups are your primary defense. If a world becomes corrupted, your best course of action is to restore from the most recent uncorrupted backup. Some hosting providers offer automatic daily or hourly backups, which can be invaluable in such situations.
Mods not loading: If your server loads but mods are missing or not functioning, ensure that all necessary mod files from your backup were correctly re-uploaded to the server’s mods folder and that they are compatible with the current server version.