/slack-poker-bot

A bot that deals Texas Hold'em games in Slack

Primary LanguageJavaScriptMIT LicenseMIT

Slack Poker Bot

A bot that turns Slack into a legitimate Texas Hold'em client. Start a game in any channel or private group with 2-10 players. PokerBot will deal hands, direct message players with their hole cards, query players (in order) for their action, determine the winning hand, and handle the pot.

See it in action.

Getting Started

  1. Create a new bot integration
  2. Paste the API token from your integration into main.js OR
  3. Create a token.txt file and paste your API token there
  4. npm install
  5. node src/main.js
  6. To start a game, @<your_bot_name>: Deal
  7. To end a game, @<your_bot_name>: Quit game

But Can It Even?

It can:

  • Initiate a game and poll players to join
  • Handle player order, blinds, and betting
  • Send player's pocket cards as a DM
  • Display board images
  • Handle chip stacks / pot calculations
  • Handle split pots / side pots
  • Determine the best hand

Check the open issues for some planned enhancements.

AI Players

Although this client was built for managing human players in a Slack channel, it has some support for AI players. To add a bot player:

  1. Add a bot class under the ai/ folder
  2. Implement getAction, which is called whenever it is the bot's turn
  3. Modify the addBotPlayers method in src/bot.js to add your bot to every game

Spec All The Things

To run all of the tests, just do:

  1. gulp

The tests produce legible output that matches what users in Slack would see. This is very helpful when diagnosing a logic bug:

Dependencies

  • NodeJS Slack Client node-slack-client abstracts the basics of a Slack bot, including authentication, getting messages from players, and posting messages or attachments to the channel.

  • RxJS The majority of this client is written using RxJS. It simplifies many of the complex player polling interactions, that would otherwise be Death By Timers, into very legible code.

  • Imgur / Lightweight Image Processor Each card is a separate image, and board images are created on the fly by pasting several cards onto a single canvas (with the help of lwip). The resulting image is than uploaded to imgur, which gives us a single URL that can be passed as an attachment to the Slack API. This route was chosen to avoid uploading 311,875,200 images to the cloud, and allows us to modify the card assets easily.

  • Poker Evaluator poker-evaluator is used for evaluating the winning hand when it comes time to show down. Here it has been extended to calculate the best 5-card hand from any 7-card hand.

  • MochaJS Most of the tricky client logic is backed up by tests, which were written using MochaJS.

  • Vector Playing Cards