jcoupalk / blackjackgo

Blackjack terminal game written in Go

BlackjackGo

Welcome to BlackjackGo! This project is a simple yet exciting implementation of the classic Blackjack card game, written in Go. It features a text-based user interface and an intuitive gameplay experience.

Features

• Text-based Blackjack game playable in the terminal.
• Simple and intuitive user interface with color styling.
• Automatic handling of game rules including scoring, hitting, standing, and dealing.
• Soft hand score detection and display.
• Dealer play logic according to standard Blackjack rules.

Table of Contents

• Features
• Installation
• Gameplay
• Build
• Contributing
• License

Installation

1. Download the binary with wget:

   wget https://github.com/JCoupalK/blackjackgo/releases/download/1.0/blackjackgo_linux_amd64_1.0.tar.gz

2. Unpack it with tar

   tar -xf blackjackgo_linux_amd64_1.0.tar.gz

3. To start the game, run:

   ./blackjackgo

You'll be presented with the game interface in your terminal. Follow the on-screen instructions to play.

Gameplay

• Press 'H' to hit (draw a new card).
• Press 'S' to stand (end your turn).
• Press 'R' to restart the game after it ends.
• Press 'Q' at any time to quit.

The game follows standard Blackjack rules. Your goal is to beat the dealer's hand without going over 21.

Build

To build BlackjackGo, you need to have Go installed on your machine. If you don't have Go installed, you can download it from the official Go website.

Once Go is installed, clone this repository:

git clone https://github.com/JCoupalK/blackjackgo
cd blackjackgo
go build .

Contributing

Contributions to BlackjackGo are welcome! Feel free to fork the repository and submit pull requests.

License

This project is licensed under the MIT License - see the LICENSE file for details.