🃏 iOS Texas Hold'em Poker

A professional Texas Hold'em poker game built with SwiftUI

English | 中文

---

✨ Features

🎮 Game Modes

• Tournament Mode - Compete against AI players with increasing blind levels
• Cash Game Mode - Flexible play with buy-in/top-up system

🎯 Core Game Engine

• Complete Texas Hold'em rules implementation
• Multi-player support (2-8 players)
• Advanced betting system (check, call, raise, fold, all-in)
• Buy-in and top-up support for cash games
• Session tracking and profit analysis

🤖 AI Opponents (7 Unique Personalities)

Character	Style	VPIP	Aggression	Description
🪨 Rock	Tight-Aggressive	15%	High	Plays only premium hands
😈 Maniac	Loose-Aggressive	55%	Very High	Bets constantly, never folds
👩 Anna	Loose-Passive	40%	Very Low	Calls everything, never raises
🦊 Fox	Balanced	45%	Medium	Hard to read, strategic play
🦈 Shark	Position-Play	45%	High	Exploits position, harvests fish
👩‍🏫 Amy	GTO-Math	50%	Medium	Mathematical optimal play
😤 David	Tilt-Based	Dynamic	Dynamic	Emotional player, can go on tilt

🧠 Advanced AI System

• Monte Carlo simulation for win rate calculation
• ICM (Independent Chip Model) for tournament play
• Position-based strategy adjustment
• Opponent modeling and profiling
• Bluff frequency and timing optimization

📊 Statistics & Tracking

• Hands played
• Win rate by position
• VPIP/PFR tracking
• Session history
• Performance graphs
• Cash game profit/loss tracking
• Session duration and stats

---

🛠 Technology Stack

Layer	Technology
Language	Swift 5.9+
UI Framework	SwiftUI (iOS 15+)
State Management	Combine + ObservableObject
Architecture	MVVM + Finite State Machine
Persistence	Core Data + UserDefaults
Testing	XCTest

---

📁 Project Structure

TexasPoker/
├── App/
│   └── TexasPokerApp.swift          # App entry point
│
├── Core/
│   ├── AI/
│   │   ├── AIProfile.swift          # AI personality definitions
│   │   ├── DecisionEngine.swift      # AI decision making
│   │   ├── BluffDetector.swift      # Bluff probability
│   │   ├── ICMCalculator.swift      # Tournament equity
│   │   ├── MonteCarloSimulator.swift # Win rate calculation
│   │   ├── OpponentModeler.swift    # Player profiling
│   │   ├── RangeAnalyzer.swift      # Hand range analysis
│   │   └── DifficultyManager.swift   # AI difficulty levels
│   │
│   ├── Data/
│   │   ├── PersistenceController.swift # Core Data stack
│   │   ├── StatisticsCalculator.swift  # Stats computation
│   │   ├── ProfileManager.swift        # Player profile management
│   │   ├── DataMigrationManager.swift # Schema migration
│   │   ├── ActionRecorder.swift       # Hand history
│   │   └── DataExporter.swift         # Export functionality
│   │
│   ├── Engine/
│   │   ├── PokerEngine.swift            # Main game loop
│   │   ├── HandEvaluator.swift          # Hand strength evaluation
│   │   ├── BettingManager.swift         # Betting logic
│   │   ├── DealingManager.swift         # Card dealing
│   │   ├── ShowdownManager.swift        # Win determination
│   │   ├── TournamentManager.swift      # Tournament logic
│   │   ├── CashGameManager.swift        # Cash game logic
│   │   ├── GameResultsManager.swift     # Result calculation
│   │   └── TiltManager.swift            # Emotional state tracking
│   │
│   ├── FSM/
│   │   ├── GameState.swift           # State definitions
│   │   ├── GameEvent.swift           # Game events
│   │   └── PokerGameStore.swift      # State machine
│   │
│   ├── Models/
│   │   ├── Card.swift                # Card model
│   │   ├── Deck.swift               # Deck management
│   │   ├── Player.swift              # Base player
│   │   ├── HumanPlayer.swift         # Human player
│   │   ├── AIPlayer.swift            # AI player wrapper
│   │   ├── Pot.swift                 # Pot model
│   │   ├── ActionLogEntry.swift      # Action logging
│   │   ├── BlindLevel.swift          # Blind structure
│   │   ├── GameRecord.swift          # Game records
│   │   ├── GameSettings.swift        # Game settings
│   │   ├── GameMode.swift            # Game mode enum
│   │   ├── TournamentConfig.swift    # Tournament config
│   │   ├── CashGameConfig.swift      # Cash game config
│   │   ├── CashGameSession.swift      # Cash game session
│   │   └── more models...
│   │
│   └── Utils/
│       ├── ColorTheme.swift          # UI theming
│       ├── DeviceHelper.swift        # Device adaptation
│       └── Constants.swift           # App constants
│
├── UI/
│   ├── Components/
│   │   ├── CardView.swift           # Card visualization
│   │   ├── ChipStackView.swift      # Chip stack display
│   │   ├── FlippingCard.swift       # Card flip animation
│   │   └── ActionButtons.swift      # Game actions
│   │
│   └── Views/
│       ├── GameTableView.swift      # Main table view
│       ├── PlayerView.swift         # Player info display
│       ├── ControlPanel.swift       # Player controls
│       ├── SettingsView.swift       # Settings screen
│       ├── StatisticsView.swift     # Stats dashboard
│       ├── RankingsView.swift       # Leaderboards
│       └── GameSubviews/           # Sub-components
│           ├── GameTopBar.swift
│           ├── GamePotDisplay.swift
│           ├── GameHeroControls.swift
│           ├── GameActionLogPanel.swift
│           ├── GameTournamentInfo.swift
│           ├── BuyInView.swift
│           ├── TopUpView.swift
│           ├── LeaveTableButton.swift
│           └── CashSessionSummaryView.swift
│
├── Resources/
│   ├── Assets.xcassets
│   ├── Sounds/
│   └── Data/
│
└── TexasPokerTests/
    ├── Core/
    │   └── Engine/
    │       ├── HandEvaluatorTests.swift
    │       └── PokerEngineTests.swift
    ├── UI/
    │   ├── ColorThemeTests.swift
    │   └── GameViewLayoutTests.swift
    ├── CashGameConfigTests.swift
    ├── CashGameManagerTests.swift
    ├── CashGameSessionTests.swift
    └── UncalledBetTests.swift

