TK2048/README.md

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

This game is an excuse and a testbed for the development on the Microdigital TK2000 clone I recently built for myself.

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.

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

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 ☕!

Current state

The game is playable, and the following features have been implemented:

• B/W mode
• VDP board support
• Single graphical tileset
• Simple sound effects
• Control via keyboard
• 5x5 grid, with randomized start and new tiles
• Game save/load
• Highscore saving
• Demo mode

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.

VDP support

The game supports the TK2000 VDP board configured at address C0Cx.

The card gets automatically detected and used: once the game completes the initial load, everything will be displayed on the screen connected to the VDP board, and the main screen connected to the TK2000 will be left blank.

If you want to override detection and force the use of the main screen, just keep a button pressed while the title screen image loads.

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)
• Calypsi 6502 toolchain (tested with 5.10)
• AppleCommander, "ac" command line version (tested with 1.9.0)
• 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.