The best TI-83 Tetris ported to KnightOS.

Original by Jimmy Mårdell [email protected], Sam Heald [email protected], and Patrick Davidson [email protected].

ION and Ti-83/ Version by Ahmed El-Helw [email protected]

First, install the KnightOS SDK. You will also need the new scas assembler. Sass will not work.

$ knightos init --assembler=scas
$ make
$ make run # to test
$ make package # to produce an installable package

Use make package to get a package that you can install.

If you need help with KnightOS, want to keep up with progress, chat with developers, or ask any other questions about KnightOS, you can hang out in the IRC channel: #knightos on irc.freenode.net.

To report bugs, please create a GitHub issue or contact us on IRC.

If you'd like to contribute to the project, please see the contribution guidelines.

• 21 levels (0-20). You can choose which level to start between (only start on level 0-9 though).

• 16 different level patterns!

• Hiscore table with names! The three best results are saved.

• Teacher key! If you see your techer heading your way, quickly press the teacher key to return to TI-OS, and when you start the game the next time, you'll automatically resume where you was. If you run it from a shell however, it returns to the shell instead. But that's your problem, not mine :)

• Linkplay! Play against each other and kick some butt! The link protocol is the same as in ZTetris for the 86 and Tetris for Fargo, so you could link an 82 to an 85, 86, or a 92 and play against each other!

• The scoring is almost the same from the Game Boy version. The last digit in the score isn't shown (you could think of it that way anyway) because of several reasons. Unlike the ZShell version, you also score for dropping or moving down a piece.

• You can start with trashlines. It's different from the gameboy version though, because there is no win-when-cleared-25-lines.

• In linkplay, you can choose if you want to get scrambled (as in Tetris for Windows) or unscrambled (Tetris for Gameboy) lines.

• Rotation in both direction. You can pause the game (1 player)

Choosing players:    Up/Down      - Change number of players
                     Mode         - Quit

At the option menu:  Arrowkeys    - Choose level
                     Enter/2nd    - Start level
                     S            - Toggle "2-4 lines", "1-3 lines" (LP only)
                     L            - Toggle scrambled/unscrambled lines (LP)
                     Minus        - Decrease start high
                     Plus         - Increase start high
                     Mode         - Quit game

When playing:        Left & Right - Move the piece to the left and right
                     Up & 2nd     - Rotate clockwise
                     Down         - Move the piece faster down
                     xto          - Drop key
                     Alpha        - Rotate anti-clockwise
                     Clear        - Quit game
                     Mode         - Pause
                     Del          - Teacher key. Quickly pauses the game and
                                    jumps out to the Castle.
                                    

When dropping a piece, your score will increase with dropsteps/10 (the last digit will remain in memory, although not shown). Every time you move the piece down (with the down key) you will increase the score with 0.1.

To play linkplay, first connect two TI-83's (or connect the TI-83 to a TI-82, TI-85, TI-86, or a TI-92) and choose two player mode. The level selection menu looks slightly different. Besides from choosing which level to start at (the two players can start at different levels), you can choose how many penalty lines should be sent to the other calc when clearing lines. Either you send 2-4 lines (if you get 2-4 lines) or 1-3, ie one line less than you cleared. This option can also be different on both calcs, thus allowing handicap. You can also toggle if you want to get unscrambled penalty lines or scrambled penalty lines. If choosing unscramble (defualt), the lines sent to you will only have one gap, making it much easier than getting totally scrambled lines.

Press Enter to start the game. Now the calc will go into waiting mode and wait until the other player has reached this mode. When one player enters the waiting mode, the other player MUST have started ZTetris (or be in an assembly shell) because else the game would start immediately for the first player. If you link with a TI-82 or a TI-85 or a TI-86 or a TI-92, the other calc must enter Waiting mode first.

Now the fun begins!

You play as you usually do, but when you clear 2 or more lines, the other opponent will get penalty lines depening on how many lines you cleared and the option choosed when selecting startlevel.

