Documentation
User guide for the TF2-QuickServer Discord bot: commands, scheduling, admin tools, and community rules.
Home
About TF2-QuickServer
TF2-QuickServer is a community-hosted service to quickly spin up TF2 servers for competitive matches directly from Discord. It is powered by Oracle Cloud and Docker, and runs in São Paulo and other regions. Servers are launched on-demand and auto-shutdown after a set time or when terminated.
Sections
Get Started
Join the Discord guild: discord.gg/HfDgMj73cW
Then head over to Using the Bot to learn how to create your first server.
Using the Bot
Join the Discord Guild
Join the guild at discord.gg/HfDgMj73cW — this is the hub for all TF2-QuickServer activity.
Commands
/set-user-data <steamId>/create-server <region>/get-guild-servers/get-my-servers/status/terminate-servers/schedule,/show-schedules, and/cancel-scheduleare covered on the Scheduling page.
/set-user-data
Register your Steam ID once to use the bot. Format: STEAM_0_000000. You can find your Steam ID on steamid.io. Registering grants you Sourcemod admin on the servers you create.
/create-server
Choose a region; the bot then prompts you for a Variant (which varies by guild). You must register your Steam ID first. Creating a server takes about 3 minutes, after which the bot replies with the Connection IP, RCON Password, and SourceTV link.
/get-my-servers
No parameters. Shows Connection IP/Port, Server Password, RCON Address/Password, SourceTV IP/Password, and Status (ready/pending/terminating). The reply is ephemeral, and details are only shown for "ready" servers.
/status
No parameters. Shows a table of region names with counts: running (✅ ready), creating (⏳ pending), terminating (🔴). The reply is ephemeral.
/terminate-servers
Manually deletes your servers. Servers are also auto-deleted after 10 minutes empty, but manual termination is recommended.
/get-guild-servers
Requires the Administrator permission. Shows a table: Server ID (truncated), Region, Connection IP/Port, SourceTV IP/Port, Server Password, SourceTV Password, RCON Password. Only "ready" servers are listed, and the reply is ephemeral.
Scheduling Servers
Want a server ready at a specific time? See Scheduling for /schedule, /show-schedules, and /cancel-schedule.
Admin Commands
Creating a server makes you a Sourcemod admin and the holder of its RCON password.
!map
Change the map. For FastDL maps, use /rcon changelevel <exact map name>.
!admin
Opens the Sourcemod Admin Panel — execute CFGs, change maps, manage players, and control server settings.
/rcon exec <cfg_name>
Execute a server config, e.g. fbtf_6v6_rules.
/rcon mp_tournament_restart
Restarts the competitive match while keeping players and settings.
!addadmin
Grant admin to a player, e.g. !addadmin sonikro z (Z-level is RCON-level).
!terminate
Immediately deletes the server from in-game chat. Creator only.
Notes
- Admin applies only to your server and resets on each new server launch.
- Misuse leads to restrictions — see Rules and Restrictions.
Rules and Restrictions
FBTF Ban Sync
TF2-QuickServer mirrors FBTF league bans. Banned users cannot create or join servers. This is verified automatically.
Server Limits
- 1 active server per user.
- Max 10 hours per server — warning messages are sent first, then the server is auto-terminated.
- Empty servers auto-shutdown after 10 minutes of inactivity.
Community-Funded
Every minute a server runs incurs cost. Be conscious of it — terminate servers when done and avoid AFK servers.
Scheduling
/schedule
Schedule a server to be created and ready at a specific time.
timeis 24hHH:mm(e.g.21:30). Invalid formats are rejected.timezoneis chosen from a fixed list of 25 IANA timezones, grouped by region:- UTC
- America: New_York, Chicago, Denver, Los_Angeles, Sao_Paulo, Argentina/Buenos_Aires, Bogota
- Europe: London, Lisbon, Madrid, Paris, Berlin, Rome, Amsterdam, Warsaw, Moscow, Istanbul
- Asia: Dubai, Kolkata, Bangkok, Singapore, Tokyo, Seoul
- Australia/Pacific: Sydney
How it works
After /schedule, the bot shows variant buttons. Pick one, and you get an ephemeral confirmation with the region, variant, ready time in your timezone, in UTC, and relative ("in Xh Ym"). The bot also DMs you a confirmation — DMs MUST be enabled, otherwise the schedule is not created ("I need to be able to DM you to deliver your server connection info…").
When does my server start?
Creation begins about 5 minutes before the ready time (per-region lead, default 5 minutes) so the server is ready on time.
Limits
You can only have ONE active schedule per user ("You can only schedule one server at a time…"). Once created, normal server rules apply — see Rules and Restrictions.
/show-schedules
Ephemeral list of your schedules: region, variant, status, and ready time (your timezone + UTC + relative).
| Status | Meaning |
|---|---|
| ⏳ scheduled | Waiting for creation to start |
| 🛠️ creating | Server is being created |
| ✅ created | Server is ready |
| ❌ failed | Something went wrong |
| 🚫 cancelled | Cancelled before creation started |
/cancel-schedule
Cancels an active schedule before creation starts.
What happens if something goes wrong?
A background routine runs every minute and claims due schedules. A schedule stuck in creating for over 20 minutes is marked failed and you are DM'd. If the bot was offline past the trigger time plus a 30-minute grace period, the schedule is marked failed and you are DM'd.