Home

Machine Poker Guide

Building your bot

Bots are written in CommonJS, and simple need to export a 'play' function

Example: At it's simplest, a bot should return a bet. Bets are essentially what's getting added to the pot. You can think about it as throwing new chips into the pot.

// I just call everything!
exports.play = function(game) {
  if(game.state !== "complete") {
    return game.betting.call;
  }
};

Game object

You should expect to be passed a game object which contains all the relevant information you need to make a decision, including:

• game state ('pre-flop','flop', 'river', 'turn')
• players and their actions
• your own information (including your cards)
• betting options available

Here's an example of a game object after the flop.

{ community: [ 'Kh', '7c', '2c' ],
  state: 'flop',
  hand: 1,
  betting: { call: 0, raise: 10, canRaise: true },
  me: 
   { name: 'Me',
     blind: 5,
     ante: 0,
     wagered: 10,
     state: 'active',
     chips: 990,
     actions: { 'pre-flop': [ { type: 'call', bet: 5 } ] },
     cards: [ '6s', 'Qh' ],
     position: 0,
     brain: {} },
  players: 
   [ { name: 'Me',
       blind: 5,
       ante: 0,
       wagered: 10,
       state: 'active',
       chips: 990,
       actions: { 'pre-flop': [ { type: 'call', bet: 5 } ] } },
     { name: 'CallBot #1',
       blind: 10,
       ante: 0,
       wagered: 10,
       state: 'active',
       chips: 990,
       actions: { 'pre-flop': [ { type: 'check' } ] } },
     { name: 'RandBot #1',
       blind: 0,
       ante: 0,
       wagered: 10,
       state: 'active',
       chips: 990,
       actions: { 'pre-flop': [ { type: 'call', bet: 10 } ] } } ] }

Betting

Your play function should simply return a integer of the amount to wish to bet. This bet is in ADDITION to the amount you've already wagered.

For example, lets say you've wagered $10 so far, and are presented with the following betting state.

{ community: [ 'Kh', '7c', '2c' ],
  state: 'flop',
  hand: 1,
  betting: { call: 10, raise: 20, canRaise: true },
  me:
   { name: 'Me',
     blind: 5,
     ante: 0,
     wagered: 10,
     state: 'active',
     chips: 990,
     actions: { 'pre-flop': [ { type: 'call', bet: 5 } ] },
     cards: [ '6s', 'Qh' ],
     position: 0,
  // Concatenated for brevity

• A bet of 0 will result in a fold, because you need to bet 10 in order to stay in the game.
• A bet of 10 will result in a call.
• You can also bet 20 or more in order to raise. If you've already raised and there have been no subsequent raises, you won't be able to raise again and the canRaise flag will be set to false

What happens if I return an invalid amount?

Your brain

Your program won't hold any state. Any variables you set will be lost after it's run. In order to let you save information between betting, we're giving you a brain. You brain can store up to 4k (4096) of data, and will be handed back to you with every betting round.

You can find your brain under me.brain on the game object. Any property you create on the brain will automatically be saved.

Example brain usage:

exports.play = function(game) {
  if(!game.me.totalBets){game.me.totalBets = 0}
  if(game.state !== "complete") {
    var bet = game.betting.call;
    // This would be a total of every bet made
    // throughout all the hands played
    game.me.brain.totalBets += bet;
    return bet;
  }
};

Brain size is measured using JSON.stringify(brain).length If you exceed 4096, your brain will be reset to {} and you'll forget everything!

What happens when the game ends?

When a game finishes your play function will be called with a game object in the 'complete' state.

This allows you to evaluate your competitors actions and win data for future use (storing your learnings in your brain)

Here's and example of a completed game object

Limitations

Timeouts

You bot must respond in 2000ms when the 'play' function is called. Otherwise it will be stopped and a bet of 0 will be entered.

More data about the contest hardware is forthcoming.

Size Limits

Bots are limited to a size of 16k (16384) or less. You can certainly use a javascript packer to help meet this requirement. It will be measured including the CommonJS wrapper.

On unix based systems you can find your bots byte size using

wc -c bot.js

Javascript limitations

Running in the NodeJS VM means your Javascript bot will be more limited than normal. Most importantly you won't have control of the event loop. This means your bot must run to completion at each hand; you won't have access to setTimeout, setInterval to continue the program after you've made a bet.