{"id":27998463,"url":"https://github.com/10daviesb/blackjack","last_synced_at":"2025-05-08T22:53:27.779Z","repository":{"id":291990977,"uuid":"978908755","full_name":"10daviesb/Blackjack","owner":"10daviesb","description":"🃏 Blackjack Game - A Python-based Blackjack game with a graphical user interface (GUI) built using tkinter. Play against the dealer with features like betting, splitting hands, insurance, and smooth card animations. Perfect for Blackjack enthusiasts and Python developers looking for a fun project to explore!","archived":false,"fork":false,"pushed_at":"2025-05-07T14:46:06.000Z","size":4847,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-08T22:53:23.862Z","etag":null,"topics":["blackjack","casino","gambling","gui","portfolio-project","pygame","python","tkinter"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/10daviesb.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-06T17:35:27.000Z","updated_at":"2025-05-07T14:46:09.000Z","dependencies_parsed_at":"2025-05-07T15:48:16.470Z","dependency_job_id":"05ac2b0f-c2bf-447f-8287-061d58580ce1","html_url":"https://github.com/10daviesb/Blackjack","commit_stats":null,"previous_names":["10daviesb/blackjack"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/10daviesb%2FBlackjack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/10daviesb%2FBlackjack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/10daviesb%2FBlackjack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/10daviesb%2FBlackjack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/10daviesb","download_url":"https://codeload.github.com/10daviesb/Blackjack/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253160820,"owners_count":21863624,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["blackjack","casino","gambling","gui","portfolio-project","pygame","python","tkinter"],"created_at":"2025-05-08T22:53:27.089Z","updated_at":"2025-05-08T22:53:27.743Z","avatar_url":"https://github.com/10daviesb.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🃏 Blackjack Game\n\n![Python](https://img.shields.io/badge/python-3.8%2B-blue)\n![License](https://img.shields.io/github/license/10daviesb/Blackjack)\n\nA Python-based Blackjack game with a graphical user interface (GUI) built using `tkinter`. The game includes features like betting, splitting hands, insurance, and animations for card movements.\n\n## 🎮 Overview\nThis project is an interactive GUI Blackjack game. The game allows users to play against a dealer, with a focus on an engaging user interface and smooth animations for drawing cards.\n\n## 📂 Project Structure\n```\nblackjack-game\n├── src\n│   ├── main.py          # 🎯 Entry point of the application\n│   ├── assets           # 🎨 Contains assets for the game\n│   │   ├── cards        # 🃏 Image files for playing cards\n│   │   ├── sounds       # 🔊 Sound effects for the game\n│   │   └── styles       # 🎨 Style files for the user interface\n│   └── components       # 🛠️ Contains game logic components\n│       ├── deck.py      # 🃏 Manages the deck of cards\n│       ├── hand.py      # ✋ Represents player's and dealer's hands\n│       └── animations.py # 🎥 Handles animations for card draws\n├── requirements.txt     # 📦 Lists dependencies for the project\n├── README.md            # 📖 Documentation for the project\n└── .gitignore           # 🚫 Specifies files to ignore in version control\n```\n\n## ⚙️ Setup Instructions\n1. Clone the repository:\n   ```\n   git clone https://github.com/10daviesb/blackjack-game.git\n   cd blackjack-game\n   ```\n\n2. Install the required dependencies:\n   ```\n   pip install -r requirements.txt\n   ```\n\n3. Run the game:\n   ```\n   python src/main.py\n   ```\n\n## 🃏 Gameplay Rules\n- 🎯 The objective of Blackjack is to beat the dealer by having a hand value closer to 21 without exceeding it.\n- 🃏 Each player is dealt two cards, and they can choose to \"hit\" (draw another card) or \"stand\" (keep their current hand).\n- 🤖 The dealer must hit until their hand value is 17 or higher.\n- 🂡 Aces can count as 1 or 11, and face cards (Kings, Queens, Jacks) count as 10.\n- 💥 If the player's hand exceeds 21, they bust and lose the round.\n\n## ✨ Features\n- 💰 **Betting System**: Place bets before starting the game.\n- ✂️ **Splitting Hands**: Split your hand into two if the first two cards are of the same rank.\n- 🛡️ **Insurance**: Place an insurance bet if the dealer's face-up card is an Ace.\n- 🎥 **Smooth Animations**: Cards are animated as they are drawn from the deck to the player's or dealer's hand.\n- 🔊 **Sound Effects**: Includes card draw sound effects.\n- ⚙️ **Settings Menu**: Adjust the volume of the sound effects using a slider in the settings menu.\n- 🔄 **Deck Reshuffling**: The game uses a shoe with 8 decks, and the deck is reshuffled automatically when it runs out of cards.\n- 🤖 **Dealer AI**: Dealer follows standard Blackjack rules (hits until 17 or higher).\n\n## Requirements\n\n- 🐍 Python 3.11 or higher\n- 🎵 `pygame` library for sound effects\n\n## 🚀 Future Enhancements\n- 👥 Add multiplayer support for multiple players at the same table.\n- 💰 Implement betting mechanics with virtual chips.\n- 🎵 Add more sound effects for winning, losing, and other game events.\n\n## 🐛 Known Bugs\n- ✂️ Split function isn't UI/UX friendly at the moment. Second hand currently unplayable\n- ✌️ Missing features like double down\n\nEnjoy the game! 🎉\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F10daviesb%2Fblackjack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F10daviesb%2Fblackjack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F10daviesb%2Fblackjack/lists"}