TK2048/README.md
2025-08-30 15:02:50 +02:00

69 lines
No EOL
2.9 KiB
Markdown

# TK2048
## DISCLAIMER
Any use of this project is **under your own responsibility**.
By using this project You will agree that I cannot be held responsible if it will destroy any of your devices, damage your computer, burn down your house or whatever.
## Introduction
![TK2048 V2.0 title screen](pics/title.png)
This game is an excuse and a testbed for the development on the Microdigital TK2000 clone [I recently built for myself](https://github.com/hkzlab/TK2000_Build_Notes).
My primary objective with this game is building something where I can add support for all my expansion boards (well, at least where it makes a sliver of sense) so I can test and PoC them, beside,
I want to experiment with the [Calypsi toolchain](https://www.calypsi.cc/).
I decided for a port of 2048, the now-classic tile sliding game, as it provided several advantages as a first time/playground project:
- Doesn't need complex graphics hardware or advanced artist skills
- It can be drawn in B/W with static graphics, but animations and colors can be added in the future
- Sound is not needed either, but can be added for simple events like a tile slide or a button press
- The game logic is pretty simple
- Not CPU or memory intensive
- Can be expanded with support for additional hardware (sound cards, video cards, timers) if so desired, but it's not necessary
- Floppy drive can be potentially used not only to load the game, but also for saving the high score
![TK2048 V1.0 main game shown on a green phosphor CRT](pics/screenshot.jpg)
### Support
If you wish to support me in building new hardware and software for old machines, [throw a few euros in my direction via Ko-Fi](https://ko-fi.com/hkzlab) ☕!
### Current state
The game is playable, and the following features have been implemented:
- B/W mode
- Single graphical tileset
- Crude sound
- Control via keyboard
- 5x5 grid, with randomized start and new tiles
- Game save/load
- Highscore saving
## How to play
- You can move the tiles using the cursor keys
- `CTRL-R` during the game will clear your score and restart
- `CTRL-S` during the game will save the game on floppy and let you continue
- `CTRL-L` during the game will load the previous save from floppy and let you continue from there
The game ends once you reach a tile with a value of 2048.
### Floppy version
Just put your floppy in the first drive and power on the TK2000. It will autoboot.
## How to build
You need the following:
- GNU Make (I used the one provides by [MSYS2](https://www.msys2.org/))
- [Calypsi 6502 toolchain](https://www.calypsi.cc/) (tested with 5.10)
- [AppleCommander](https://github.com/AppleCommander/AppleCommander), "ac" command line version (tested with 1.9.0)
- [dsk2woz](https://github.com/TomHarte/dsk2woz)
## The future
I plan to add (optional) support for several expansion boards I'm working on, starting with a VDP board sporting a TMS9918A graphic processor.