Common Issues
Players Stuck on ‘Done’ When Connecting
Section titled “Players Stuck on ‘Done’ When Connecting”Players see a ‘Done’ loading screen and never fully connect to the server.
Almost always a corrupted or incorrectly structured mod in Resources/Client/.
- Remove all mods from
Resources/Client/temporarily (move them via SFTP or the Files tab). - Restart the server and confirm it comes up normally.
- Add mods back one at a time, restarting after each, until you find the offending file.
- Replace the corrupted mod or use the Mods tab to get a clean copy.
Backend Failed to Respond to a Heartbeat
Section titled “Backend Failed to Respond to a Heartbeat”Backend failed to respond to a heartbeat. Your server may temporarily disappear from the serverlist.This is not always an error. BeamMP heartbeats every 30 seconds. A single missed heartbeat is normal and the server re-appears quickly.
If the message appears repeatedly, check in this order:
- Invalid auth key - verify the key in the Startup tab matches the one in BeamMP Keymaster.
- Server connection issue - restart the server from the Console tab.
- BeamMP backend outage - check the BeamMP status page or their Discord. If the backend is down, wait it out.
Players Can’t Connect
Section titled “Players Can’t Connect”| Symptom | Potential Fix |
|---|---|
| Server not in browser | Check auth key is valid and Private = false |
| ”Connection refused” on direct connect | Verify IP and port in the Console tab |
| Players timeout on join | Large mod pack - consider reducing mods |
| Players kicked immediately | Check CE/Nickel whitelist settings |
Error Codes
Section titled “Error Codes”| Code | Meaning | Fix |
|---|---|---|
10022 | Issue binding to the allocated port | Contact Vyper Hosting support |
10051 | Network unreachable | Verify the server is running and the port is correct |
10052 | Network reset | Connection dropped during setup - retry |
10053 | Connection aborted | Timeout or network error - retry |
10054 | Connection reset by peer | A client disconnected - normal, not an error |
For codes not listed here, refer to Windows Sockets Error Codes.
Still Stuck?
Section titled “Still Stuck?”Open a support ticket from the billing panel or reach us on Discord. Include the relevant Console output so our team can diagnose quickly.