API Reference#
This section provides detailed documentation for all classes and functions in the Maverick library.
Core Classes#
|
Texas Hold'em Poker Game. |
|
Represents the complete state of a Texas Hold'em game. |
|
Protocol defining the interface for a valid player implementation. |
|
Abstract base class for a poker player. |
|
A player's state during a poker game. |
Represents an action taken by a player during their turn in a game. |
Card and Deck#
|
A playing card with a suit and rank. |
|
A standard deck of 52 playing cards. |
Players#
There are two kinds of built-in players. The first kind is simple bots with very simple logic. The second kind is player archetypes that implement common behavioral patterns of poker players.
Simple Bots#
These bots have extremely simple logic and are mainly intended for testing and demonstration purposes.
|
An aggressive bot that frequently bets and raises. |
|
A passive bot that always calls or checks. |
|
A passive bot that always folds when possible. |
Player Archetypes#
The following player archetypes implement common behavioral patterns observed in poker players.
|
A straightforward, textbook poker bot with little deviation. |
|
A bot that uses stack size and intimidation to control the table. |
|
A generally weak or inexperienced bot that makes systematic, exploitable mistakes. |
|
A volume-oriented bot focused on steady expected value. |
|
A bot with strategy driven by game-theory optimal solutions. |
|
A bot that calls big bets to 'keep opponents honest,' often incorrectly. |
|
A bot that plays a wide range of hands and applies relentless pressure. |
|
A bot that plays too many hands and calls too often (calling station). |
|
A bot that is ultra-aggressive and unpredictable. |
|
A bot that plays too cautiously due to being under-rolled for the stakes. |
|
A bot that adapts strategy dynamically based on opponent tendencies (exploitative). |
|
A bot that is selective with starting hands, but bets and raises assertively when involved. |
|
A bot that plays very few hands and avoids big pots without premium holdings. |
|
A bot that is emotionally compromised after losses or bad beats. |
|
An extremely loose bot willing to gamble large sums. |
Events and Event Handling#
|
Immutable game event payload. |
|
Simple event bus for managing event subscriptions and emissions. |
Rules#
|
Full configuration for a poker game. |
|
Rules related to seating limits and how cards are dealt. |
|
Rules related to blinds, antes, and straddles (forced or optional preflop bets). |
|
Rules related to how final hands are constructed and compared. |
Hand Evaluation#
|
Private cards plus as many community cards as needed to complete the hand. |
|
A number of cards held by a player. |
Utilities#
Classifies and scores a poker hand. |
|
|
Estimate the holding strength as the relative linelihood of winning against n_players - 1 opponents. |
Enumerations#
|
Card suit enumeration. |
|
Card rank enumeration. |
|
Betting round enumeration for Texas Hold'em. |
|
Poker hand type enumeration. |
|
Player state enumeration. |
|
Game stage enumeration. |
|
Player action enumeration. |
|
Game event enumeration. |