X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=keyboards%2Fclueboard_66%2Fkeymaps%2Ftetris%2Freadme.md;fp=keyboards%2Fclueboard_66%2Fkeymaps%2Ftetris%2Freadme.md;h=20e97fb19f5bb69ef7875933bc937307dcf72b77;hb=5fd68266f5d90b2c7045f44f678d71b782907752;hp=0000000000000000000000000000000000000000;hpb=b736f25e85171fceb06f01cf45a45f84dd0a4911;p=qmk_firmware.git

diff --git a/keyboards/clueboard_66/keymaps/tetris/readme.md b/keyboards/clueboard_66/keymaps/tetris/readme.md
new file mode 100644
index 000000000..20e97fb19
--- /dev/null
+++ b/keyboards/clueboard_66/keymaps/tetris/readme.md
@@ -0,0 +1,33 @@
+Default layout but with a tetris game
+=====================================
+Tetris works by outputting key-presses to make ascii-art in a regular text editor.
+It reads key presses to rotate and move the bricks like a regular tetris game.
+
+Example
+=======
+![tetris](https://raw.githubusercontent.com/danamlund/meckb_tetris/master/tetris.gif)
+
+Usage
+=====
+1) Open a default text editor
+2) Press the tetris button (Fn + t)
+3) Play tetris
+
+It makes ascii-art by sending keycodes: left, right, up, down, qwerty characters, and numbers.
+
+Problems
+========
+Drawing ascii-art is too slow to make a pleasant playing experience.
+While drawing ascii-art, the keyboard does not record key-presses, so its pretty unresponsive.
+
+Adds 5000 bytes to the hex file.
+
+Implement in other keyboards
+============================
+ - Copy-paste the files tetris_text.c and tetrix_text.h to your keymap folder.
+ - Add/update your-keyboard/your-keymap/Makefile to include ``SRC = tetris_text.c``
+ - Copy-paste the tetris-related code from this keymap.c to yours.
+ - Set a key to trigger F(1) to start tetris mode.
+ - Its also a good idea to set a key to stop tetris, here its escape.
+
+You can find a simple tetris keyboard definition at <https://github.com/danamlund/meckb_tetris/>