BlackDuck-v2

The second version of the well-known gambling game Blackjack, made in Python using Pygame for the user interface.

Features

• Save File: Save file function that saves your progress when exiting the window or game
• Pygame UI: Pygame to display a window for a better UI, rather than a Command Line Interface
• PyPI: Published on PyPI for easy access and installation of the game
• Full Blackjack Action: Allows users to hit, stand, double down and split (max 1 split)
• Chip-Based Betting: Replaced simple cash betting with physical chip betting and table space.
• Chip Exchanging: Space that allows players to exchange their chips for other chips
• Two-Hand Play: Two betting spaces allow the player to start with two hands
• Statistics: Stats are tracked throughout the game and appear when the player runs out of chips

Videos

https://github.com/user-attachments/assets/88797d72-ae88-46bc-a3bf-27622c33cf81

https://github.com/user-attachments/assets/e1411064-0543-459c-b19e-7e9bbab91d31

https://github.com/user-attachments/assets/c164994e-a1fd-47c3-b6ac-8c73027726d3

https://github.com/user-attachments/assets/2b0f2c18-4612-4728-96e1-f55488b0ae66

Images

How To Install

Requirements:

• MacOS or Linux device
• Python 3.9 or later (the latest to be safe)
• Pip 22 or later (the latest to be safe)
• Pygame 2.6.0 or later (should be installed when installing the package from Pypi)

1. You'll need to have Python and pip installed.

   • You can follow this to install Python
   • You can follow this to install pip

2. In Terminal or Command Prompt, enter the command:

   pip install blackduck-v2
   

   This will install the game. This is from the Pypi package blackduck-v2

3. Once installed, you can use the commands:

   • bd2
   • blackduck-v2
   • play-bd2
   • play-blackduck-v2 (Capatalisation doesn't matter)

4. Enjoy and good luck gambling

How To Play

After running one of the entry commands (bd2, blackduck-v2, play-bd2, play-blackduck-v2) you will be presented with the pygame UI as a casino/blackjack table.

You'll see many different things:

• On the centre you'll see the 2 betting areas (space to put your chips when betting) and control buttons for: starting, hitting, standing, doubling down and splitting.
• On the bottom, you'll see the chips you have, in which you start with 5 Ones, 2 Fives and 1 Ten.
• On the top right you'll see the exchange space. This is the space you put your chips in to exchange for other denominations.

To actually play the game there are 4 steps:

1. Move the chip in to either betting space to choose the ammount to bet.
2. Press the 'bet' button to start the hand/game.
3. Use 4 of the function to play blackjack.
4. Watch as you start winning or losing blackjack games.