185 lines
5.4 KiB
Markdown
185 lines
5.4 KiB
Markdown
# Baccarat - Casino Card Game
|
|
|
|
A feature-rich Baccarat (Punto Banco) app for iOS built with SwiftUI. Experience authentic casino gameplay with side bets, road map history, and detailed statistics — all without risking real money.
|
|
|
|
|
|
|
|
|
|
|
|
## Features
|
|
|
|
### 🎓 First-Time User Experience
|
|
- **Welcome Sheet** — Interactive introduction on first launch
|
|
- **Spotlight Walkthrough** — Guided tour with spotlight focus on key UI elements
|
|
- **Sherpa Framework** — Modern walkthrough with progress indicators and haptic feedback
|
|
- **Never Intrusive** — All onboarding is skippable and shown only once
|
|
|
|
### 🎰 Authentic Punto Banco Gameplay
|
|
- Complete Baccarat rules with automatic third card logic
|
|
- Natural detection (8 or 9 on initial deal)
|
|
- Multi-deck shoe support (1, 6, or 8 decks)
|
|
- Animated card dealing with sound effects and haptics
|
|
- Automatic shoe reshuffling with burn card
|
|
|
|
### ⚙️ Settings & Customization
|
|
- Dealing animations toggle and adjustable dealing speed
|
|
- Card reveal style: Auto (instant flip), Tap (per-card), Squeeze (peek/drag reveal)
|
|
- Persistent preferences via iCloud sync
|
|
|
|
### 💰 Betting Options
|
|
|
|
#### Main Bets
|
|
| Bet Type | Payout | House Edge |
|
|
|----------|--------|------------|
|
|
| Player | 1:1 | 1.24% |
|
|
| Banker | 0.95:1 (5% commission) | 1.06% |
|
|
| Tie | 8:1 | 14.4% |
|
|
|
|
#### Side Bets
|
|
| Bet Type | Payout |
|
|
|----------|--------|
|
|
| Player Pair | 11:1 |
|
|
| Banker Pair | 11:1 |
|
|
| Dragon Bonus (Natural) | 1:1 |
|
|
| Dragon Bonus (Win by 4) | 1:1 |
|
|
| Dragon Bonus (Win by 5) | 2:1 |
|
|
| Dragon Bonus (Win by 6) | 4:1 |
|
|
| Dragon Bonus (Win by 7) | 6:1 |
|
|
| Dragon Bonus (Win by 8) | 10:1 |
|
|
| Dragon Bonus (Win by 9) | 30:1 |
|
|
|
|
### 📊 Road Map History
|
|
- Visual "Big Road" style result display
|
|
- Color-coded outcomes (Blue=Player, Red=Banker, Green=Tie)
|
|
- Pair markers (yellow dot)
|
|
- Natural markers (star)
|
|
- Scrollable session history
|
|
|
|
### 🎚️ Table Limits
|
|
| Level | Min Bet | Max Bet |
|
|
|-------|---------|---------|
|
|
| Casual | $5 | $500 |
|
|
| Low Stakes | $10 | $1,000 |
|
|
| Medium Stakes | $25 | $5,000 |
|
|
| High Stakes | $100 | $10,000 |
|
|
| VIP | $500 | $50,000 |
|
|
|
|
### ☁️ iCloud Sync
|
|
- Balance and statistics sync across devices
|
|
- Settings persist via iCloud
|
|
- Automatic conflict resolution
|
|
|
|
## Architecture
|
|
|
|
```
|
|
Baccarat/
|
|
├── BaccaratApp.swift # App entry point
|
|
├── ContentView.swift # Root view
|
|
├── Engine/
|
|
│ ├── BaccaratEngine.swift # Core game logic, third card rules, payouts
|
|
│ └── GameState.swift # Observable state machine
|
|
├── Models/
|
|
│ ├── BetType.swift # Bet types, payouts, Dragon Bonus table
|
|
│ ├── GameResult.swift # Round outcomes
|
|
│ ├── GameSettings.swift # User preferences, table limits
|
|
│ ├── Hand.swift # Baccarat hand model
|
|
│ └── Shoe.swift # Multi-deck shoe with shuffle/burn
|
|
├── Storage/
|
|
│ └── BaccaratGameData.swift # Persistence models
|
|
├── Theme/
|
|
│ └── DesignConstants.swift # Design system tokens
|
|
├── Views/
|
|
│ ├── Development/ # Dev-only views (branding, icons)
|
|
│ ├── Game/ # Main game UI components
|
|
│ ├── Sheets/ # Modal views (settings, stats, rules)
|
|
│ └── Table/ # Table layout, betting zones, road map
|
|
└── Resources/
|
|
└── Localizable.xcstrings # Localization strings
|
|
```
|
|
|
|
## Game Rules
|
|
|
|
### Card Values
|
|
- **Ace**: 1 point
|
|
- **2-9**: Face value
|
|
- **10, J, Q, K**: 0 points
|
|
- Hand value = sum mod 10 (e.g., 7+8=15 → 5)
|
|
|
|
### Third Card Rules
|
|
|
|
#### Player
|
|
- 0-5: Draws third card
|
|
- 6-7: Stands
|
|
- 8-9: Natural (no third card)
|
|
|
|
#### Banker (when Player draws)
|
|
| Banker Total | Draws if Player's 3rd is... |
|
|
|--------------|----------------------------|
|
|
| 0-2 | Always draws |
|
|
| 3 | 0-7, 9 (not 8) |
|
|
| 4 | 2-7 |
|
|
| 5 | 4-7 |
|
|
| 6 | 6-7 |
|
|
| 7 | Never draws |
|
|
|
|
## Tech Stack
|
|
|
|
- **iOS 26.0+** target
|
|
- **Swift 6.2** with strict concurrency
|
|
- **SwiftUI** with `@Observable` for state management
|
|
- **CasinoKit** — Shared package for cards, chips, sounds, and common UI
|
|
- **CloudKit** — iCloud sync for game data and settings
|
|
|
|
## Requirements
|
|
|
|
- Xcode 16.0+
|
|
- iOS 26.0+ deployment target
|
|
- Swift 6.2+
|
|
|
|
## Getting Started
|
|
|
|
1. Open `CasinoGames.xcworkspace` in Xcode
|
|
2. Select the **Baccarat** scheme
|
|
3. Build and run on a simulator or device
|
|
|
|
## Localization
|
|
|
|
The app supports:
|
|
- English (en)
|
|
- Spanish - Mexico (es-MX)
|
|
- French - Canada (fr-CA)
|
|
|
|
Strings are managed via String Catalogs (`Localizable.xcstrings`).
|
|
|
|
## Design System
|
|
|
|
All UI values are centralized in `DesignConstants.swift`:
|
|
- Spacing, corner radii, font sizes
|
|
- Opacity and shadow values
|
|
- Animation durations
|
|
- Semantic color definitions
|
|
|
|
## Accessibility
|
|
|
|
- Full VoiceOver support with meaningful labels
|
|
- Dynamic Type for scalable text
|
|
- High-contrast visuals
|
|
- Accessibility summaries for road map history
|
|
|
|
## Why Baccarat?
|
|
|
|
- **Lowest house edge** in the casino (1.06% on Banker bet)
|
|
- **No skill required** — pure chance with simple rules
|
|
- **Fast-paced** gameplay
|
|
- **Elegant** and sophisticated atmosphere
|
|
- **James Bond's favorite** casino game
|
|
|
|
## License
|
|
|
|
This project is proprietary software. All rights reserved.
|
|
|
|
---
|
|
|
|
*Built with ❤️ using SwiftUI*
|
|
|