---

🚀 Getting Started

Prerequisites

• macOS 14+ or macOS 15+ (Apple Silicon recommended)
• Xcode 15+
• iOS 15.0+ Simulator or Device

Installation

# Clone the repository
git clone https://github.com/yourusername/ios-poker-game.git
cd ios-poker-game

# Open in Xcode
open TexasPoker.xcodeproj

# Select a simulator and run (Cmd+R)

Building from Command Line

xcodebuild -project TexasPoker.xcodeproj \
           -scheme TexasPoker \
           -destination 'platform=iOS Simulator,name=iPhone 15' \
           -configuration Debug \
           build

---

📖 Usage

Starting a Game

1. Launch the app
2. Select game mode (Cash Game / Tournament)
3. Choose opponents (1-7 AI players)
4. Set buy-in amount
5. Press "Deal" to start

Game Controls

• Check: Available when no bet pending
• Call: Match the current bet
• Raise: Increase the bet
• Fold: Surrender the hand
• All-In: Commit all chips

AI Customization

Each AI opponent can be customized:

• Personality profile
• Starting stack
• Difficulty level
• Avatar selection

---

🧪 Testing

# Run all tests
xcodebuild test -project TexasPoker.xcodeproj \
                -scheme TexasPoker \
                -destination 'platform=iOS Simulator,name=iPhone 15'

# Run specific test class
xcodebuild test -project TexasPoker.xcodeproj \
                -scheme TexasPoker \
                -destination 'platform=iOS Simulator,name=iPhone 15' \
                -only-testing:TexasPokerTests/Core/Engine/HandEvaluatorTests

---

📈 Architecture

State Machine

┌─────────────────────────────────────────────────────────┐
│                    Game States                           │
├─────────────────────────────────────────────────────────┤
│  idle → preFlop → flop → turn → river → showdown       │
│    ↑                                                    │
│    └───loop (new hand)                                 │
└─────────────────────────────────────────────────────────┘

Decision Flow

Player Action
    ↓
Game Context (pot, position, hand strength)
    ↓
AI Decision Engine
    ├── Check hand strength (Monte Carlo)
    ├── Calculate pot odds
    ├── Apply personality adjustments
    └── Select action (weighted random)
    ↓
Execute Action

---

🎨 Screenshots

Game Table	Player View	Statistics

Screenshots coming soon - replace with actual game screenshots

---

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

🙏 Acknowledgments

• SwiftUI - Apple's modern UI framework
• Combine - Reactive programming framework
• XCTest - Testing framework

---

Made with ❤️ by the Poker AI Team