# Aloft Server Troubleshooting (/docs/aloft/troubleshooting)



This guide covers the most common Aloft server issues and how to fix them.

Friend Code Changed After Restart [#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:

1. Go to **Files** in the [XGamingServer Panel](https://panel.xgamingserver.com)
2. Open `ServerRoomCode.txt`
3. Share the new code with your players

***

Server Not Appearing in Browser [#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 `isvisible` is set to `true` in 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" [#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 `privateislands` between `true` and `false`
* 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 [#cant-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-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 [#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](/docs/aloft/wipe-reinstall) and create a new world

***

Log File Debugging [#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 [#xbox--crossplay-players-cant-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](https://discord.xgamingserver.com) for support.

Related Guides [#related-guides]

* [Connect to Your Server](/docs/aloft/join-server)
* [Configure Your Server](/docs/aloft/server-settings)
* [Console Commands](/docs/aloft/console-commands)