← Back to Home

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-schedule are 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.

  • time is 24h HH:mm (e.g. 21:30). Invalid formats are rejected.
  • timezone is 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).

StatusMeaning
⏳ scheduledWaiting for creation to start
🛠️ creatingServer is being created
✅ createdServer is ready
❌ failedSomething went wrong
🚫 cancelledCancelled 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.