Aloft Server Troubleshooting
Solutions to common Aloft dedicated server problems — connection issues, friend codes, browser visibility, and more.
This guide covers the most common Aloft server issues and how to fix them.
Friend Code Changed After Restart
This is normal. Aloft generates a new Friend Code every time the server starts. The code is saved to ServerRoomCode.txt in the server files.
After each restart:
- Go to Files in the XGamingServer Panel
- Open
ServerRoomCode.txt - Share the new code with your players
Server Not Appearing in Browser
The Aloft server browser can take 15–30 minutes to display a new or restarted server.
Fixes:
- Use the Friend Code method instead — it works immediately
- Make sure
isvisibleis set totruein your Startup settings - Wait at least 15 minutes before checking the browser
- Select the correct region filter in the server browser
"The Host Needs to Trust You Before You Can Spawn Your Home Island"
This error is related to the privateislands setting.
Fixes:
- Check your Startup settings — try toggling
privateislandsbetweentrueandfalse - Have the admin manually trust the player (if applicable in your version)
- As a workaround, restart the server and have the affected player join first
Can't Connect with Friend Code
- Verify you're copying the code from the latest
ServerRoomCode.txt— it changes on every restart - Make sure the server is fully started (check the Console for startup completion)
- Have the player restart their game client and try again
Server Name Shows Incorrectly
- Server names cannot contain spaces or special characters
- Use underscores (
_) or dashes (-) instead of spaces - Check the Startup page to verify the name is set correctly
World Not Loading
- The map name used in the load command must exactly match the name used when creating the world (case-sensitive)
- Check the Console for error messages on startup
- If the world is corrupted, you may need to Reset Your Server and create a new world
Log File Debugging
Aloft writes server logs to output.log in the server root. This file is overwritten on each restart, so save a copy before restarting if you're debugging an issue.
View the log via Files in the panel, or check the Console for real-time output.
Xbox / Crossplay Players Can't Join
- Aloft supports PC and Xbox crossplay
- Make sure the server is visible or share the Friend Code
- Xbox players may need to use the in-game invite system rather than the server browser
💡 Still stuck? Join our Discord for support.
Related Guides
How is this guide?
