Skip to content

1.1.0

Choose a tag to compare

@Porzeraklon Porzeraklon released this 30 May 01:49
· 11 commits to main since this release

🃏 BlackJack CLI

BlackJack CLI is a lightweight, terminal-based implementation of the classic Blackjack card game written in C#. It features a human player vs dealer, optional card counting bot, and full game logic including split, double down, and insurance.

🔧 1.1.0 Changes

  1. Hi-Lo counter enabled by default.
    To disable it, run the program with the --count flag:
--counter

If running source code:

dotnet run --counter

If using the compiled binary:

dotnet run --counter
  1. Hand value sums enabled by default.
    To disable it, run the program with the --sums flag:
--sums

If running source code:

dotnet run --sums

If using the compiled binary:

dotnet run --sums
  1. If you want to turn off both of type run program with both flags
    If running source code:
dotnet run --count --sums

If using the compiled binary:

dotnet run --count --sums

🎯 Features

  • Play classic Blackjack in your terminal (CLI)
  • Support for doubling, splitting, and insurance
  • Dealer AI and full player decision handling
  • Optimal for card-counting (counter enabled by default)
  • Cross-platform: Windows, Linux, macOS
  • Self-contained builds (no .NET installation required)

⌨️ Controls

You can type the full command or just the first letter:

  • Hit → h
  • Stand → s
  • Double Down → dd

To exit the game: Ctrl+C

🔽 Downloads (Self-contained builds)

To download select file with your OS ending with .zip or .tar.xz

To run, unpack the archive and run the executable inside or type

/blackjack

in your terminal.

🛠️ Build Instructions (for devs)

Requires .NET SDK 9.0 or later.

git clone https://github.com/porzeraklon/blackjack.git
cd blackjack

Then build for your target OS:

  • 🪟 Windows x64

    dotnet publish -c Release -r win-x64 --self-contained true /p:PublishTrimmed=true
  • 🐧 Linux x64

    dotnet publish -c Release -r linux-x64 --self-contained true /p:PublishTrimmed=true
  • 🍎 macOS x64

    dotnet publish -c Release -r osx-x64 --self-contained true /p:PublishTrimmed=true

🙋 About

This project was created as a clean, educational example of implementing game logic in a cross-platform CLI environment using .NET.
Contributions and forks are welcome.