IRC Pick-Up Game Operator Bot

- !create, !join, play!

I have created an IRC bot that will allow users to easily create and join pick-up games.
(For example etqw/et/csgo and any other (type of) game).

To check it out, join the #battlebot irc channel on Quakenet! ( irc://irc.quakenet.org/battlebot )
http://webchat.quakenet.org/
http://www.team-aero.org/team-aero_esports/aero_tv.php

mIRC: http://www.mirc.com/
XChat: http://xchat.org/
AdiIRC: https://adiirc.com/

Quick reference:

Basic commands

• !help - This will return a list of available commands.
• !create - This will return a list of available games.
• !serverlist - This will return a list of available servers.
• !queue - This will return a list of available pugs currently in queue to join.
• !info - This will return a list of teams and their players, currently signed up for a pug. If no additional values are supplied, it will return the info of the pug you are currently in queue for. For example: !info etqw 4v4

PUG commands

• !create [game] [mode] [skill] [server]
• !join [game] [mode] [skill] [team#]
• !need
• !leave
• !start
• !callvote [mode] [value]
• !vote [yes/no]

When a pick-up is filled or started, every player will be notified to join the server by having the ip and password sent to them in a pm. The pug will then be removed from queue and another one of the same game and mode may be started.
(You can always start mutliple pugs at the same time if they are not identical)

Greetings, Crytiqal.Aero

Command usage:

Create a PUG

• !create [game] [mode] [skill] [server]

For example: !create etqw 4v4 low OR !create etqw 4v4 med server1 OR !create etqw 4v4 pro 123.456.7.890:27733 mypw

[game] - Pick a game that is supported.
[mode] - Pick a gamemode that is supported for that game (4v4 / 2v2v2 / 2v6v4 etc).
[skill] - Pick a skill level that is supported for that game (low / med / high / pro etc).
[server] - Pick a server for the game.
(If you leave this value blank, the bot will automatically select a default server from a pre-defined list, that is not currently in use by another pug in queue. You can also specify which default server you would like to use, by entering a value returned by typing !serverlist . In addition, you can also provide your own server (and password) in the following syntax: ip:port (pw). If this ip:port is already in use by another pug, you are asked to provide a different server)

You will automatically be the owner of the pug, and be granted special commands such as !start and !remove. (Additional commands like !kick,!ban,!unban, !shuffle will likely be added in the future)

Join a PUG

• !join [game] [mode] [skill] [team#]

For example: !join etqw 4v4 med 2 (joins team 2)
Provide the game, mode and skill because several pick-up games with different modes and skill levels of the same game can be in queue at the same time! Provide the <#> of the team you would like to join (1/2/3/4 OR A/B/C/D etc). If you fail to provide a teamID, the bot will automatically add you to the first available slot.

Leave a PUG

• !leave
  This will remove you from the pug you are currently enlisted in.
  If you are the owner of the pug, the ownership will be transferred to the next player in the line-up.
  If no such player is found, the pug will be removed from queue.

PUG Player commands

• !need
  This will show how many players are still needed for the pug you are currently enlisted in.

• !callvote [mode]
  For example: !callvote kick [playerNAME/playerID]
  When no playerNAME/playerID is given, the bot will return a list of current players and their ID's in your team.
  The vote will be valid for a set period of time (2min) and players of the same team can cast their vote within this time.
  When the vote reaches >50% within the valid time, the vote is granted.

Only 1 vote possible per team at a time. The votecaller will be placed in a timeout to prevent him from spamming votes and give others a chance to call a vote of their own. The timeout is set to 3 min OR when a new vote has been called.

• !vote [yes/no]
  For example: !vote yes OR !vote no

PUG Owner commands

• !remove
  This will remove the entire pug from the queue. (Only pick-up owners have the power to remove a pug from queue)

• !start
  Only pick-up owners can use this command to force start a Pick-Up Game.