https://github.com/ifilot/cx16-kakuro
Logic puzzle game for the Commander X16
https://github.com/ifilot/cx16-kakuro
cx16 cx16-game kakuro kakuro-game retrogame
Last synced: 5 months ago
JSON representation
Logic puzzle game for the Commander X16
- Host: GitHub
- URL: https://github.com/ifilot/cx16-kakuro
- Owner: ifilot
- Created: 2024-05-28T06:39:13.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2024-09-15T20:01:45.000Z (almost 2 years ago)
- Last Synced: 2024-09-16T12:04:54.865Z (almost 2 years ago)
- Topics: cx16, cx16-game, kakuro, kakuro-game, retrogame
- Language: C
- Homepage:
- Size: 1.68 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# CX16-KAKURO
[](https://github.com/ifilot/cx16-kakuro/actions/workflows/build.yml)
[](https://www.gnu.org/licenses/gpl-3.0)
[Download latest version](https://github.com/ifilot/cx16-KAKURO/releases/latest/download/CX16-KAKURO.ZIP)
## Description
Kakuro is a logic-based number puzzle game, often described as a cross between a
crossword and Sudoku. In this game, players fill a grid with digits from 1 to 9,
with the objective of matching the sum of numbers in each row or column to a
given target. However, no number can be repeated within a single sum. Each clue
is represented as a small number in a black cell, dictating the sum of the
digits to be placed in the adjacent white cells.
For the Commander X16, Kakuro offers a nostalgic experience, blending the
puzzle's classic challenge with the retro charm of 8-bit computing. Players
navigate the grid using the mouse and inputting numbers via keyboard. The game
tests mathematical reasoning and strategic thinking, making it an engaging
pastime for puzzle enthusiasts and retro gaming fans alike. The simplistic yet
captivating design ensures that Kakuro on the Commander X16 is both a mental
workout and a tribute to vintage gaming.
## Features
* In total, **48** puzzles are implemented in the game varying between 6x6 to
8x8 board sizes.
* The program keeps track of the user progression. Different colors are used to
indicate opened and completed puzzles. The game automatically saves the result
to `PUZZLES.DAT` ensuring 'continuous play'. Note that the game state itself
is not saved.
* If the user is stuck, they can hit a toggle button which highlights all
correct numbers in green, while incorrect numbers are colored in red.
## Compilation
First, install the required dependencies
```bash
sudo apt-get install -y build-essential cc65 python3 python3-numpy python3-pilkit
```
Compilation is fairly straightforward. Go to the `src` folder and run `make`.
```bash
cd src && make
```
## Dependencies
CX16-KAKURO makes use of [zsmkit](https://github.com/mooinglemur/zsmkit) which
is an advanced music and sound effects engine for the Commander X16 and
available under a MIT License. A static copy of this library is bundled in
this repository and automatically embedded in the `.PRG` file.
## Assets
* All graphical artwork was created by me using [Pyxel
Edit](https://pyxeledit.com/). No permission is required to use this artwork
in your work, although attribution is always greatly appreciated.
* Background music "Corridors of Time" by GTR3QQ is available under a
CC-BY-SA-4.0 license and obtained from [this source](https://github.com/mooinglemur/melodius/blob/main/ROOT/ZSM/Furnace/GTR3QQ/Corridors%20of%20Time.zsm)
GTR3QQ is graciously acknowledged for producing this piece of music and offering
it under a liberal license.
## Community guidelines
* Contributions to CX16-Kakuro are always welcome and appreciated. Before doing so,
please first read the [CONTRIBUTING](CONTRIBUTING.md) guide.
* For reporting issues or problems with the software, you are kindly invited to
to open a [new issue with the bug label](https://github.com/ifilot/cx16-kakuro/issues/new?labels=bug).
* If you seek support in using CX16-Kakuro, please
[open an issue with the question](https://github.com/ifilot/cx16-kakuro/issues/new?labels=question)
label.
* If you wish to contact the developers, please send an e-mail to ivo@ivofilot.nl.
## License
Unless otherwise stated, all code in this repository is provided under the GNU
General Public License version 3.