Skip to content

vexx-sm/TF2-PUGBot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

171 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TF2 PUG Bot

Latest Release Players Tracked

An all in one Discord Bot + SourceMod Plugin that sets up, tracks, and manages 6s & Highlander PUGs.
Features XYXY turn picks, Discord integration, Offclass ruling, ELO & Game History, fully managed VCs and much more.

Invite Bot

How It Works Commands Installation


Mixes.Preview.mp4

Tip

You don't need a server to host, You can host your PUG with 1 command using the discord bot, try /host to reserve a pre configured server running these plugins. Add me for extra hosts/regions.



Announcements (auto timezones) Reserving free servers
Player Stats Game History
Discord integration ex. Slot PUG on discord


How It Works

1 Pre-Game

Players become captains using !captain or !cap. Once two captains are picked and 12 players are present, the plugin moves everyone to spectator. Captains are randomly assigned to RED or BLU.

2 Draft

Captains take turns picking players using !pick (Draft format: XYXY XYXY XY).

  • Want to trade? Propose a !swap x y
  • Need out? Use !remove

Once teams are drafted, the server triggers RUP (Ready Up) and players are moved to their Team VCs on Discord.

3 Live Game

Players can request a class swap with teammates with !swap

If a player needs to sub out, they can request a rep (!rep x) right through Discord or in-game.


In-Game Commands

Prefix: ! or /

Most commands support 3+ aliases (e.g. !restart, !redraft, !reset all map to the same vote).


Player Commands Description
!captain / !cap Become or drop as a captain
!draft / !pick Open a menu of available picks (Current captain only)
!draft <name> Pick a player by name (Partial names work!)
!swap Captains suggest a player swap between teams.
!swap Players request a class swap with a teammate.
!remove Remove yourself or a teammate if you're a captain (Draft/RUP phases only)
!offclass Initiate a vote to toggle offclassing on or off
!rep <x> Request a replacement (Live Game phase only)
!restart Call a vote to restart the draft (Requires 2/3 majority)
!helpmix / !help Display the help menu of commands

Admin Commands Description
!setcaptain <p> Force assign or remove a player's captain status
!adminpick <p> Force-pick a player for the currently drafting team
!autodraft Randomly draft players into the remaining open slots
!randommix a Quick start game, 2 random captains and random players
!cancel Immediately cancel the current pug
!rup Force both teams to ready up
!cleanupstuck (Discord-only) Safely clears bot/game state if completely stuck


Installation

  1. Download the latest version from the Releases page.
  2. Extract in your your server's tf/addons/sourcemod/ folder.
  3. Restart your server or reload the plugin.

Warning

This plugin currently conflicts with SOAPdm. temporarily disable it for a proper experience.


About

All in one Discord bot + Source Mod plugin to setup and manage TF2 PUGs. (New: Setup a PUG with 1 command using the bot's own servers)

Topics

Resources

License

Stars

Watchers

Forks

Contributors