https://github.com/ninjaro/kcuckounter
...one flew east, one flew west, One flew over the multiple decks.
https://github.com/ninjaro/kcuckounter
blackjack card-counting card-game game hi-lo kde qt
Last synced: about 1 month ago
JSON representation
...one flew east, one flew west, One flew over the multiple decks.
- Host: GitHub
- URL: https://github.com/ninjaro/kcuckounter
- Owner: ninjaro
- License: mit
- Created: 2025-06-17T23:49:09.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-06-23T15:59:09.000Z (4 months ago)
- Last Synced: 2025-06-25T01:16:20.636Z (4 months ago)
- Topics: blackjack, card-counting, card-game, game, hi-lo, kde, qt
- Language: C++
- Homepage:
- Size: 712 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- License: license
Awesome Lists containing this project
README
# kcuckounter
## ...one flew east, one flew west,
One flew over the multiple decks.
[//]: # ([](https://github.com/YaRiabtsev/kcuckounter/releases/latest))
[//]: # ([](https://github.com/YaRiabtsev/kcuckounter/actions/workflows/tests.yml))
[//]: # ([](https://github.com/YaRiabtsev/kcuckounter/actions/workflows/html.yml))
[//]: # ([](https://codecov.io/gh/YaRiabtsev/kcuckounter))
[](https://github.com/YaRiabtsev/kcuckounter/blob/master/license)
> Just play poker in Indian Casinos and stay single and live where and how he wants to, if people would let him,
>
P.R. said — but Chief released him.
They’re out there.
Black Kings and Red Queens in suits — up before me, to be committed to the repository and get mopped up before you can memorize them.
## Brief Description
**kcuckounter** is an educational game. The project aims to
improve basic arithmetic skills and memory retention by counting cards in
different table-slots with different strategies. The user has the option to use
one of the preloaded strategies (Hi-Lo, Hi-Opt I, Hi-Opt II, Zen Count and
other) or create their own custom strategy. The game is implemented in C++ with
using Qt6, KF6, KDEGames6 and carddeck packs from kdegames-card-data-kf6.
## Gameplay
|  |  |
|---------------------------------------------------------------------|-------------------------------------------------------------|
|  | todo: |
At the beginning of the game, the user customizes the number of table-slots, and
for each table-slot, they can choose the number of standard playing card decks
and the strategy. The abstract dealer then picks up one card from one or more
table-slots (depending on the level of difficulty). The user must keep track of
the sum of the weight of the cards in each table-slot, taking into account the
weight assigned to each card in the chosen strategy.
If the next picked card is a joker, the user must answer a joker's question to
continue playing. The joker card has no weight and is rare, so answering
correctly about the current weight of the table-slot with the joker card changes
the score.
The score is based on the player's ability to answer the joker questions
correctly and is measured by the number of jokers the player has guessed
correctly out of the total number of joker questions.
The main focus of the game is to improve arithmetic skills and memory, and the
score serves as a motivational tool.
## Requirements
To build **kcuckounter** you need a C++20 toolchain, CMake and the Qt 6
stack with KDE Frameworks 6. Typical packages are:
- `cmake` and a C++ compiler (e.g. `clang++`)
- Qt 6 base and svg modules
- KDE Frameworks 6: `kcoreaddons`, `ki18n`, `kxmlgui`, `kconfigwidgets`,
`kwidgetsaddons`, `kio` and `libkdegames`
- `extra-cmake-modules`
## Setup and Installation
1. **Configure**
```bash
cmake -B build/ -DCMAKE_INSTALL_PREFIX=$HOME/kde/usr/ -DQT_MAJOR_VERSION=6
```
2. **Build**
```bash
cmake --build build/ --parallel $(nproc)
```
3. **Install**
```bash
sudo cmake --install build/
```
4. **Run**
```bash
source build/prefix.sh
kcuckounter
```
## Documentation and Contributing
For detailed documentation see the [Documentation](https://yariabtsev.github.io/kcuckounter/doc/) page.
## Docker
The provided `Dockerfile` builds **kcuckounter** inside an Arch Linux
container. After the image is created the game can be started directly:
```bash
docker build -t kcuckounter .
docker run --rm kcuckounter
```
Unit tests and coverage generation can be enabled during the build by passing
additional build arguments:
```bash
docker build -t kcuckounter --build-arg COVERAGE=ON .
```
## Security Policy
Please report any security issues using GitHub's private vulnerability reporting
or by emailing [yaroslav.riabtsev@rwth-aachen.de](mailto:yaroslav.riabtsev@rwth-aachen.de).
See the [security policy](.github/SECURITY.md) for full details.
## License
This project is open-source and available under the MIT License.