Python Documentation

Getting Started

Basics

The function called 'act' has to return either:

• 0 is to fold, or check if no previous bot has raised
• 1 is to call, or check if no previous bot has raised
• >1 is for raising a specific amount

Get current cards

This will put the bots current hand, with the table taken into account, into a variable called current_bot_hand:

current_bot_hand_type = obs.get_my_hand_type()

HandType currentBotHandType = obs.getMyHandType();

This will put the boards hand type, with the bots hand excluded:

current_board_hand_type = obs.get_board_hand_type()

HandType currentBoardHandType = obs.getBoardHandType()

Both variables will be of type HandType (enum), which looks like this:

if current_bot_hand == HandType.STRAIGHTFLUSH:
    some_action()

          if (currentBotHand == HandType.STRAIGHTFLUSH) {
              someAction();
          }

Or you can check if the current hand is better than a specific handtype:

if current_bot_hand >= HandType.PAIR:
    some_action()

      if (currentBotHand.getValue() >= HandType.PAIR.getValue()) {
          someAction();
      }

You can get your current cards in hand like this

my_hand = obs.my_hand

ArrayList<String> myHand = obs.getMyHand();

This returns a list of strings, representing cards. For each card string, the first character is the rank and the second character is the suit. For example, the ace of spades is represented as 'As' and 9 of hearts is '9h'.
Note that the ranks, 10 to ace is represented as 'T', 'J', 'Q', 'K', 'A', and the suits are represented as 's', 'h', 'd', and 'c' for spades, hearts, diamonds, and clubs respectively.

If you want to match your hand to specific hands, you can do it like this:

if (Range("77+, A8s+, K9s+, QTs+, AJo+, KQo").is_hand_in_range(my_hand)):
    some_action()

      if (new Range("77+, A8s+, K9s+, QTs+, AJo+, KQo").isHandInRange(myHand)) {
          someAction();
      }

The list above is a list of hands that are generated with the help of the site below:

When you have created the wanted hand range you can copy the range string into your script.

Get current round

If you want to base some action on the specific round of the current game, you can do it like this:

if obs.current_round == 2:
    some_action()

The current round is an int and can be interpreted like this:

          if (obs.getCurrentRound() == 2) {
              someAction();
          }

• 0 = Preflop (no cards on board)
• 1 = Flop (three cards on board)
• 2 = Turn (four cards on board)
• 3 = River (five cards on board)
• 4 = Showdown (last chance to raise)

Players and big blinds

If you want to know the current blinds, you can do it like this:

big_blind = obs.big_blind
 small_blind = obs.small_blind

int bigBlind = obs.getBigBlind();
 int smallBlind = obs.getSmallBlind();

At any point in the game, the small blind will be index 0, big blind will be index 1, and the rest of the players will be index 2 and onwards.

You can get the current player's index like this:

my_index = obs.my_index

int myIndex = obs.getMyIndex();

2. Testing your bot

If you have any questions just ask us at the event.
Good luck with your bot and have fun!

Full Documentation (Only in python)

If you want to view the original documentation you can follow this link.