Fist-o-matic: Difference between revisions

From Wikipedia of the Dark Brotherhood, an online Star Wars Club
m (Fist-o-Matic is no longer used. To be replaced by page about TB Fistbot)
(Major update Fist-o-Matic)
Line 1: Line 1:
{{obsolete}}
{{eras|real}}
{{eras|real}}
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.
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 a Telegram bot used for reporting PVP gaming.  


==What is the Fist-o-Matic?==


The Fist-o-Matic is a gaming bot utilized by the [[Fist of the Brotherhood]] in the [[Communication Platforms|Telegram]] Channel: DJB Gaming Lounge. The Fist-o-Matic is a bot that members can login with and use to queue for a specific platform(s) of their choosing.  Use of the Fist-o-Maticis required for normal '''day to day play''', during '''vendettas''' and other '''major Brotherhood events'''.


==WHAT IS THE FIST-O-Matic?==
'''Presence in the DJB Gaming Lounge is required during vendettas and other major Brotherhood events.'''


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 [[Rites of Combat|RoC]], and will properly report the outcome of the matches to the Brotherhood site.
It streamlines the submission process, the challenging process, and the approval of submitted matches.


==Is use of the FIST-O-Matic Required?==
==How do I use it?==


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.
The Fist-o-Matic is a Telegram Bot created by the [[Seneschal]]. It functions through simple commands, also available as buttons inside the Telegram Client.


'''Use of the FIST-O-Matic is required during vendettas and other major Brotherhood events.'''
To use the Fist-O-Matic open a chat on Telegram with @DJBFistBot


==How does it work?==
[[File:Fistomaticstart.png|thumb|center|upright=1.5|Click Start to initiate the bot.]]


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.
[[File:Fistomaticauth.png|thumb|center|upright=1.5|You will be asked to authenticate. Click the Authenticate Button.]]


[[File:Fistomaticurl.png|thumb|center|upright=1.5|Telegram will warn you that you're opening an external URL, click Open to go to the DB Site and login if you aren't already.]]


==Quick command reference==
Once you've logged in you will be returned to Telegram and you will need to click Start again (or type /start). This finishes the authentication process and you're now all set to start using the bot!


- 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.
[[File:Fistomaticjoin.png|thumb|center|upright=1.5|Click Join (or type /join) and pick the platform you want to queue for.]]


- !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.
[[File:Fistomaticcomp.png|thumb|center|upright=1.5|Choose if you want to submit to a competition and if you want to be matched with anyone or only people submitting to that competition also.]]


- /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.
[[File:Fistomaticconfirm.png|thumb|center|upright=1.5|You're now queued, when the bot finds you a partner you will need to click confirm.]]


- !list - shows you which queues you are enrolled to (if any), and shows you a list of available queues
[[File:Fistomaticreport.png|thumb|center|upright=1.5|When you have finished your matches follow the Bot's instructions to report your matches.]]


- !join <queues> - (e.g. !join JA JO SC2) adds you to queues
[[File:Fistomaticrejoin.png|thumb|center|upright=1.5|If you want you can automatically rejoin the queue after you are done reporting.]]


- !leave <queues> - removes you from queues.
== Quick Command Reference ==
 
- 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.


* /start
** Authenticate with the bot (One time process)
* /join
** Join a queue
* /leave
** Leave a queue
* /status
** Show our status
* /refresh
** Refresh your information (Name changes, Unit Transfers etc)


[[Category:DJB Info]]  
[[Category:DJB Info]]  
[[Category:DJB Help]]
[[Category:DJB Help]]
[[Category:Gaming]]
[[Category:Gaming]]
[[Category:Obsolete Data]]

Revision as of 18:24, 2 October 2016

Real World Perspective.

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 a Telegram bot used for reporting PVP gaming.

What is the Fist-o-Matic?

The Fist-o-Matic is a gaming bot utilized by the Fist of the Brotherhood in the Telegram Channel: DJB Gaming Lounge. The Fist-o-Matic is a bot that members can login with and use to queue for a specific platform(s) of their choosing. Use of the Fist-o-Maticis required for normal day to day play, during vendettas and other major Brotherhood events.

Presence in the DJB Gaming Lounge is required during vendettas and other major Brotherhood events.

It streamlines the submission process, the challenging process, and the approval of submitted matches.

How do I use it?

The Fist-o-Matic is a Telegram Bot created by the Seneschal. It functions through simple commands, also available as buttons inside the Telegram Client.

To use the Fist-O-Matic open a chat on Telegram with @DJBFistBot

Click Start to initiate the bot.
You will be asked to authenticate. Click the Authenticate Button.
Telegram will warn you that you're opening an external URL, click Open to go to the DB Site and login if you aren't already.

Once you've logged in you will be returned to Telegram and you will need to click Start again (or type /start). This finishes the authentication process and you're now all set to start using the bot!

Click Join (or type /join) and pick the platform you want to queue for.
Choose if you want to submit to a competition and if you want to be matched with anyone or only people submitting to that competition also.
You're now queued, when the bot finds you a partner you will need to click confirm.
When you have finished your matches follow the Bot's instructions to report your matches.
If you want you can automatically rejoin the queue after you are done reporting.

Quick Command Reference

  • /start
    • Authenticate with the bot (One time process)
  • /join
    • Join a queue
  • /leave
    • Leave a queue
  • /status
    • Show our status
  • /refresh
    • Refresh your information (Name changes, Unit Transfers etc)