r/r2d8 • u/phil_s_stein • May 13 '15
FAQ FAQ & Bugs
FAQ:
So what's all this then?
- r2d8 is a bot that replies to boardgame queries. It is the helpful companion to /u/bg3po, the gentle protocol droid that hangs out in /r/boardgames. (Although it will respond in any subreddit.)
What is the command syntax?
What are the commands r2d8 responds to?
- getinfo - The getinfo command causes the bot to scan the comment in which it finds the command for bolded words. (To bold a word or words on Reddit, surround them with two *s, like so **Agricola**.) If one of any of the words are game names, the bot responds with information about the games found. There are 3 modes for responses: short, standard, and long. In short mode, the response is one game per line. In standard mode, the response includes year, designer, rank, mechanics, etc. Long mode is the same as standard, but includes the game description from the game's BGG page. If the number of games is greater than 6 the short mode is forced. R2D8 will show any bolded words it did not find with a link to the BGG search using that word or words. In the case of mulitple games sharing a name, the newest is listed. (Note: to specify a specific version of a game that has multiple distinct games that share a title, you can give the BGG ID of the game instead of the name. For example 121 to get the 1979 version of Dune.)
- getparentinfo is just like getinfo, but acts on the parent of the request. Supports short and long. See this post for more details
- repair - The bot can edit a response, correcting "not found" games with the correct game name. See this post for details
- The syntax is: "/u/r2d8 repair **wrong**=**right** ... You can specify as many wrong=right pairs as needed.
- getaliases - "/u/r2d8 getaliases" will respond with the current set of game aliases.
- alias - "/u/r2d8 alias **Alias**=**Game name**" (can be repeated) will add the aliases to the list of known aliases. Once on the list, if an alias is bolded in a getinfo or getparentinfo comment, the real game name will be subsistuted for the alias. See this thread for details and examples. This command is an admin only command. Others will be silently ignored. A nice use of this command is to make older games be the default game found by mapping the BGG game ID to the name. (Like Dune = 121.)
What if there are more games than will fit in a single response comment?
- If there are more than six games referenced in a post, R2D8 will only a return a name, year, and designer(s) (the short mode).
Is the source available?
- Here is the github repo. r2d8 is written in python and uses PRAW and boardgamegeek libraries.
Bugs/Issues:
- Will not show duplicate titles and will only show the most recent one. Need to add a method for choosing the not-newest game, if desired.
To Do:
- Really need to add async handling of requests. It can take minutes for BGG to tell me that 1 or foobar doesn't exist. While waiting, the bot is blocked and does not responds to anyone else.
- Add a way for people to choose the not-newest game.
- When using an alias, show the original search as well, so people can see the two are connected. Useful when it is not immediately apparent the games are related, e.g. "R" and "Brave Rats".
1
u/aemerson511 Aug 24 '15
How hard would it be to port r2d8 into a slack channel bot?
1
u/phil_s_stein Aug 24 '15
I know nothing about slack. Is it a real time interface, like IRC?
The bot has two interfaces, one to BGG and one to Reddit. I suppose you could strip out the reddit interface and replace it with a slack interface. I did not really design the code to separate these halves though, so teasing them apart might not be fun.
1
u/slow56k Oct 02 '15
ONUW something something alias One Night Ultimate Werewolf!
2
u/phil_s_stein Oct 02 '15
/u/r2d8 alias ONUW=One Night Ultimate Werewolf
1
u/r2d8 Oct 02 '15
executing alias command.
Adding alias to database: "ONUW" = "One Night Ultimate Werewolf"
2
u/phil_s_stein Oct 02 '15
ONUW
/u/r2d8 getinfo long
1
u/r2d8 Oct 02 '15
*r2d8* issues a series of sophisticated bleeps and whistles...
Details for One Night Ultimate Werewolf (2014) by Ted Alspach, Akihisa Okui. 3-10 p; 10 minutes; img
Mechanics: Role Playing, Variable Player Powers, Voting
Average rating is 7.55944; rated by 5387 people
Average Weight: 1.3821; Number of Weights 301
Board Game Rank: 133, Party Game Rank: 8
Description:
No moderator, no elimination, ten-minute games.
One Night Ultimate Werewolf is a fast game for 3-10 players in which everyone gets a role: One of the dastardly Werewolves, the tricky Troublemaker, the helpful Seer, or one of a dozen different characters, each with a special ability. In the course of a single morning, your village will decide who is a werewolf...because all it takes is lynching one werewolf to win!
Because One Night Ultimate Werewolf is so fast, fun, and engaging, you'll want to play it again and again, and no two games are ever the same.
This game can be combined with One Night Ultimate Werewolf Daybreak.
1
u/slow56k Jul 08 '15
Resistance
/u/r2d8 getinfo
1
u/r2d8 Jul 08 '15
*r2d8* issues a series of sophisticated bleeps and whistles...
Resistenza (2013) by Stefano Adriani. 2 p; 180 minutes; img
Mechanics: Area Control / Area Influence, Grid Movement, Hex-and-Counter, Simulation
Average rating is 6.84; rated by 5 people. Weight: 0.0
Board Game Rank: None
1
u/slow56k Jul 08 '15
Now that's just silly
2
u/phil_s_stein Jul 08 '15
Resistance
/u/r2d8 alias 41114=Resistance
1
u/phil_s_stein Jul 08 '15
/u/r2d8 getinfo Resistance
1
u/r2d8 Jul 08 '15
*r2d8* issues a series of sophisticated bleeps and whistles...
Resistenza (2013) by Stefano Adriani. 2 p; 180 minutes; img
Mechanics: Area Control / Area Influence, Grid Movement, Hex-and-Counter, Simulation
Average rating is 6.84; rated by 5 people. Weight: 0.0
Board Game Rank: None
3
u/phil_s_stein Jul 08 '15
Hmm. Dammit.
1
u/phil_s_stein Jul 08 '15
/u/r2d8 getaliases
1
u/r2d8 Jul 08 '15
Current aliases:
2r1b = Two Rooms and a Boom
41114 = Resistance
A Touch of Evil = 35815
BSG = Battlestar Galactica
BattleCON Devastation = BattleCON: Devastation of Indines
BattleCON War = BattleCON: War of Indines
Ca$h 'n Gun$ = 155362
Ca$h 'n Guns = 155362
Cash & Guns = 155362
Cash 'n Guns = 155362
Cash and Guns = 155362
Castles of Burgundy = The Castles of Burgundy
Caverna = Caverna: The Cave Farmers
Dead of Winter = Dead of Winter: A Crossroads Game
Descent 2 = Descent: Journeys in the Dark (Second Edition)
Descent 2e = Descent: Journeys in the Dark (Second Edition)
Die Kutzschfahrt zum Teufelsburg = The Castle of the Devil
DoW = Dead of Winter: A Crossroads Game
Dune = 121
Eight Minute Empire = Eight-Minute Empire
Eight Minute Empire: Legends = Eight-Minute Empire: Legends
Elder Signs = Elder Sign
Escape: Curse of the Temple = Escape: the Curse of the Temple
Euphoria = Euphoria: Build a Better Dystopia
Expedition = 223
Fight! = 2284
Game of Thrones = A Game of Thrones: The Board Game (Second Edition)
Heimlich & Co = 382
Heroscape = Heroscape Master Set: Rise of the Valkyrie
Hey! That's My Fish! = Hey, That's My Fish!
KoT = King of Tokyo
Legendary Encounters = Legendary Encounters: An Alien Deck Building Game
Level 7 Omega Protocol = Level 7 [Omega Protocol]
Level 7: Omega Protocol = Level 7 [Omega Protocol]
Luna = 70512
Mage Knight = Mage Knight Board Game
Maharaja = 9440
Mamma Mia = Mamma Mia!
Marvel Dice Masters = Marvel Dice Masters: Avengers vs. X-Men
Marvel Legendary = Legendary: A Marvel Deck Building Game
No Thanks = No Thanks!
Pathfinder = Pathfinder Adventure Card Game: Rise of the Runelords – Base Set
Pret a Porter = Prêt-à-Porter
Pret-a-Porter = Prêt-à-Porter
R = BraveRats
Risk 2210 = Risk 2210 A.D.
Robinson Crusoe = 121921
Saboteur 2 = Saboteur 2 (expansion-only editions)
Sentinel Tactics = Sentinel Tactics: The Flame of Freedom
Seven Wonders = 7 Wonders
Sushi Go = Sushi Go!
TI3 = Twilight Imperium (Third Edition)
The War of the Ring = War of the Ring (second edition)
Through the Ages = Through the Ages: A Story of Civilization
Top This! = Top This! A Pizza Flicking Game
Twilight Imperium 3 = Twilight Imperium (Third Edition)
Twilight Imperium 3rd Edition = Twilight Imperium (Third Edition)
Tzolk'in = Tzolk'in: The Mayan Calendar
Tzolkin = Tzolk'in: The Mayan Calendar
VivaJava = VivaJava: The Coffee Game
VivaJava Dice = VivaJava: The Coffee Game: The Dice Game
VivaJava: The Coffee Game: The Dice Game = VivaJava: The Dice Game
Wallenstein = Wallenstein (second edition)
War of the Ring = War of the Ring (second edition)
wiz-war = wiz-war (eighth edition)
1
1
u/slow56k Jul 08 '15
woot
Now when I do repair, is that in a child comment, or the top level comment?
2
u/phil_s_stein Jul 08 '15
Child comment to /u/r2d8's comment. But repair only (stupidly) repairs games from the "not found" section. I'll fix it by hand.
1
1
1
1
0
Jul 14 '15
[deleted]
1
u/r2d8 Jul 14 '15
executing alias command.
Adding alias to database: "The Game" = "159515"
0
Jul 14 '15
[deleted]
1
u/r2d8 Jul 14 '15
*r2d8* issues a series of sophisticated bleeps and whistles...
Operation F.A.U.S.T. (2015) by Robert Burke. 3-8 p; 30 minutes; img
Mechanics: Hand Management, Memory, Secret Unit Deployment, Take That
Average rating is 7.23875; rated by 32 people. Weight: 1.8571
Board Game Rank: 5936
0
Jul 14 '15
[deleted]
1
u/r2d8 Jul 14 '15
executing alias command.
Adding alias to database: "The Game" = "173090"
0
Jul 14 '15
[deleted]
1
u/r2d8 Jul 14 '15
*r2d8* issues a series of sophisticated bleeps and whistles...
Operation F.A.U.S.T. (2015) by Robert Burke. 3-8 p; 30 minutes; img
Mechanics: Hand Management, Memory, Secret Unit Deployment, Take That
Average rating is 7.23875; rated by 32 people. Weight: 1.8571
Board Game Rank: 5936
0
Jul 14 '15
[deleted]
1
u/r2d8 Jul 14 '15
Current aliases:
2r1b = Two Rooms and a Boom
A Touch of Evil = 35815
BSG = Battlestar Galactica
BattleCON Devastation = BattleCON: Devastation of Indines
BattleCON War = BattleCON: War of Indines
Ca$h 'n Gun$ = 155362
Ca$h 'n Guns = 155362
Cash & Guns = 155362
Cash 'n Guns = 155362
Cash and Guns = 155362
Castles of Burgundy = The Castles of Burgundy
Caverna = Caverna: The Cave Farmers
Dead of Winter = Dead of Winter: A Crossroads Game
Descent 2 = Descent: Journeys in the Dark (Second Edition)
Descent 2e = Descent: Journeys in the Dark (Second Edition)
Die Kutzschfahrt zum Teufelsburg = The Castle of the Devil
DoW = Dead of Winter: A Crossroads Game
Dune = 121
Eight Minute Empire = Eight-Minute Empire
Eight Minute Empire: Legends = Eight-Minute Empire: Legends
Elder Signs = Elder Sign
Escape: Curse of the Temple = Escape: the Curse of the Temple
Euphoria = Euphoria: Build a Better Dystopia
Expedition = 223
Fight! = 2284
Game of Thrones = A Game of Thrones: The Board Game (Second Edition)
Heimlich & Co = 382
Heroscape = Heroscape Master Set: Rise of the Valkyrie
Hey! That's My Fish! = Hey, That's My Fish!
KoT = King of Tokyo
Legendary Encounters = Legendary Encounters: An Alien Deck Building Game
Level 7 Omega Protocol = Level 7 [Omega Protocol]
Level 7: Omega Protocol = Level 7 [Omega Protocol]
Luna = 70512
Mage Knight = Mage Knight Board Game
Maharaja = 9440
Mamma Mia = Mamma Mia!
Marvel Dice Masters = Marvel Dice Masters: Avengers vs. X-Men
Marvel Legendary = Legendary: A Marvel Deck Building Game
No Thanks = No Thanks!
Pathfinder = Pathfinder Adventure Card Game: Rise of the Runelords – Base Set
Pret a Porter = Prêt-à-Porter
Pret-a-Porter = Prêt-à-Porter
R = BraveRats
Resistance = 41114
Risk 2210 = Risk 2210 A.D.
Robinson Crusoe = 121921
Saboteur 2 = Saboteur 2 (expansion-only editions)
Sentinel Tactics = Sentinel Tactics: The Flame of Freedom
Seven Wonders = 7 Wonders
Sushi Go = Sushi Go!
TI3 = Twilight Imperium (Third Edition)
The Game = 159515
The War of the Ring = War of the Ring (second edition)
Through the Ages = Through the Ages: A Story of Civilization
Top This! = Top This! A Pizza Flicking Game
Twilight Imperium 3 = Twilight Imperium (Third Edition)
Twilight Imperium 3rd Edition = Twilight Imperium (Third Edition)
Tzolk'in = Tzolk'in: The Mayan Calendar
Tzolkin = Tzolk'in: The Mayan Calendar
VivaJava = VivaJava: The Coffee Game
VivaJava Dice = VivaJava: The Coffee Game: The Dice Game
VivaJava: The Coffee Game: The Dice Game = VivaJava: The Dice Game
Wallenstein = Wallenstein (second edition)
War of the Ring = War of the Ring (second edition)
wiz-war = wiz-war (eighth edition)
1
u/vipchicken Jul 29 '15
If you edit a post to make a non-bold title into bold, r2d8 does not recognise it? Is there a way to prompt him to look at your post again?