There is also a bar telling how high up in the playing field your opponent is (it's not visible in the beginning since the field is empty). This is good when choosing strategy.

When a player loses, or aborts the game, a "You won" message will appear on the other calc.

You can't pause or use the teacher key in two player mode, and you can neither enter the hiscore table (even though score is counted)

When you play against an 85/86 know that the 82 version runs slightly faster than those versions. Set the 85/86, one level higher than the 82 to even things out.

• Don't pull out the linkcable while playing twoplayer! The calcs may freeze a few seconds (not crash).
• The linkplay probably isn't that stable, and the calc may freeze sometimes for a short time. It is also possible that one player may "miss" some penalty lines :) See this as a feature instead hehe :)

KnightOS Version 1.2.0

• Full KnightOS port with fancy UI thanks to corelib
• Working multiplayer
• Source code published under MIT license with permission from Jimmy Mårdell
• See GitHub issue tracker for known bugs

ION Version 1.1 R3

• Fixed random bugs

ION Version 1.1 R2 Released by Ahmed El-Helw again :)

• Fixed the link routines, thanks Dan! [[email protected], http://tcpa.calc.org]

ION Version 1.1 Released by Sam Heald

• Fixed the speed (exactly like 82,86 versions)
• Fixed Blinking text bug (no more black line)
• Changed pause screen to shut down after ~1 minute (battery saver)
• Fixed a few crashing bugs (not Ahmed's fault, TI changed the inputs and outputs of a few ROM calls)
• Size: 3341 bytes

83 Version 1.0 R4

• Fixed the Mode bug
• ION 1.1 is out, should fix screen problems
• 2 player.. not working yet... if you can fix it, go for it but don't release it without talking to me first.

83 Version 1.0 R3

• Fixed a bug in the pause screen
• If the screen resizes, it's a problem with Joe's copy routine.. wait for next ION version.

83 Version 1.0 R2

• Fixed 1 player mode
• Screen may resize in midgame, this is because of Joe's copy routine [next verion oF ION]
• Slowed the game down a bit
• Let me know if there are any more bugs with this...

83 Version 1.0

• Only 1 Player Works [2 Player Mode Displays Waiting...]
• May crash due to the copy routine [wait till next version of ION]

Special thanks to... Pascal Bouron - great link routines! Dan E - Fixing the 83 ilnk rotuines Martin Hock - example source on how to use those link routines CalcEm Author - His emulator was a huge help! Ahmed El-Helw - beta testing and helped with backgrounds Joe Wingbermule - helped with backgrounds Mark May (OBD) - beta testing and trying to help Dines Christy Justesen - Trying to help Derrick Ward - beta testing, trying to help when possible, and maintaining our page. Bryan Rabeler & Kouri Rosenberg - For repeatedly crashing their calcs for good of Ztetris. And the rest of the beta testers... ....and most of all Patrick Davidson - For teaching me everything I know about asm, and solving the major bugs that I(Sam) could not.

Ti-83 Thanks... Florent Dhordain - the link routines! Joe Wingerbermuhle - the faster graph buffer copy [and fixing it!] Djpupon, Dustin Graham, and BlackBelt - for reporting the bugs My Beta Testers - for suggestions.

The best way is to send an email to [email protected].

Visit my webpage at www.cswnet.com/~ddward/index.html for the latest info.

  WWW - http://www.calweb.com/~kwdavids/patrick/
        http://www.toptown.com/hp/ariwsi/
EMail - [email protected]
        [email protected]
        [email protected]

http://ahmed.ticalc.org [email protected]

The easiest way is to send an email to [email protected], but you can also find me on IRC, #calc-ti at EFnet with the nick Yarin. I'm usually there about 11:00 pm - 02:00 am CET (5:00-8:00 EST). IRC: Yarin Email: mailto:[email protected] Homepage: http://www.acc.umu.se/~yarin/

//Ahmed El-Helw <[email protected] / http://ahmed.ticalc.org> //Sam Heald <[email protected] / http://void.calc.org> //Jimmy M�rdell <[email protected] / http://www.acc.umu.se/~yarin> //Patrick Davidson [email protected]