Fist-o-matic

This page holds sections of information that will be helpful for members to find and understand better information relating to the FIST-O-Matic which is an IRC bot used for reporting PVP gaming. The Fist of the Brotherhood oversees all things that are gaming.

WHAT IS THE FIST-O-Matic?

The FIST-O-Matic is a gaming bot utilized by the Fist of the Brotherhood in the IRC Channel #dbgaming The FIST-O-Matic is a bot that members can login with and will put them in a queue for a specific platform or platforms of their choosing. Use of the FIST-O-Matic is recommended as it helps to avoid match dodging, other violations of the RoC, and will properly report the outcome of the matches to the Brotherhood site.

Is use of the FIST-O-Matic Required?

While use of the FIST-O-Matic is not required for normal day to day play it is recommended as it speedlines the submission process, the challenging process, and the approval of submitted matches.

! Use of the FIST-O-Matic is required during vendettas and other major Brotherhood events. !

How does it work?

The FIST-O-Matic works with magic coding thanks to the Seneschal. upon entering #dbgaming on IRC members first login to the bot and select the platform or platforms they wish to play other members in. The FIST-O-Matic then places the member in a queue with other members wanting to play the same platform. Drawing from the queue the FIST-O-Matic then will spit out paired matches for the members, after they confirm with the FIST-O-Matic the members play each other. Upon completion of their matches one member will then report the outcome to the FIST-O-Matic and the bot will submit the matches to the Brotherhood site for the members. The members may then re-queue or leave the channel. If a member fails to confirm a match they will be kicked from the channel for idling.

Quick command reference

- When people join the channel and are not logged in, they are greeted by the bot, telling them to use the !login command for instructions on how to log in.

- !login - will respond with instructions on how to login (go to a URL, and paste the code into the following command). Note that this command is not required to log in, it just provides instructions, so can by bypassed by people that know how to login already.

- /msg FIST-o-matic authorize <code_from_site> - (replacing <code_from_site> with the code retrieved from the website) logs you in. This tells the bot who you are, and also authorizes it to report matches on your behalf. This opens up the rest of the commands. Note that the code used is one-time-use, so there shouldn't be much of an issue if somebody accidentally pastes it into a channel.

- !list - shows you which queues you are enrolled to (if any), and shows you a list of available queues

- !join <queues> - (e.g. !join JA JO SC2) adds you to queues

- !leave <queues> - removes you from queues.

- The bot will match up people queued up for a game that have not played each other that day for that queue. Matchups are announced in the channel. Once matched up, players have five minutes to confirm, or they will be kicked for idling. If both confirm within the time limit, the match is started, and the !report commands become available:

- !report <yourwins> <theirwins> [competition_id] - reports the results to the website, and marks the game as done, allowing both members to join queues again. Theyourwins and theirwins parameters are viewed from the perspective of the member performing the !report command, and competition_id is an optional parameter that allows attaching a competition to the report. Note that this takes a competition ID, not a competition title. (e.g.: Valhavoc vs. James. James types: !report 3 6 1337, resulting in 3 wins for James, 6 for Valhavoc, with the competition with ID 1337 attached to the report).

- !report failure - Can be used if for some reason the members are unable to proceed with the match (e.g. server connection issues, or one member disappears before any matches could be completed). The bot confirms this in the channel, considers the members as having played eachother so they won't be matched up again right after, and allows them to rejoin queues.

- !rejoin - Allows a member to quickly rejoin the queues they were in after they're done playing a match, or after their opponent was kicked for inactivity.