diff --git a/README.md b/README.md index 1ad1aa2..87359f6 100644 --- a/README.md +++ b/README.md @@ -1,69 +1,70 @@ -# 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 - +# 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 +- 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. + +### 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. \ No newline at end of file diff --git a/pics/title.png b/pics/title.png index 1156bd5..8c2b99a 100644 Binary files a/pics/title.png and b/pics/title.png differ