https://github.com/jcoupalk/blackjackgo
Blackjack terminal game written in Go
https://github.com/jcoupalk/blackjackgo
blackjack-cli blackjack-game blackjack-simulator gambling-game game go golang terminal-game
Last synced: 9 months ago
JSON representation
Blackjack terminal game written in Go
- Host: GitHub
- URL: https://github.com/jcoupalk/blackjackgo
- Owner: JCoupalK
- License: mit
- Created: 2024-01-19T01:23:07.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-01-19T20:57:24.000Z (over 2 years ago)
- Last Synced: 2025-10-14T17:16:35.217Z (9 months ago)
- Topics: blackjack-cli, blackjack-game, blackjack-simulator, gambling-game, game, go, golang, terminal-game
- Language: Go
- Homepage:
- Size: 15.6 KB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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](#features)
- [Installation](#installation)
- [Gameplay](#gameplay)
- [Build](#build)
- [Contributing](#contributing)
- [License](#license)
## Installation
1. Download the binary with wget:
```shell
wget https://github.com/JCoupalK/blackjackgo/releases/download/1.0/blackjackgo_linux_amd64_1.0.tar.gz
```
2. Unpack it with tar
```shell
tar -xf blackjackgo_linux_amd64_1.0.tar.gz
```
3. To start the game, run:
```shell
./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](https://golang.org/dl/).
Once Go is installed, clone this repository:
```shell
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.