6/7/03

To make this file run properly, turn on "word wrap."

Title: Kings in the Corners Solitaire
Platform: TI-83 Plus (SE)
Author: Phil Hitt
Email: hittps@yahoo.com

Disclaimer: I am not responsible for any damage that might happen to your calc. This program was written in BASIC, so it shouldn't do any serious damage. You may unprotect and edit or modify this program. But you may not re-release it.

Notes: 
This prog was tested on my Silver Edition, so it will run slower then it did when i tested it. I'm sorry if the game is slow on the original 83+. One way that the speed can be fixed is to Garbage Collect. This really helps with speed unless it has already been done recently. Another way is to Archive all data, then reset the ram. I think that more ram can help with the speed. I also may optimize to speed it up.

After releasing v1.0, I realised that there is a diffrence in the computer rules and this game's rules. The diffrence is that when you remove cards, in the computer version, you must remove all possible pairs. But in my version, you don't have to remove all of the pairs. You can leave some of the pairs in and go back to placing cards.

This program uses matrix [A], About half of the letter variables, and List LDECK. If you have these files archived on your calculator, you must delete them for the game to run.

If you have any ideas on how to improve this game besides anything already mentioned in this readme, or you want to give me some feedback, please email me. I'd like to make as many people happy as I can with this program.


The screenshots used to show this program aren't entirely real, They would be, but I dont have rom v1.12 so I can't use VTI. If anyone has the file that converts the version to v1.12 please send it to me, and I will be able to make better screenshots. (Don't send me a rom image!!! I dont want to do anything illegal. ) The pics however, are what the program will look like when the game is run. Pic1 is the main menu, and Pics2-4 are pictures of what the gameplay looks like.

------

Files included in the group:

KCSOL:
The game itself
0KC1-0KC4: (zeros = thetas)
These progs are used for graphics and are required for gameplay. (The one that draws the cards is 0KC2) :)
------
Installation: Send KCSOL.8xg to your calc. 

This game is 100% BASIC, so it may also be typed in. Do this by ungrouping KCSOL.8xg with TI Connect or similar software, and typing in each individual prog. The graphics progs must have the same names.
------

Description/Rules: I got the idea of this game from the old computer game. The object is to use all cards in the deck by putting inside a 4x4 grid. Number Cards (A-T) may go anywhere in the grid, Kings (K) may only go in the corners, Queens (Q) may only go in the left and right sides, and Jacks (J) may only go in the top and bottom sides. The card on top of the deck must always be played. It is possible to get stuck in this game. ex: You draw a king, but there are no more free king spaces. The same thing can happen with a Jack or Queen. When the 4x4 deck has been filled, cards start getting removed in pairs. If the two selected cards added together equal 10, then the cards are removed. ex: If an Ace (A) and Nine (9) are chosen, then those cards will get removed because 1+9=10. If an Ace and Eight (8) are chosen, then the cards will not get removed because 1+8=9. A ten (10) can be removed on its own by being clicked on. Face cards (J,Q,K) cannot be removed. This repeats until the user chooses to continue putting more cards into the grid. It is also possible to get stuck while removing cards. If all 16 spots are filled but nothing is removable, then the user is stuck. The cycle repeats until the user gets stuck or the game is won. 
To win, the deck must be empty, the Face cards must be in their places, and there must be nothing in the four center spots. When [Alpha] is hit, the game should say "You Win", then "Game Over".

note: The game automatically detects when the 4x4 grid is full and enters the card removing half of the game.
-----
In Game Controls:

[Arrows]	Move the cursor
[2nd]/[Enter] 	Place card/Select a card to be removed
[Alpha]		Go from the removing half to the card placing half
[Mode]		Forfeit (You must give up if you get stuck)
[Clear]		Unselect a card in the removing half
[Del]		Quickquit :) (A quicker way to forfeit)

-----

Known Bugs:
Sometimes, a graphic bug occurs every so often, they don't mess up gameplay, and aren't worth fixing completly. Most graphic bugs have been already fixed and fixing bugs will only make the game bigger. In some cases, if a graphic bug happens, repeating the bug exactly can undo the graphic glitch.
The game also may slow down over time. This is called program fatigue. This can be fixed by rephrasing certain parts of the program, but that can be very difficult to do. :-P

If any other bugs are found, email me at hittps@yahoo.com

-----

Program History:

v1.2
Added Quickquit, for if a teacher gets close...
The game now shows the version number in the main menu.
The game now restores the graph settings to what they were after playing the game using GDB3. :) I was going to put this feature in v1.0 but forgot.  :-/
v1.1	-6/5/03
Added percent chances of a king, queen, or jack being drawn next.
v1.0	-6/4/03
Initial release

More updates should be coming soon.
-----

Future Additions:
These things may be added to the game if I can get them to work properly.

-----

Win/Lose Detection?
Faster Speed/Optimization?
Convert all the writing from "ALL UPPERCASE" to uppercase and lowercase

-----

Upcoming Programs:

I am thinking of releasing another card game for the 83+ (SE). Maybe another solitaire game...

-----

Other Released Programs:
PrgmPic-	A very good picture editor. You wouldn't regret downloading this.

-----

Special Thanks:

The people who made the original Kings in the Corners for the computer
TI for making the TI-83+
All of the people who downloaded my program for downloading it

-----