RayGin! REGISTERED v. 1.00 __________________________________________________ RayGin's REAL-TIME 3D ray casting engine stretches the performance envelope of the PalmPilot. Running at TWENTY frames per second, RayGin allows heart-pounding gameplay without sacrificing full first person immersion with limp two dimensional or static graphics! __________________________________________________ Register RayGin! ---------------- RayGin is commercial software. If you are playing it, you must have paid for it. Besides giving you that warm fuzzy feeling, paying for RayGin gives me the incentive to continue creating bleeding-edge, envelope-stretching, heart-pumping games for the PalmPilot! - Thirteen Heart-Pumping Levels! - Three Weapons! - Three Enemies! - And of course The Boss: The most vitriolic bastard you'll meet all day! Order RayGin Online: http://www2.viaweb.com/pilotgearsw/steveminns.html Order by Phone: 817.640.6558 Order by FAX: 817.640.6614 __________________________________________________ Installation: ------------- Be sure to delete any previous version of RayGin before installing version 1.0! __________________________________________________ In this readme: 1) How to play RayGin! 2) Software License 3) Release History\Known Bugs 4) How to reset the Pilot __________________________________________________ If you have any questions, bug reports or comments about RayGin feel free to send me some email at minns@interlog.com RayGin is ©1998-1999, Steve Minns. All rights reserved. ================================================== 1) How to play RayGin! The player is controlled with the six keys at the bottom of the Pilot. The two keys on the left turn the player left and right(b), and the two keys in the middle(a) move the player forward and backward. The two keys on the right are for firing(d) and changing weapons(c). You can also toggle the title screen by tapping the display. Pick up items by running over them. There are currently six different items(f) you can pick up. If it doesn't move, pick it up. If it moves, kill it. There are three different enemies(e), each with different strengths and weaknesses, plus the Boss of course. Kill them all. Enemies can carry any of the objects or weapons, so if you can't find that key, you may just have to kill that huge, mean, guard that you have been avoiding in order to get it. Yes, the bad guys are smart enough to open doors. Miscellaneous Items: -------------------- - Health - Ammunition - Rage - Keys Weapons: -------- - Pistol - Rifle - Chaingun Enemies: -------- - Peon: Not too bright. Easy to kill. - Sprint: Fast. Deadly. Emaciated and hard to shoot. - Guard: Big. Mean. Slow and fat. Easy to shoot, but hard to kill. - The Boss: The most vitriolic bastard you'll meet all day. The gauges on the right show how much ammunition(h), health(i) and rage(j) that you currently have. The display on the left shows which weapons(a) and special items(b) you have picked up. You start the game with only a pistol. The player's face(m) at the bottom of the screen shows when the player has been shot(g), as well as his general rage level. Search each level for the elevator(n) to get to the next level. Some doors are locked, and you will need to find a key before you can open the door. The map(k) in the bottom right hand corner tracks your progress in real time. Picking up a weapon increases the amount of ammunition that you can carry, as well as the value of each box of bullets picked up. The player also sucks the life force out of the first guard killed, doubling the player's health, as well as the value of any health picked up. These multipliers(c) are shown beside the current weapon(l). Rage: ----- Each time you kill something, your rage level gets a little boost, but returns to normal with time. Shoot enough enemies in quick enough succession and your rage level will peak, and the player will go berserk. This state lasts for several seconds, during which time the player is invincible. You can also become enraged by picking up rage (a diamond shaped item). This will immediately make the player go berserk. Returning to a Completed Level: ------------------------------- Once you have completed a level, you can go back and redo the previous level(f), or go forward to any previously completed level(d) by tapping the level controls on the display. You can also restart the current level(e), or restart the entire game(g). Enjoy! ================================================== 2) Software License RayGin v.1.00 License Agreement General Notes: -------------- - RayGin is commercial software. If you are playing it, you must have paid for it. Besides giving you that warm fuzzy feeling, paying for RayGin gives me the incentive to continue creating bleeding-edge, envelope-stretching, heart-pumping games for the PalmPilot! - While every attempt has been made to clear up any bugs, it is still possible that RayGin may contain bugs which may cause incorrect functionality either in RayGin or in the System software. You should understand that you are proceeding at your own risk. Backup your Pilot before running RayGin. - Over all, enjoy! And visit the RayGin website often for the latest versions and up-to-date information! Legal Information: ------------------ RAYGIN ("THE SOFTWARE") IS PROVIDED 'AS IS'. STEVE MINNS ("THE AUTHOR") MAKES NO WARRANTIES AS TO PERFORMANCE, MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR ANY OTHER WARRANTIES WHETHER EXPRESSED OR IMPLIED. NO ORAL OR WRITTEN COMMUNICATION FROM OR INFORMATION PROVIDED BY THE AUTHOR SHALL CREATE A WARRANTY. USE THE SOFTWARE AT YOUR OWN RISK. BEFORE YOU USE THE SOFTWARE, CAREFULLY READ THE TERMS AND CONDITIONS OF THIS AGREEMENT. BY USING THE SOFTWARE, YOU ARE CONSENTING TO BE BOUND BY AND ARE BECOMING A PARTY TO THIS AGREEMENT. IF YOU DO NOT AGREE TO ANY OR ALL OF THE TERMS OF THIS AGREEMENT, DO NOT USE THE SOFTWARE. UNDER NO CIRCUMSTANCES SHALL THE AUTHOR BE LIABLE FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES RESULTING FROM THE USE, MISUSE, OR INABILITY TO USE THE SOFTWARE, EVEN IF THE AUTHOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. THE AUTHOR GRANTS TO YOU A NON-EXCLUSIVE, NON-TRANSFERABLE, NON-SUBLICENSABLE, LICENSE TO USE THIS VERSION OF THE SOFTWARE, IN BINARY EXECUTABLE FORM. YOU MAY USE THE SOFTWARE ON A SINGLE PLATFORM ONLY. IF YOU WANT TO USE THE SOFTWARE ON MORE THAN ONE PLATFORM AT A TIME, YOU MUST OBTAIN SEPARATE LICENSES FOR EACH PLATFORM FROM THE AUTHOR. TITLE, OWNERSHIP RIGHTS, AND INTELLECTUAL PROPERTY RIGHTS IN AND TO THE SOFTWARE SHALL REMAIN WITH THE AUTHOR. THIS LICENSE IS NOT A SALE OF THE SOFTWARE OR ANY COPY OF THE SOFTWARE. THIS LICENSE DOES NOT CONVEY TO YOU AN INTEREST IN OR TO THE SOFTWARE, BUT ONLY A LIMITED RIGHT OF USE, REVOCABLE IN ACCORDANCE WITH THE TERMS OF THIS AGREEMENT. YOU AGREE TO ABIDE BY THE COPYRIGHT LAW AND ALL OTHER APPLICABLE LAWS OF CANADA AND THE UNITED STATES, INCLUDING, BUT NOT LIMITED TO, EXPORT CONTROL LAWS. YOU MAY NOT MAKE ANY COPIES OF ALL OR ANY PART OF THE SOFTWARE, EXCEPT FOR ARCHIVAL COPIES AS PERMITTED BY THE CANADIAN AND UNITED STATES COPYRIGHT ACTS. ANY ARCHIVAL COPY MUST CONTAIN ALL OF THE ORIGINAL SOFTWARE'S PROPRIETARY NOTICES. YOU ACKNOWLEDGE THAT THE SOFTWARE IN SOURCE CODE FORM REMAINS A CONFIDENTIAL TRADE SECRET OF THE AUTHOR AND THEREFORE YOU AGREE NOT TO MODIFY THE SOFTWARE OR ATTEMPT TO DECIPHER, DECOMPILE, DISASSEMBLE OR REVERSE ENGINEER THE SOFTWARE (EXCEPT TO THE EXTENT APPLICABLE LAWS SPECIFICALLY PROHIBIT SUCH RESTRICTION), OR INCORPORATE IN WHOLE OR IN PART IN ANY OTHER PRODUCT OR CREATE DERIVATIVE WORKS BASED ON ALL OR ANY PART OF THE SOFTWARE. YOU MAY NOT REMOVE ANY COPYRIGHT, TRADEMARK, PROPRIETARY RIGHTS, DISCLAIMER OR WARNING NOTICE INCLUDED ON OR EMBEDDED IN ANY PART OF THE SOFTWARE; AND YOU MAY NOT SELL, LICENSE, SUBLICENSE, RENT OR OTHERWISE TRANSFER THE SOFTWARE. THE AUTHOR RESERVES THE RIGHT AT ANY TIME TO ALTER PRICES, FEATURES, SPECIFICATIONS, CAPABILITIES, FUNCTIONS, LICENSING TERMS, RELEASE DATES, GENERAL AVAILABILITY OR OTHER CHARACTERISTICS OF THE SOFTWARE. THESE EXCLUSIONS AND LIMITATIONS MAY NOT APPLY IN ALL JURISDICTIONS. YOU MAY HAVE ADDITIONAL RIGHTS AND SOME OF THESE LIMITATIONS MAY NOT APPLY TO YOU. RayGin is ©1998-1999, Steve Minns. All rights reserved. ================================================== 3) Release History\Known Bugs Release History: ---------------- 99/04/09 1.00 - Final Release! 99/03/30 0.92 alpha - On completion, reset initial stats (just pistol, no keys etc.) - Crash on exit to apps, launch memopad (with hard key) - Boss Sprite 99/03/29 0.91 alpha - Can dodge bullets - Can go back to previously completed levels - Fixed: level 3 final room all peons are carrying keys!! (There should be 2 keys) - Fixed: level 4 now has too much health after the first sprite - still (particularly in bottom left corner) 99/03/23 0.85 alpha - Level 3: only two peons carrying keys - Rage decay at the perfect level 99/03/18 0.84 alpha - Level 6: no longer allowed to keep unused key - Level 10 dialog fixed - only get x2 health from guard: never x4 99/03/17 0.83 alpha - Need health multiplier. Multiple Guards and higher levels are impossible to beat without it. - Allow the player to go back to previously completed levels, and restart game. 99/03/10 0.78 alpha - Fixed automatic selection of new weapon - Fixed display of multipliers - Make rage work, expecially when killing enemies - Allow static sprites to stay awake longer to optimize case where they're too far away to actually be visible - Fixed: Face on splash and level screen too fast - Fixed: Level 4: big room sucks. - Fixed: Level 6 does not end! (Finish it) 99/03/07 0.76 alpha - Removed DrawFPS - Picking up a weapon DOUBLES the amount of ammo that you can carry, as well as the value of bullets picked up. (Rifle = x2, Chaingun = x4) ...Health too? Also maxes ammo. - Change splash screen to show where to buy RayGin - Display 'Congratulations!' text after completing the last level. - Fixed: Prevent key click when moving player - Fixed level 5 - When picking up a weapon, automatically select the new weapon - Created release package: readme.htm: - Fixed: pressing the 'Apps' button twice sends game into weird state running 'under' the apps form. 99/03/01 0.69 alpha - ALL actors can now fire - Fixed bug: some actors disappear when falling asleep - Added a transition screen when changing levels/dying 99/02/25 0.66 alpha - Enemies can now fire back! Implemented more AI. - Enemies cause less damage per attack - Added Visual cues for: actor aiming/firing 99/02/16 0.61 alpha - Fixed wall draw problem when very close to corner of wall - Fixed spore on the screen when an actor is killed - Fixed dynamic sprites falling asleep too soon/disappearing/never appearing (you can now get the rifle on level 3...) - Increased number of active sprites - Disabled sound completely for now 99/02/11 0.59 alpha - Reports the version on the splash screen (also changed the version format) - Preserve last saved position between games - Made level 2 easier (Peons are easier to kill) - Added sound infrastructure - Release as .zip so that it doesn't confuse browsers Note: On the PalmPilot Professional with OS 3 upgrade: There have been a few reports of version 0.59 crashing, and causing a "boot loop" (where you keep seeing the "Welcome to PalmPilot" message over and over again). You should be able to fix this with a Warm Reset which will not delete all of the data on your Pilot, like a hard reset will: Press the reset button while holding the UP button. Thanks to Rob Gallop and Rick Pasetto for reporting this bug! 99/02/03 alpha - Level 2 is easier, but possibly still too hard! - 'Fine' control. Particularly for aiming. Accelerate based on how long you hold down a key. - Picking up rage works 99/02/01 alpha - Added Face animation for pain and anger 99/01/28 alpha - Fixed nasty bug: Killing an actor in a doorway does bad things: --- turns dropped objects into other objects, teleport pads etc. --- can cause RayGin to crash 99/01/27 alpha - Locked doors are now locked - Level 2 has sprites - Available weapons/keys windows clear when the player dies and returns to beginning of the level 99/01/25 alpha - Fixed the Personal 512k bug! Many thanks to Graham Whaley, Matthias Steppuhn and Guido Berhörster for helping to find the fix and to James Davis, Tim Escobedo, Guido Berhörster, Chris Wilkinson and Roger Brownlie for finding this bug! - Added Double buffer to remove wall flicker - Peons are a bit harder to kill - Moved some memory around: ds much smaller now 99/01/21 alpha - Elevators now actually move the player between levels - First three maps done - Saves preferences at the beginning of each level 99/01/18 alpha - Just getting back into it - Fixed Invalid Handle caused by large data seg - Added Map Load infrastructure 98/09/11 alpha - First external alpha release Known Bugs: ----------- There are no known bugs in this release. ================================================== 4) How to reset the Pilot There are several different ways to reset the Pilot. Some are more destructive than others. If RayGin caused the crash, you should delete it immediately after resetting your Pilot WITHOUT running it first. (Running it may prevent you from deleting it). Soft Reset: ----------- Use a paperclip to press the reset button, located in the small hole on the back of the Pilot. Warm Reset: ----------- Press the reset button while holding the UP button. Performing a warm reset bypasses any system "extensions" that you have installed. This will sometimes also resolve issues with errant programs that cause the "boot loop" where you keep seeing the "Welcome to PalmPilot" message over and over again. Hard Reset: ----------- Press the reset button while holding the green power button. You will be prompted for verification. IMPORTANT NOTE: This WILL delete everything installed on your PalmPilot. You should use this reset only as a last resort. ================================================== RayGin is ©1998-1999, Steve Minns. All rights reserved.