Technical Service Bulletins

Issue: When clicking "Start Agent" in the Admin Panel, the Playit agent starts but the Claim Link never appears. Background logs reveal an AgentDisabledOverLimit error.

Cause: Playit.gg limits the number of active agents allowed on free accounts. If you have old, unused agents still registered on your playit.gg account (from previous installations or other computers), the system blocks the creation of new agents.

Resolution:

1. Log into your playit.gg web dashboard and navigate to the Agents tab.
2. Delete any old, unused agents. (Note: Do not delete your Tunnels, only the Agents).
3. In the Ender Core Admin Panel, stop and restart the agent. The Claim Link will now successfully generate and appear in the UI.
4. After clicking the link and claiming the new agent, go to your Tunnel settings on playit.gg and change the "Assign to Agent" dropdown to the newly claimed agent. Your tunnel DNS and port will not change!

Issue: When trying to join the server, the game immediately kicks you with the error message: "Please restart your client. Error: NetherNet".

Cause: The "NetherNet" error is a known bug in Minecraft Bedrock's networking engine. It typically occurs when your game client's internal connection state falls out of sync with the server (often because the server was restarted while your game was still open, or your Xbox Live authentication token expired/desynced).

Resolution:

1. Fully close your game: Don't just go to the main menu. Completely exit and close the Minecraft application on your PC or Console.
2. Restart the Server: In the Admin Panel, click Stop and then Start to completely flush the server's network cache and kick any ghost connections.
3. Wait: Once the server says "Online", wait about 30 seconds before trying to join. Bedrock servers take a moment to fully initialize their Xbox Live authentication services even after the console says they are ready.
4. Launch & Join: Open Minecraft fresh and connect. (Note: If you are playing on Windows and the issue persists, open the Xbox App, sign out, and sign back in to force a refresh of your Xbox Live token.)

Issue: You click "Start Agent" in the Admin Panel, but it instantly crashes or stops without generating a Claim Link. No visible error is shown in the UI.

Cause: If you previously installed the standalone playit.gg program on your computer, it silently installs a background Windows Service named playitd. This hidden service boots up with Windows and locks the agent configuration files. When the Admin Panel attempts to start its own isolated agent, it crashes with an invisible "IPC error: Another instance is already running".

Resolution:

1. Open PowerShell as an Administrator.
2. Run this exact command to forcefully kill and disable the rogue background service:
   Stop-Service -Name "playitd" -Force; Set-Service -Name "playitd" -StartupType Disabled
3. Clear the locked config file by running:
   Remove-Item "$env:LOCALAPPDATA\playit_gg\playit.toml" -Force -ErrorAction SilentlyContinue
4. Go back to the Admin Panel and click Start Agent again. It will now successfully start and generate your Claim Link!