Skip to content

Teeworlds: Common Issues

The most common issues with your Teeworlds server on your VPS and how to fix them quickly, from startup problems to lag → Learn more

12 November 20264 min read16 Views0 helpful

Don't have your own server yet? Host your Teeworlds server with ZAP-Hosting.

Introduction

Running your own Teeworlds server on a VPS is a lot of fun, but it also means taking responsibility when things go wrong. Crashes, lag, and configuration issues are common challenges that every server owner eventually encounters.

To help you spend less time troubleshooting, we’ll show you the most common issues and how to fix them quickly on your VPS.

Issues and solutions

The causes of server issues aren’t always immediately obvious. The best place to start is the server output: if you set up Teeworlds using the Game Server Installer, you’ll find it at C:\ZapX-GameServers\teeworlds\logs\server.log. The installer logs restarts after crashes in logs\supervisor.log.

General

Server not visible

If your server doesn’t appear in the server list, first check whether it’s running and has finished starting up. Check server.log to confirm. If you’ve added sv_register 0 to server.cfg, the server is intentionally hidden from the public list. In that case, add it through Favorites using its IP address and port. Then check that the ports are open in the Windows Firewall and your VPS’s Network Firewall. For the ports Teeworlds needs, see Teeworlds: Set up a server on your VPS. Also make sure there aren’t any filters in the server list hiding your server.

Server won’t start

Start the server via Remote Desktop using the Teeworlds (teeworlds) - Start shortcut and check server.log. Common causes include a typo in data\server.cfg, a map that isn’t in the maps folder, or a port already in use by another program. If you’ve changed the configuration in data\server.cfg, try reverting the change temporarily.

Crashes

Nothing brings a good session to an end faster than an unexpected crash. Possible causes include an outdated server version, an overloaded VPS, or a misconfiguration. The installer automatically restarts your server after a crash. If it crashes several times in quick succession, the installer gives up. You’ll then need to fix the cause and start the server yourself.

Keep your server up to date

An outdated server can cause crashes, unexpected behavior, or startup issues, and often prevents players from connecting with a newer game version. Updates aren’t installed automatically. Open the Game Server Installer again and select Teeworlds; it will then show Update. Alternatively, use the Teeworlds (teeworlds) - Update shortcut on your VPS. The installer will keep Teeworlds on version 0.7.5.

Players can’t join

Your server is running Teeworlds 0.7.5. Players using a different major version than 0.7 can’t connect. Also check whether all player slots are taken: Teeworlds allows a maximum of 16, and spectators take up a slot too.

Performance

Issues such as lag or delays often occur when the configuration isn’t suitable or the VPS doesn’t have enough resources.

Poor server configuration

Unsuitable settings can lead to higher resource usage and lag. Check the values in data\server.cfg. Stop the server before editing the file. The installer resets the name, player slots, port, game mode, map, and passwords every time it runs, so change these settings through the installer.

Not enough VPS resources

Teeworlds needs at least 2 GB of RAM. The operating system and other programs on your VPS also need resources. You can check how heavily your VPS is being used in the ZapX dashboard under Monitoring. If RAM or CPU usage is consistently maxed out, upgrading your VPS can help. Learn more in Upgrades, downgrades, renewals, and cancellations.

Network

Ping spikes, lag, and network delays

Ping spikes and lag are usually caused by limited VPS resources, a high number of players, or a server location far from your players. First, check resource usage under Monitoring. If you suspect routing issues, see Diagnose network issues with WinMTR/MTR. If you’re still having trouble, contact our support team.

DDoS and other network threats

Game servers are occasionally targeted by DDoS attacks that flood the server with traffic. Your VPS is protected by our DDoS protection. You can view past attacks in the ZapX dashboard under your VPS’s DDoS Manager, if it’s available at your location. If you suspect an attack is causing issues, contact our support team.

Preventive measures

Regular backups can save you a lot of stress. Use the Teeworlds (teeworlds) - Backup shortcut to save your settings and custom maps as a ZIP file at any time, and the Teeworlds (teeworlds) - Restore shortcut to restore them. Your entire VPS is also backed up automatically every day. With an active ZapX Pass, you can restore these backups yourself and create your own. Learn more in Daily backups, restoration, and restricted actions.

Conclusion

These steps should help you resolve your issue. If they don’t, don’t hesitate to contact our support team: simply start a Support Chat in your ZapX customer account. We’re here for you every day and will be happy to help! 🙂

FAQ

Frequently asked questions

If you set up the server with the Game Server Installer, you’ll find them at C:\ZapX-GameServers\teeworlds\logs\server.log. Restarts after crashes are listed in logs\supervisor.log.
The installer automatically restarts the server after a crash. If it crashes several times in quick succession, the installer gives up. Fix the cause, then start the server using the Teeworlds (teeworlds) - Start shortcut.
In the ZapX dashboard, check under Monitoring whether your VPS is running low on RAM or CPU. Teeworlds needs at least 2 GB of RAM. If that’s not enough, upgrading your VPS is the easiest solution.

Feedback

Was this article helpful?

Your feedback helps us prioritize and improve content.

0 of 0 people found this article helpful.

Personal support

Need more help than the guide provides?

Our ZAP support team knows your product — briefly describe your issue and we'll help you personally.

Zappy knows this guide and answers you right in the chat.