Metadata-Version: 2.4
Name: blackduck-v2
Version: 0.1.0
Summary: The second version of the well-known gambling game Blackjack, made in Python using Pygame for the user interface.
Author: Braeden Sy Tan
License-Expression: GPL-3.0-or-later
Project-URL: Homepage, https://github.com/DuckyBoi-XD/BlackDuck-v2
Project-URL: Issues, https://github.com/DuckyBoi-XD/BlackDuck-v2/issues
Keywords: game,gambling,pygame,blackjack,casino
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pygame>=2.6.0
Dynamic: license-file

# 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

<img alt="Title screen of the game" src="images/midgame.png" />

###

<img alt="Game screen when inputting code" src="images/lose.png">

###

<img alt="Point scoring screen" src="images/restart.png">

## 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](https://www.python.org/downloads/) to install Python
    - You can follow [this](https://pypi.org/project/pip/) to install pip

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

    ```sh
    pip install blackduck-v2
    ```

    This will install the game. This is from the Pypi package [blackduck-v2](https://pypi.org/project/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.
