🎲 SimJack is a high-performance, fully customizable blackjack simulation engine written in Go.
It supports card counting, dynamic bet ramping, sidebets (Perfect Pair, 21+3), and custom strategy files in JSON format — perfect for strategy testing or statistical analysis.
"Where strategy meets simulation."
♠️ Full blackjack game engine (7-box table, dealer AI, split/double support)- ✅ New: Surrender Rule Support (configurable for early surrender and against dealer's Ace).
- ✅ New: Table Bet Limits (configurable
min_betandmax_betfor the table, including derived limits for sidebets). - 🧠 Strategy files loaded dynamically via JSON (no recompile!).
- 📈 Card Counting with Deviations (illustrious 18, etc.) and multiple count systems.
- 🎯 Bet ramping with true count multipliers.
- 💼 Supports perfect pair & 21+3 sidebets.
- 📦 JSON-configurable players, rules, and simulations.
- 📊 Outputs a rich, Pandas-ready CSV log file.
- 🧪 Supports forced cards for debugging and scenario testing.
- 🗜 Optional gzip log support (outputs as
.csv.gz). - 📊 Optional progress bar in the console.
git clone https://github.com/barkink/SimJack.git
cd SimJack
go run main.go -config=test_config.json -log=simjack_log.csv -strategies=strategies-progress: Displays a progress bar in the console during simulation-debug: Enable debug mode for round-level output
go build -o simjack main.goWith config file:
./simjack -config=test_config.json -log=results.csv -strategies=strategiesWith inline JSON:
./simjack -config_json='{"round_count":100000, "num_decks":6, ...}' -log=results.csv./simjack -helpsimjack/
├── main.go # CLI entry point
├── config/ # Config schema
├── engine/ # Game logic (Dealer, Player, Box, Hand, Strategy, Logger...)
├── strategies/ # Strategy definitions (e.g. basic_chart.json) Could be another directory, given as a parameter.
├── test_config.json # Sample config to run out-of-the-box
Each row = one hand
Log is saved as logname_0.csv while simulation is running
Renamed to logname_1.csv when finished
Columns include:
- Player and box info
- Bet amounts and payouts
- Sidebets and insurance
- Hand cards, result, split/double flags
- Dealer cards and outcome
- Shoe info (deck state, cut position, round/total cards drawn)
Perfectly suited for Pandas analysis 🎯
Each strategy is a .json file defining:
{
"decide_insurance": true,
"fallback": "stand",
"actions": {
"hard_13_vs_2": ["stand"],
"pair_8_vs_10": ["split", "stand"],
"soft_17_vs_3": ["hit"]
}
}Supports:
hard_X_vs_Ysoft_X_vs_Ypair_R_vs_Y
Config allows:
- Per-player balance, bet unit, split limit
- Box assignment
- Sidebet enablement
- Forced cards for debugging
See test_config.json for a working example.
{
"num_decks": 6,
"round_count": 1000,
"strategy_directory": "strategies",
"players": [
{
"player_id": 1,
"strategy": "hi_lo",
"bet_unit": 10,
"box_indexes": [1, 2]
}
]
}{
"fallback": "stand",
"counting_enabled": true,
"actions": {
"hard_16_vs_10": ["hit"]
},
"deviations": {
"hard_16_vs_10": { "at_count": 4, "action": "stand" }
},
"bet_ramp": [
{ "min_count": -4, "bet_unit": 0.5 },
{ "min_count": 1, "bet_unit": 2.0 },
{ "min_count": 3, "bet_unit": 4.0 }
]
}The simulator produces a CSV log file containing:
- 📌 strategy_key and full decision_trace per hand
- 🧠 indicators like (deviation), (fallback)
- 💵 bet_unit vs. bet_unit_used for ramp-up tracking
- 📈 full financials (balance, payout, sidebets, insurance)
Example log row (Added extra spaces to make it better readable):
round, shoe, deck_running_count, true_count, real_count_till_cut_card, box_id, player_id, hand_id, owner , hand , result , bet_from_config, bet_unit_used, hand_payout, main_payout, pp_bet, pp_win, pp_type , p21_bet, p21_win, p21_type , insurance_bet, insurance_payout, initial_balance, round_start_balance, player_balance, is_blackjack, is_doubled, is_split_child, split_count, dealer_upcard , dealer_final_hand , dealer_blackjack, dealer_bust, player_bust, player_draws , player_is_bankrupt, player_is_retired, num_decks, cut_card_position, cards_drawn_total, cards_drawn_round, cards_left_after_round, strategy_key
1, 1, 4 , 0 , 7 , 1, 1, 1, PlayerOne, Q of Clubs;7 of Diamonds , lose , 10.00, 5.00, 0.00, 0.00, 1.00, 0.00, none , 1.00, 0.00, none , 0.00, 0.00, 1000000.00, 999993.00, 999986.00, False , False , False , 0, K of Spades , K of Spades;Q of Spades , False , False , False , , False , False , 8, 238, 19, 19, 397, hard_17_vs_10:stand (fallback)
1, 1, 4 , 0 , 7 , 2, 1, 1, PlayerOne, 3 of Diamonds;5 of Diamonds;5 of Clubs;A of Spades;7 of Clubs , win , 10.00, 5.00, 20.00, 20.00, 1.00, 0.00, none , 1.00, 0.00, none , 0.00, 0.00, 1000000.00, 999993.00, 1000006.00, False , False , False , 0, K of Spades , K of Spades;Q of Spades , False , False , False , 5 of Clubs;A of Spades;7 of Clubs , False , False , 8, 238, 19, 19, 397, hard_8_vs_10:hit (main)
1, 1, 4 , 0 , 7 , 3, 2, 1, PlayerTwo, Q of Diamonds;9 of Diamonds , lose , 5.00, 5.00, 0.00, 0.00, 0.00, 0.00, none , 0.00, 0.00, none , 0.00, 0.00, 800000.00, 799990.00, 799985.00, False , False , False , 0, K of Spades , K of Spades;Q of Spades , False , False , False , , False , False , 8, 238, 19, 19, 397, hard_19_vs_10:stand (fallback)
1, 1, 4 , 0 , 7 , 4, 2, 1, PlayerTwo, J of Diamonds;5 of Hearts;5 of Clubs , push , 5.00, 5.00, 5.00, 5.00, 0.00, 0.00, none , 0.00, 0.00, none , 0.00, 0.00, 800000.00, 799990.00, 799990.00, False , False , False , 0, K of Spades , K of Spades;Q of Spades , False , False , False , 5 of Clubs , False , False , 8, 238, 19, 19, 397, hard_15_vs_10:hit (main)
1, 1, 4 , 0 , 7 , 5, 2, 1, PlayerTwo, 4 of Hearts;2 of Hearts;3 of Clubs;5 of Hearts;6 of Hearts , push , 5.00, 5.00, 5.00, 5.00, 0.00, 0.00, none , 0.00, 0.00, none , 0.00, 0.00, 800000.00, 799990.00, 799995.00, False , False , False , 0, K of Spades , K of Spades;Q of Spades , False , False , False , 3 of Clubs;5 of Hearts;6 of Hearts , False , False , 8, 238, 19, 19, 397, hard_6_vs_10:hit (main)
2, 1, 14 , 1 , 17 , 1, 1, 1, PlayerOne, 5 of Hearts;6 of Hearts;9 of Hearts , lose , 20.00, 40.00, 0.00, 11.00, 1.00, 0.00, none , 1.00, 11.00, Straight , 0.00, 0.00, 1000000.00, 999964.00, 999923.00, False , True , False , 0, 7 of Diamonds , 7 of Diamonds;4 of Spades;K of Clubs , False , False , False , 9 of Hearts , False , False , 8, 238, 39, 20, 377, hard_11_vs_7:double (main)
2, 1, 14 , 1 , 17 , 2, 1, 1, PlayerOne, 6 of Clubs;2 of Clubs;6 of Diamonds;8 of Clubs , lose , 10.00, 40.00, 0.00, 0.00, 1.00, 0.00, none , 1.00, 0.00, none , 0.00, 0.00, 1000000.00, 999964.00, 999923.00, False , False , False , 0, 7 of Diamonds , 7 of Diamonds;4 of Spades;K of Clubs , False , False , True , 6 of Diamonds;8 of Clubs , False , False , 8, 238, 39, 20, 377, hard_8_vs_7:hit (main)
2, 1, 14 , 1 , 17 , 3, 2, 1, PlayerTwo, 4 of Clubs;7 of Spades;3 of Hearts , lose , 10.00, 5.00, 0.00, 0.00, 0.00, 0.00, none , 0.00, 0.00, none , 0.00, 0.00, 800000.00, 799985.00, 799970.00, False , True , False , 0, 7 of Diamonds , 7 of Diamonds;4 of Spades;K of Clubs , False , False , False , 3 of Hearts , False , False , 8, 238, 39, 20, 377, hard_11_vs_7:double (main)
2, 1, 14 , 1 , 17 , 4, 2, 1, PlayerTwo, 6 of Diamonds;3 of Diamonds;7 of Clubs;3 of Spades , lose , 5.00, 5.00, 0.00, 0.00, 0.00, 0.00, none , 0.00, 0.00, none , 0.00, 0.00, 800000.00, 799985.00, 799970.00, False , False , False , 0, 7 of Diamonds , 7 of Diamonds;4 of Spades;K of Clubs , False , False , False , 7 of Clubs;3 of Spades , False , False , 8, 238, 39, 20, 377, hard_9_vs_7:hit (main)
2, 1, 14 , 1 , 17 , 5, 2, 1, PlayerTwo, 2 of Clubs;9 of Diamonds;Q of Clubs , push , 10.00, 5.00, 10.00, 10.00, 0.00, 0.00, none , 0.00, 0.00, none , 0.00, 0.00, 800000.00, 799985.00, 799980.00, False , True , False , 0, 7 of Diamonds , 7 of Diamonds;4 of Spades;K of Clubs , False , False , False , Q of Clubs , False , False , 8, 238, 39, 20, 377, hard_11_vs_7:double (main)
3, 1, 16 , 2 , 19 , 1, 1, 1, PlayerOne, 6 of Spades;3 of Clubs;K of Diamonds , win , 10.00, 60.00, 20.00, 20.00, 1.00, 0.00, none , 1.00, 0.00, none , 0.00, 0.00, 1000000.00, 999861.00, 999819.00, False , False , False , 0, 8 of Spades , 8 of Spades;9 of Diamonds , False , False , False , K of Diamonds , False , False , 8, 238, 56, 17, 360, hard_9_vs_8:hit (main)
3, 1, 16 , 2 , 19 , 2, 1, 1, PlayerOne, J of Diamonds;2 of Diamonds;8 of Clubs , win , 10.00, 60.00, 20.00, 20.00, 1.00, 0.00, none , 1.00, 0.00, none , 0.00, 0.00, 1000000.00, 999861.00, 999839.00, False , False , False , 0, 8 of Spades , 8 of Spades;9 of Diamonds , False , False , False , 8 of Clubs , False , False , 8, 238, 56, 17, 360, hard_12_vs_8:hit (main)
3, 1, 16 , 2 , 19 , 3, 2, 1, PlayerTwo, 8 of Hearts;10 of Spades , win , 5.00, 5.00, 10.00, 10.00, 0.00, 0.00, none , 0.00, 0.00, none , 0.00, 0.00, 800000.00, 799970.00, 799975.00, False , False , False , 0, 8 of Spades , 8 of Spades;9 of Diamonds , False , False , False , , False , False , 8, 238, 56, 17, 360, hard_18_vs_8:stand (fallback)
3, 1, 16 , 2 , 19 , 4, 2, 1, PlayerTwo, 2 of Diamonds;2 of Diamonds;8 of Hearts;3 of Diamonds;4 of Spades , win , 5.00, 5.00, 10.00, 10.00, 0.00, 0.00, none , 0.00, 0.00, none , 0.00, 0.00, 800000.00, 799970.00, 799985.00, False , False , False , 0, 8 of Spades , 8 of Spades;9 of Diamonds , False , False , False , 8 of Hearts;3 of Diamonds;4 of Spades , False , False , 8, 238, 56, 17, 360, pair_2_vs_8:hit (main)
3, 1, 16 , 2 , 19 , 5, 2, 1, PlayerTwo, 10 of Clubs;J of Spades , win , 5.00, 5.00, 10.00, 10.00, 0.00, 0.00, none , 0.00, 0.00, none , 0.00, 0.00, 800000.00, 799970.00, 799995.00, False , False , False , 0, 8 of Spades , 8 of Spades;9 of Diamonds , False , False , False , , False , False , 8, 238, 56, 17, 360, hard_20_vs_8:stand (fallback)
4, 1, 12 , 1 , 15 , 1, 1, 1, PlayerOne, 10 of Hearts;J of Clubs , win , 10.00, 60.00, 20.00, 20.00, 1.00, 0.00, none , 1.00, 0.00, none , 0.00, 0.00, 1000000.00, 999777.00, 999735.00, False , False , False , 0, K of Spades , K of Spades;3 of Spades;J of Spades , False , True , False , , False , False , 8, 238, 73, 17, 343, hard_20_vs_10:stand (fallback)
4, 1, 12 , 1 , 15 , 2, 1, 1, PlayerOne, 4 of Diamonds;Q of Diamonds;A of Diamonds;7 of Clubs , lose , 10.00, 60.00, 0.00, 0.00, 1.00, 0.00, none , 1.00, 0.00, none , 0.00, 0.00, 1000000.00, 999777.00, 999735.00, False , False , False , 0, K of Spades , K of Spades;3 of Spades;J of Spades , False , True , True , A of Diamonds;7 of Clubs , False , False , 8, 238, 73, 17, 343, hard_14_vs_10:hit (main)
4, 1, 12 , 1 , 15 , 3, 2, 1, PlayerTwo, A of Hearts;J of Hearts , blackjack, 5.00, 5.00, 12.50, 12.50, 0.00, 0.00, none , 0.00, 0.00, none , 0.00, 0.00, 800000.00, 799985.00, 799992.50, True , False , False , 0, K of Spades , K of Spades;3 of Spades;J of Spades , False , True , False , , False , False , 8, 238, 73, 17, 343, soft_21_vs_10:stand (fallback)
4, 1, 12 , 1 , 15 , 4, 2, 1, PlayerTwo, 4 of Hearts;6 of Spades;2 of Spades;8 of Clubs , win , 5.00, 5.00, 10.00, 10.00, 0.00, 0.00, none , 0.00, 0.00, none , 0.00, 0.00, 800000.00, 799985.00, 800002.50, False , False , False , 0, K of Spades , K of Spades;3 of Spades;J of Spades , False , True , False , 2 of Spades;8 of Clubs , False , False , 8, 238, 73, 17, 343, hard_10_vs_10:hit (main)
4, 1, 12 , 1 , 15 , 5, 2, 1, PlayerTwo, 7 of Hearts;A of Spades , win , 5.00, 5.00, 10.00, 10.00, 0.00, 0.00, none , 0.00, 0.00, none , 0.00, 0.00, 800000.00, 799985.00, 800012.50, False , False , False , 0, K of Spades , K of Spades;3 of Spades;J of Spades , False , True , False , , False , False , 8, 238, 73, 17, 343, hard_18_vs_10:stand (fallback)
5, 1, 11 , 1 , 14 , 1, 1, 1, PlayerOne, 9 of Clubs;10 of Clubs , push , 10.00, 60.00, 10.00, 10.00, 1.00, 0.00, none , 1.00, 0.00, none , 0.00, 0.00, 1000000.00, 999673.00, 999611.00, False , False , False , 0, 9 of Hearts , 9 of Hearts;10 of Spades , False , False , False , , False , False , 8, 238, 89, 16, 327, hard_19_vs_9:stand (fallback)
5, 1, 11 , 1 , 14 , 2, 1, 1, PlayerOne, 4 of Spades;7 of Spades;6 of Diamonds , lose , 20.00, 60.00, 0.00, 0.00, 1.00, 0.00, none , 1.00, 0.00, none , 0.00, 0.00, 1000000.00, 999673.00, 999611.00, False , True , False , 0, 9 of Hearts , 9 of Hearts;10 of Spades , False , False , False , 6 of Diamonds , False , False , 8, 238, 89, 16, 327, hard_11_vs_9:double (main)
5, 1, 11 , 1 , 14 , 3, 2, 1, PlayerTwo, K of Hearts;8 of Spades , lose , 5.00, 5.00, 0.00, 0.00, 0.00, 0.00, none , 0.00, 0.00, none , 0.00, 0.00, 800000.00, 800002.50, 799997.50, False , False , False , 0, 9 of Hearts , 9 of Hearts;10 of Spades , False , False , False , , False , False , 8, 238, 89, 16, 327, hard_18_vs_9:stand (fallback)
5, 1, 11 , 1 , 14 , 4, 2, 1, PlayerTwo, A of Spades;4 of Diamonds;K of Spades;9 of Spades , lose , 5.00, 5.00, 0.00, 0.00, 0.00, 0.00, none , 0.00, 0.00, none , 0.00, 0.00, 800000.00, 800002.50, 799997.50, False , False , False , 0, 9 of Hearts , 9 of Hearts;10 of Spades , False , False , True , K of Spades;9 of Spades , False , False , 8, 238, 89, 16, 327, soft_15_vs_9:hit (main)
5, 1, 11 , 1 , 14 , 5, 2, 1, PlayerTwo, 3 of Diamonds;4 of Diamonds;Q of Clubs , lose , 5.00, 5.00, 0.00, 0.00, 0.00, 0.00, none , 0.00, 0.00, none , 0.00, 0.00, 800000.00, 800002.50, 799997.50, False , False , False , 0, 9 of Hearts , 9 of Hearts;10 of Spades , False , False , False , Q of Clubs , False , False , 8, 238, 89, 16, 327, hard_7_vs_9:hit (main)
6, 1, 10 , 1 , 13 , 1, 1, 1, PlayerOne, 10 of Hearts;6 of Diamonds , lose , 10.00, 60.00, 0.00, 0.00, 1.00, 0.00, none , 1.00, 0.00, none , 0.00, 0.00, 1000000.00, 999549.00, 999487.00, False , False , False , 0, J of Hearts , J of Hearts;7 of Hearts , False , False , False , , False , False , 8, 238, 104, 15, 312, hard_16_vs_10:stand (deviation)
6, 1, 10 , 1 , 13 , 2, 1, 1, PlayerOne, 10 of Spades;3 of Spades;9 of Diamonds , lose , 10.00, 60.00, 0.00, 0.00, 1.00, 0.00, none , 1.00, 0.00, none , 0.00, 0.00, 1000000.00, 999549.00, 999487.00, False , False , False , 0, J of Hearts , J of Hearts;7 of Hearts , False , False , True , 9 of Diamonds , False , False , 8, 238, 104, 15, 312, hard_13_vs_10:hit (main)
6, 1, 10 , 1 , 13 , 3, 2, 1, PlayerTwo, 9 of Spades;2 of Clubs;9 of Clubs , win , 10.00, 5.00, 20.00, 20.00, 0.00, 0.00, none , 0.00, 0.00, none , 0.00, 0.00, 800000.00, 799987.50, 799997.50, False , True , False , 0, J of Hearts , J of Hearts;7 of Hearts , False , False , False , 9 of Clubs , False , False , 8, 238, 104, 15, 312, hard_11_vs_10:double (main)
6, 1, 10 , 1 , 13 , 4, 2, 1, PlayerTwo, 9 of Spades;10 of Spades , win , 5.00, 5.00, 10.00, 10.00, 0.00, 0.00, none , 0.00, 0.00, none , 0.00, 0.00, 800000.00, 799987.50, 800007.50, False , False , False , 0, J of Hearts , J of Hearts;7 of Hearts , False , False , False , , False , False , 8, 238, 104, 15, 312, hard_19_vs_10:stand (fallback)
6, 1, 10 , 1 , 13 , 5, 2, 1, PlayerTwo, 8 of Diamonds;5 of Spades;J of Spades , lose , 5.00, 5.00, 0.00, 0.00, 0.00, 0.00, none , 0.00, 0.00, none , 0.00, 0.00, 800000.00, 799987.50, 800007.50, False , False , False , 0, J of Hearts , J of Hearts;7 of Hearts , False , False , True , J of Spades , False , False , 8, 238, 104, 15, 312, hard_13_vs_10:hit (main)
7, 1, 11 , 1 , 14 , 1, 1, 1, PlayerOne, 10 of Diamonds;K of Spades , push , 10.00, 60.00, 10.00, 10.00, 1.00, 0.00, none , 1.00, 0.00, none , 0.00, 0.00, 1000000.00, 999425.00, 999373.00, False , False , False , 0, 10 of Hearts , 10 of Hearts;K of Clubs , False , False , False , , False , False , 8, 238, 119, 15, 297, hard_20_vs_10:stand (fallback)
7, 1, 11 , 1 , 14 , 2, 1, 1, PlayerOne, 5 of Clubs;Q of Clubs , lose , 10.00, 60.00, 0.00, 0.00, 1.00, 0.00, none , 1.00, 0.00, none , 0.00, 0.00, 1000000.00, 999425.00, 999373.00, False , False , False , 0, 10 of Hearts , 10 of Hearts;K of Clubs , False , False , False , , False , False , 8, 238, 119, 15, 297, hard_15_vs_10:stand (deviation)
7, 1, 11 , 1 , 14 , 3, 2, 1, PlayerTwo, 5 of Clubs;J of Clubs;4 of Diamonds , lose , 5.00, 5.00, 0.00, 0.00, 0.00, 0.00, none , 0.00, 0.00, none , 0.00, 0.00, 800000.00, 799997.50, 799987.50, False , False , False , 0, 10 of Hearts , 10 of Hearts;K of Clubs , False , False , False , 4 of Diamonds , False , False , 8, 238, 119, 15, 297, hard_15_vs_10:hit (main)
7, 1, 11 , 1 , 14 , 4, 2, 1, PlayerTwo, 5 of Spades;6 of Diamonds;7 of Diamonds , lose , 10.00, 5.00, 0.00, 0.00, 0.00, 0.00, none , 0.00, 0.00, none , 0.00, 0.00, 800000.00, 799997.50, 799987.50, False , True , False , 0, 10 of Hearts , 10 of Hearts;K of Clubs , False , False , False , 7 of Diamonds , False , False , 8, 238, 119, 15, 297, hard_11_vs_10:double (main)
7, 1, 11 , 1 , 14 , 5, 2, 1, PlayerTwo, 7 of Hearts;6 of Diamonds;6 of Hearts , lose , 5.00, 5.00, 0.00, 0.00, 0.00, 0.00, none , 0.00, 0.00, none , 0.00, 0.00, 800000.00, 799997.50, 799987.50, False , False , False , 0, 10 of Hearts , 10 of Hearts;K of Clubs , False , False , False , 6 of Hearts , False , False , 8, 238, 119, 15, 297, hard_13_vs_10:hit (main)
8, 1, 11 , 2 , 14 , 1, 1, 1, PlayerOne, 8 of Diamonds;10 of Clubs , lose , 10.00, 60.00, 0.00, 0.00, 1.00, 0.00, none , 1.00, 0.00, none , 0.00, 0.00, 1000000.00, 999311.00, 999249.00, False , False , False , 0, 7 of Spades , 7 of Spades;4 of Spades;3 of Clubs;5 of Diamonds , False , False , False , , False , False , 8, 238, 137, 18, 279, hard_18_vs_7:stand (fallback)
8, 1, 11 , 2 , 14 , 2, 1, 1, PlayerOne, 4 of Hearts;A of Diamonds;8 of Hearts;A of Clubs;9 of Hearts , lose , 10.00, 60.00, 0.00, 0.00, 1.00, 0.00, none , 1.00, 0.00, none , 0.00, 0.00, 1000000.00, 999311.00, 999249.00, False , False , False , 0, 7 of Spades , 7 of Spades;4 of Spades;3 of Clubs;5 of Diamonds , False , False , True , 8 of Hearts;A of Clubs;9 of Hearts , False , False , 8, 238, 137, 18, 279, hard_15_vs_7:hit (main)
8, 1, 11 , 2 , 14 , 3, 2, 1, PlayerTwo, 7 of Diamonds;9 of Hearts , lose , 5.00, 5.00, 0.00, 0.00, 0.00, 0.00, none , 0.00, 0.00, none , 0.00, 0.00, 800000.00, 799977.50, 799972.50, False , False , False , 0, 7 of Spades , 7 of Spades;4 of Spades;3 of Clubs;5 of Diamonds , False , False , False , , False , False , 8, 238, 137, 18, 279, hard_16_vs_7:stand (main)
8, 1, 11 , 2 , 14 , 4, 2, 1, PlayerTwo, 8 of Clubs;K of Spades , lose , 5.00, 5.00, 0.00, 0.00, 0.00, 0.00, none , 0.00, 0.00, none , 0.00, 0.00, 800000.00, 799977.50, 799972.50, False , False , False , 0, 7 of Spades , 7 of Spades;4 of Spades;3 of Clubs;5 of Diamonds , False , False , False , , False , False , 8, 238, 137, 18, 279, hard_18_vs_7:stand (fallback)
8, 1, 11 , 2 , 14 , 5, 2, 1, PlayerTwo, 8 of Spades;4 of Spades;Q of Clubs , lose , 5.00, 5.00, 0.00, 0.00, 0.00, 0.00, none , 0.00, 0.00, none , 0.00, 0.00, 800000.00, 799977.50, 799972.50, False , False , False , 0, 7 of Spades , 7 of Spades;4 of Spades;3 of Clubs;5 of Diamonds , False , False , True , Q of Clubs , False , False , 8, 238, 137, 18, 279, hard_12_vs_7:hit (main)
9, 1, 8 , 1 , 11 , 1, 1, 1, PlayerOne, J of Spades;6 of Hearts , win , 10.00, 60.00, 20.00, 20.00, 1.00, 0.00, none , 1.00, 0.00, none , 0.00, 0.00, 1000000.00, 999187.00, 999145.00, False , False , False , 0, 3 of Diamonds , 3 of Diamonds;5 of Clubs;4 of Diamonds;A of Spades;Q of Diamonds , False , True , False , , False , False , 8, 238, 153, 16, 263, hard_16_vs_3:stand (main)
9, 1, 8 , 1 , 11 , 2, 1, 1, PlayerOne, Q of Hearts;8 of Spades , win , 10.00, 60.00, 20.00, 20.00, 1.00, 0.00, none , 1.00, 0.00, none , 0.00, 0.00, 1000000.00, 999187.00, 999165.00, False , False , False , 0, 3 of Diamonds , 3 of Diamonds;5 of Clubs;4 of Diamonds;A of Spades;Q of Diamonds , False , True , False , , False , False , 8, 238, 153, 16, 263, hard_18_vs_3:stand (fallback)
9, 1, 8 , 1 , 11 , 3, 2, 1, PlayerTwo, K of Diamonds;2 of Diamonds;J of Hearts , lose , 5.00, 5.00, 0.00, 0.00, 0.00, 0.00, none , 0.00, 0.00, none , 0.00, 0.00, 800000.00, 799962.50, 799957.50, False , False , False , 0, 3 of Diamonds , 3 of Diamonds;5 of Clubs;4 of Diamonds;A of Spades;Q of Diamonds , False , True , True , J of Hearts , False , False , 8, 238, 153, 16, 263, hard_12_vs_3:hit (main)
9, 1, 8 , 1 , 11 , 4, 2, 1, PlayerTwo, A of Hearts;Q of Clubs , blackjack, 5.00, 5.00, 12.50, 12.50, 0.00, 0.00, none , 0.00, 0.00, none , 0.00, 0.00, 800000.00, 799962.50, 799970.00, True , False , False , 0, 3 of Diamonds , 3 of Diamonds;5 of Clubs;4 of Diamonds;A of Spades;Q of Diamonds , False , True , False , , False , False , 8, 238, 153, 16, 263, soft_21_vs_3:stand (fallback)
9, 1, 8 , 1 , 11 , 5, 2, 1, PlayerTwo, 3 of Spades;K of Clubs , win , 5.00, 5.00, 10.00, 10.00, 0.00, 0.00, none , 0.00, 0.00, none , 0.00, 0.00, 800000.00, 799962.50, 799980.00, False , False , False , 0, 3 of Diamonds , 3 of Diamonds;5 of Clubs;4 of Diamonds;A of Spades;Q of Diamonds , False , True , False , , False , False , 8, 238, 153, 16, 263, hard_13_vs_3:stand (main)
10, 1, 5 , 1 , 8 , 1, 1, 1, PlayerOne, 10 of Spades;3 of Hearts , win , 10.00, 60.00, 20.00, 20.00, 1.00, 0.00, none , 1.00, 0.00, none , 0.00, 0.00, 1000000.00, 999103.00, 999061.00, False , False , False , 0, 6 of Spades , 6 of Spades;10 of Hearts;7 of Hearts , False , True , False , , False , False , 8, 238, 166, 13, 250, hard_13_vs_6:stand (main)
10, 1, 5 , 1 , 8 , 2, 1, 1, PlayerOne, 5 of Spades;10 of Diamonds , win , 10.00, 60.00, 20.00, 20.00, 1.00, 0.00, none , 1.00, 0.00, none , 0.00, 0.00, 1000000.00, 999103.00, 999081.00, False , False , False , 0, 6 of Spades , 6 of Spades;10 of Hearts;7 of Hearts , False , True , False , , False , False , 8, 238, 166, 13, 250, hard_15_vs_6:stand (main)
10, 1, 5 , 1 , 8 , 3, 2, 1, PlayerTwo, 10 of Clubs;J of Clubs , win , 5.00, 5.00, 10.00, 10.00, 0.00, 0.00, none , 0.00, 0.00, none , 0.00, 0.00, 800000.00, 799970.00, 799975.00, False , False , False , 0, 6 of Spades , 6 of Spades;10 of Hearts;7 of Hearts , False , True , False , , False , False , 8, 238, 166, 13, 250, hard_20_vs_6:stand (fallback)
10, 1, 5 , 1 , 8 , 4, 2, 1, PlayerTwo, Q of Clubs;6 of Hearts , win , 5.00, 5.00, 10.00, 10.00, 0.00, 0.00, none , 0.00, 0.00, none , 0.00, 0.00, 800000.00, 799970.00, 799985.00, False , False , False , 0, 6 of Spades , 6 of Spades;10 of Hearts;7 of Hearts , False , True , False , , False , False , 8, 238, 166, 13, 250, hard_16_vs_6:stand (main)
10, 1, 5 , 1 , 8 , 5, 2, 1, PlayerTwo, J of Spades;9 of Clubs , win , 5.00, 5.00, 10.00, 10.00, 0.00, 0.00, none , 0.00, 0.00, none , 0.00, 0.00, 800000.00, 799970.00, 799995.00, False , False , False , 0, 6 of Spades , 6 of Spades;10 of Hearts;7 of Hearts , False , True , False , , False , False , 8, 238, 166, 13, 250, hard_19_vs_6:stand (fallback)
11, 1, 7 , 1 , 10 , 1, 1, 1, PlayerOne, A of Clubs;3 of Spades;8 of Diamonds;4 of Hearts;7 of Spades , lose , 10.00, 60.00, 0.00, 11.00, 1.00, 0.00, none , 1.00, 11.00, Straight , 0.00, 0.00, 1000000.00, 999019.00, 998968.00, False , False , False , 0, 2 of Hearts , 2 of Hearts;4 of Clubs;2 of Diamonds;7 of Hearts;K of Hearts , False , True , True , 8 of Diamonds;4 of Hearts;7 of Spades , False , False , 8, 238, 184, 18, 232, soft_14_vs_2:hit (main)
11, 1, 7 , 1 , 10 , 2, 1, 1, PlayerOne, 4 of Hearts;A of Diamonds , win , 10.00, 60.00, 20.00, 20.00, 1.00, 0.00, none , 1.00, 0.00, none , 0.00, 0.00, 1000000.00, 999019.00, 998988.00, False , False , False , 0, 2 of Hearts , 2 of Hearts;4 of Clubs;2 of Diamonds;7 of Hearts;K of Hearts , False , True , False , , False , False , 8, 238, 184, 18, 232, hard_15_vs_2:stand (main)
11, 1, 7 , 1 , 10 , 3, 2, 1, PlayerTwo, 9 of Hearts;J of Diamonds , win , 5.00, 5.00, 10.00, 10.00, 0.00, 0.00, none , 0.00, 0.00, none , 0.00, 0.00, 800000.00, 799985.00, 799990.00, False , False , False , 0, 2 of Hearts , 2 of Hearts;4 of Clubs;2 of Diamonds;7 of Hearts;K of Hearts , False , True , False , , False , False , 8, 238, 184, 18, 232, hard_19_vs_2:stand (fallback)
11, 1, 7 , 1 , 10 , 4, 2, 1, PlayerTwo, 5 of Hearts;10 of Diamonds , win , 5.00, 5.00, 10.00, 10.00, 0.00, 0.00, none , 0.00, 0.00, none , 0.00, 0.00, 800000.00, 799985.00, 800000.00, False , False , False , 0, 2 of Hearts , 2 of Hearts;4 of Clubs;2 of Diamonds;7 of Hearts;K of Hearts , False , True , False , , False , False , 8, 238, 184, 18, 232, hard_15_vs_2:stand (main)
11, 1, 7 , 1 , 10 , 5, 2, 1, PlayerTwo, K of Diamonds;6 of Spades , win , 5.00, 5.00, 10.00, 10.00, 0.00, 0.00, none , 0.00, 0.00, none , 0.00, 0.00, 800000.00, 799985.00, 800010.00, False , False , False , 0, 2 of Hearts , 2 of Hearts;4 of Clubs;2 of Diamonds;7 of Hearts;K of Hearts , False , True , False , , False , False , 8, 238, 184, 18, 232, hard_16_vs_2:stand (main)
12, 2, -2 , 0 , -3 , 1, 1, 1, PlayerOne, 9 of Hearts;K of Diamonds , lose , 10.00, 5.00, 0.00, 0.00, 1.00, 0.00, none , 1.00, 0.00, none , 0.00, 0.00, 1000000.00, 998981.00, 998974.00, False , False , False , 0, K of Spades , K of Spades;J of Diamonds , False , False , False , , False , False , 8, 224, 16, 16, 400, hard_19_vs_10:stand (fallback)
12, 2, -2 , 0 , -3 , 2, 1, 1, PlayerOne, 9 of Hearts;9 of Clubs , lose , 10.00, 5.00, 0.00, 7.00, 1.00, 7.00, Mixed Pair , 1.00, 0.00, none , 0.00, 0.00, 1000000.00, 998981.00, 998981.00, False , False , False , 0, K of Spades , K of Spades;J of Diamonds , False , False , False , , False , False , 8, 224, 16, 16, 400, pair_9_vs_10:stand (main)
12, 2, -2 , 0 , -3 , 3, 2, 1, PlayerTwo, 7 of Clubs;Q of Diamonds , lose , 5.00, 5.00, 0.00, 0.00, 0.00, 0.00, none , 0.00, 0.00, none , 0.00, 0.00, 800000.00, 800000.00, 799995.00, False , False , False , 0, K of Spades , K of Spades;J of Diamonds , False , False , False , , False , False , 8, 224, 16, 16, 400, hard_17_vs_10:stand (fallback)
12, 2, -2 , 0 , -3 , 4, 2, 1, PlayerTwo, 6 of Hearts;7 of Spades;A of Clubs;J of Clubs , lose , 5.00, 5.00, 0.00, 0.00, 0.00, 0.00, none , 0.00, 0.00, none , 0.00, 0.00, 800000.00, 800000.00, 799995.00, False , False , False , 0, K of Spades , K of Spades;J of Diamonds , False , False , True , A of Clubs;J of Clubs , False , False , 8, 224, 16, 16, 400, hard_13_vs_10:hit (main)
12, 2, -2 , 0 , -3 , 5, 2, 1, PlayerTwo, 9 of Clubs;4 of Hearts;2 of Clubs;4 of Diamonds , lose , 5.00, 5.00, 0.00, 0.00, 0.00, 0.00, none , 0.00, 0.00, none , 0.00, 0.00, 800000.00, 800000.00, 799995.00, False , False , False , 0, K of Spades , K of Spades;J of Diamonds , False , False , False , 2 of Clubs;4 of Diamonds , False , False , 8, 224, 16, 16, 400, hard_13_vs_10:hit (main)
.
.
.
Below is an overview of the key columns in SimJack's CSV output:
| Column | Description |
|---|---|
round |
Round number |
shoe |
Shoe number (reshuffle counter) |
deck_running_count |
Running count for the shoe for the player |
true_count |
True count (running count ÷ remaining decks) |
real_count_till_cut_card |
Actual Count until cut card is reached |
box_id |
Table box index |
player_id |
Unique player identifier |
hand_id |
Hand identifier for that box |
owner |
Player name or label |
hand |
All cards in the hand, semicolon-separated |
result |
Outcome: win, lose, push, blackjack |
bet_from_config |
Initial bet unit from config |
bet_unit_used |
Adjusted bet (after ramping or deviations) |
hand_payout |
Total hand payout (may include sidebets) |
main_payout |
Main bet-only payout |
pp_bet |
Perfect Pair bet amount |
pp_win |
Perfect Pair win amount |
pp_type |
Perfect Pair result type (e.g., Mixed, Suited) |
p21_bet |
21+3 sidebet amount |
p21_win |
21+3 win amount |
p21_type |
21+3 hand result category |
insurance_bet |
Insurance bet amount |
insurance_payout |
Insurance win amount |
initial_balance |
Starting balance at simulation begin |
round_start_balance |
Player balance at start of current round |
player_balance |
Player balance after round result |
is_blackjack |
Whether the player hand was a blackjack |
is_doubled |
Whether the hand was doubled |
is_split_child |
Whether this hand was from a split |
split_count |
Total splits performed so far |
dealer_upcard |
Dealer's first visible card |
dealer_final_hand |
Dealer's full hand |
dealer_blackjack |
Did dealer have a blackjack? |
dealer_bust |
Did dealer bust? |
player_bust |
Did player bust? |
player_draws |
Cards drawn after the first two |
player_is_bankrupt |
Player cannot place another minimum bet |
player_is_retired |
Player reached target balance |
num_decks |
Number of decks used in shoe |
cut_card_position |
Cut card index in deck |
cards_drawn_total |
Cumulative cards drawn in current shoe |
cards_drawn_round |
Cards drawn in this round only |
cards_left_after_round |
Cards left in shoe after round ends |
strategy_key |
Decision trace applied to this hand |
These fields allow for detailed financial, strategic, and statistical analysis across any simulation run.
SimJack can simulate 10 million hands in a single run. But how does that compare to real-life gameplay?
| Scenario | Real Life (Casino) | SimJack (Simulation) |
|---|---|---|
| Average time per round | ~5 seconds | < 0.002 seconds |
| 1 player x 10,000,000 rounds | ~578 days (non-stop) | ~2 minutes |
| 7-player full table | ~4s x 7 = 28s/round | still ~2 minutes |
🌟 SimJack compresses 1.5 years of gameplay into just 2 minutes.
With SimJack, you can:
- 🎯 Make decisions based on statistical confidence, not just gut feeling
- ⏳ Avoid wasting days (or bankroll) testing bad strategies
- 📊 Gather more data in 1 hour than 1 year of table experience
MIT — see LICENSE
Happy simulating! 🧠