Panel/ControlPanel/docs/games/teeworlds.md

Teeworlds — Complete Dedicated Server Guide

Startup Parameters

Default command line

./teeworlds_server -port 27015 -maxplayers 16 -config server.cfg

Parameters (common server flags)

• -port <port> — Server port (default varies by game)
• -maxplayers <num> — Maximum player count
• -config <file> — Configuration file to load
• -log — Enable logging
• -console — Enable console output
• -dedicated — Run as dedicated server
• -name "<name>" — Server name
• -password "<pass>" — Server password

Ports

• Game: UDP 27015 (typical default)
• Query: UDP 27016 (game port + 1)
• Admin/RCON: TCP varies by game

Config Files & Locations

Windows:

• teeworlds_server.cfg — Main server configuration
• config/ — Configuration directory
• logs/ — Log files directory
• data/ — Server data and saves

Linux:

• ~/teeworlds/server.cfg — Main server configuration
• ~/teeworlds/config/ — Configuration directory
• ~/teeworlds/logs/ — Log files directory
• ~/teeworlds/data/ — Server data and saves

Key Files:

• server.cfg: Core server settings and game rules
• admins.cfg: Administrator configuration (if applicable)
• banned.cfg: Banned players list (if applicable)

Steam Workshop

Not supported by this game.

Common Mods (curated)

Admin/Management Mods

• Check official mod repositories or community sites for Teeworlds
• Look for server administration, anti-cheat, and quality-of-life mods
• Install according to game's modding framework (if available)

Popular Community Mods

• Search Steam Workshop (if supported) for highly-rated server mods
• Check game's official forums and community sites for recommended mods
• Verify mod compatibility with current server version

Installation Notes

• Follow each mod's specific installation instructions
• Some games require mod loading frameworks or special startup parameters
• Test mods individually before combining multiple mods

Database

Not applicable - this game does not use a database for core functionality.

Administration & Scripting

Remote Administration:

• RCON (Remote Console) access for server management
• Web-based admin panels (game-specific or third-party)
• In-game admin commands and permissions

Backup Strategy:

• Automated daily backups of save files and configuration
• Rotate backups (keep 7 daily, 4 weekly, 12 monthly)
• Test backup restoration procedures regularly
• Store backups in separate location/drive

Auto-Update:

• Use SteamCMD for automatic server updates (Steam games)
• Schedule updates during low-traffic periods
• Backup before applying updates
• Monitor for update announcements and patch notes

Monitoring:

• Server performance monitoring (CPU, memory, network)
• Player connection logs and statistics
• Error log monitoring and alerting
• Uptime tracking and availability reporting

Troubleshooting (game-specific)

Server not starting

• Cause: Missing dependencies, incorrect configuration, or port conflicts
• Fix: Check server logs, verify all required files are present, ensure ports are available

Players cannot connect

• Cause: Firewall blocking server port or incorrect network configuration
• Fix: Open required ports in firewall, verify server is binding to correct IP address

Performance issues/lag

• Cause: Insufficient server resources or suboptimal configuration
• Fix: Monitor CPU/memory usage, optimize server settings, reduce player/entity limits

Configuration not loading

• Cause: Syntax errors in config files or incorrect file paths
• Fix: Validate configuration file syntax, check file permissions, review server logs

Mod/plugin conflicts

• Cause: Incompatible mods or plugin version mismatches
• Fix: Test mods individually, update to compatible versions, check for known conflicts