Skip to main content

​
Hytale Troubleshooting

Solutions to common issues with Hytale servers.
Early Access Notice: Hytale is a brand new game. Bugs are expected and server software may change. If you encounter persistent issues, they may be related to the game’s early access status.

​
Authorization Issues

​
Authorization URL Not Appearing

  1. Wait a moment - the URL may take time to generate
  2. Check the full console output (scroll up)
  3. Restart the server and watch for the URL
  4. Make sure installation completed successfully

​
Authorization Failed

  1. Make sure you’re logged into the correct Hytale account
  2. Enter the code exactly as shown (case-sensitive)
  3. Complete both authorization steps
  4. Try restarting the server to get new authorization URLs

​
Second Authorization URL Missing

  1. Complete the first authorization fully
  2. Return to the console and wait for the second URL
  3. The second prompt appears after the first is completed
  4. Restart if the URL doesn’t appear after a minute

​
Server Won’t Start

​
Stuck After Authorization

  1. Give it time - first startup after auth takes longer
  2. Check console for error messages
  3. Restart the server if stuck for more than 5 minutes

​
Out of Memory

  1. Check RAM usage in the Game Panel
  2. Mods require significantly more RAM
  3. Upgrade to a higher RAM plan
  4. Remove some mods to reduce memory usage

​
Missing Files

  1. Try reinstalling from Settings → Reinstall Server
  2. Wait for full installation to complete
  3. Re-do the authorization process

​
Connection Issues

​
Players Can’t Connect

  1. Verify the server is fully started
  2. Check the correct IP and port in Network tab
  3. Ensure no firewall issues on player’s end
  4. Verify the game version matches

​
Connection Timeout

  1. Server may still be starting - wait and retry
  2. Check if server crashed (view console)
  3. Restart the server if needed

​
Server Not in Browser

  1. Use direct connect with IP:Port instead
  2. Server browser features may be limited in early access

​
Performance Issues

​
Server Lag

  1. Check RAM usage - upgrade if maxed out
  2. Too many mods for your plan
  3. Too many players for your plan
  4. Consider upgrading your server plan

​
Crashes When Players Join

  1. Likely a RAM issue with mods
  2. Upgrade to more RAM
  3. Remove some mods
  4. Reduce max players

​
Mod Issues

​
Mods Not Loading

  1. Verify mods are in the correct folder
  2. Check mod compatibility with current version
  3. Restart server after installing mods
  4. Check console for mod errors

​
Crash After Installing Mod

  1. Remove the recently installed mod
  2. Check mod requirements (RAM, dependencies)
  3. Verify mod is compatible with your Hytale version
  4. Try mods one at a time to find the problem

​
Mod Installer Not Working

  1. Stop the server before installing mods
  2. Refresh the panel page
  3. Try manual installation via File Manager
  4. Contact support if issue persists

​
Operator Issues

​
Players Making Themselves Op

This is expected behavior if Allow Operators is 1 (the default). To prevent this:
  1. Go to Startup tab
  2. Set Allow Operators to 0
  3. Restart your server
  4. Manually grant op to trusted players only

​
Can’t Op Players

  1. If Allow Operators is false, use console commands
  2. An existing operator must grant op status
  3. Check command syntax

​
Configuration Issues

​
Settings Not Applying

  1. Make sure to save changes in Startup tab
  2. Restart the server (not just stop/start)
  3. Check console for configuration errors

​
Server Resetting Settings

  1. Stop server before editing configs
  2. Some settings may only be in Startup tab
  3. Check for syntax errors in config files

​
Quick Fixes

​
Force Stop Server

If server is unresponsive:
  1. Use the Kill button in Console tab
  2. Wait 30 seconds
  3. Start again
  4. May need to re-authorize

​
Reset Everything

  1. Go to Settings tab
  2. Click Reinstall Server
  3. Complete authorization again
  4. Warning: This deletes all data!

​
Known Early Access Issues

Since Hytale is in early access, some issues may be game-related:
  • Server software updates may require re-authorization
  • Features may change between updates
  • Some bugs may not have solutions yet
  • Check Hytale official channels for known issues

​
Getting More Help

If you’re still having issues:
  1. Check Console - Look for specific error messages
  2. Check RAM - Many issues are memory-related
  3. Discord Support - Join our Discord
  4. Support Ticket - Open a ticket
When contacting support, include:
  • Console output showing the error
  • Your server plan (RAM amount)
  • List of installed mods
  • Steps to reproduce the issue