Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rcapers/bj-term
Python Blackjack in the Terminal
https://github.com/rcapers/bj-term
blackjack blackjack-cli blackjack-game blackjack-python
Last synced: about 1 month ago
JSON representation
Python Blackjack in the Terminal
- Host: GitHub
- URL: https://github.com/rcapers/bj-term
- Owner: rcapers
- Created: 2023-04-15T09:28:29.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-11-26T22:31:20.000Z (about 1 month ago)
- Last Synced: 2024-11-26T23:26:17.309Z (about 1 month ago)
- Topics: blackjack, blackjack-cli, blackjack-game, blackjack-python
- Language: Python
- Homepage:
- Size: 483 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Terminal Blackjack
A stylish command-line implementation of Blackjack with a modern dark theme interface, written in Python 3.
## Features
- 🎨 Modern dark theme interface with colored cards and text
- 🎮 Intuitive gameplay with clear visual feedback
- 💰 Persistent game statistics and balance tracking
- 🎵 Sound effects for enhanced gaming experience
- 📊 Detailed statistics tracking (wins, losses, streaks)
- 💾 Auto-save functionality
- 🎲 Professional card visuals with suit symbols
- 🏆 Achievement system with unlockable rewards
- 🧠 Strategic gameplay assistance
- 📈 Card counting and streak tracking
## Play Online
▶️ [Play on Replit](https://replit.com/@rcapers/bj-term)
You can try the game directly in your browser without installing anything!
## Achievement System
Unlock special achievements as you play:
- **High Roller**: Win with a bet of $500 or more
- **Blackjack Master**: Get 5 natural blackjacks
- **Comeback King**: Win after being down to less than 20% of starting balance
- **Lucky Seven**: Win 7 hands in a row
- **Card Counter**: Win 10 hands in one session
## Strategy Features
- Basic strategy hints for optimal play
- Card counting status indicator
- Hot streak tracking
- Progressive betting suggestions
## Installation
To run locally:
```bash
# Clone the repository
git clone https://github.com/rcapers/bj-term.git
cd bj-term
# Install dependencies
pip install -r requirements.txt
# Run the game
python bj-term.py
```
## Usage
Run the game with default settings:
```bash
python bj-term.py
```
Available options:
```bash
python bj-term.py --help # Show all available options
python bj-term.py --no-sound # Run without sound effects
python bj-term.py --no-hints # Disable strategy hints
```
## Game Controls
- `H` - Hit (draw another card)
- `S` - Stand (keep current hand)
- `D` - Double down (double bet & draw one card)
- `Q` - Quit (save and exit)
- `?` - Help (show game rules)
## Game Rules
Standard Blackjack rules apply:
- Beat the dealer's hand without going over 21
- Card values:
- Number cards (2-10): Face value
- Face cards (J, Q, K): 10
- Aces: 1 or 11
- Dealer must hit on 16 and stand on 17
- Blackjack pays 3:2
## Statistics Tracking
The game tracks:
- Games played
- Wins/Losses/Pushes
- Biggest wins and losses
- Current and best winning streaks
- Hot streak status
- Card counting progress
- Achievement progress
## Development
Developed by Ryan Capers as a Python learning project. Recent improvements include:
- Achievement system
- Strategy assistance
- Enhanced statistics tracking
- Card counting features
- Progressive betting system
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.