12345678901234567890123456789012345678901234567890123456789012345678901234567890 (For an 80-character or more wide display) Titanium users PLEASE READ TITANIUM.TXT!!!!!!!!!!!! OBLIVION v1.15 A single-player 3D journey For the TI-89, TI-92+, and Voyage 200 By Malcolm Smith m@malcolm-s.net http://trgenius.cjb.net http://ti.malcolm-s.net Powered by the FAT Engine (Thomas Nussbaumer) ============================================= For help troubleshooting error messages, see the TROUBLESHOOTING section. PLEASE READ ALL OF THAT SECTION BEFORE E-MAILING ME WITH PROBLEMS! LICENSE NOTE: ============= This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. Please read the License (license.txt) for specific details on distributing Oblivion, and altering components. PURPOSE ======= Oblivion's purpose is to be a fully playable FPS for the TI-68ks. With this game, I tried to do everything that is possible with a raycasting engine, and I am pretty pleased with the result. This game is different than Wolfenstein - it has outdoor areas, and much more. I'd compare it more to Doom or Unreal, but with a raycasting engine. I hope you like this game! You should be able to get hours of gameplay out of it. If you have any praise or general comments, be sure to email me, or post in my forum on my site. Thanks. TRANSLATIONS ============ There may be translations of the Oblivion game text available. Check on my TI site (links at the top), and at: http://www.ticalc.org/pub/89/asm/games/levels/misc and look for titles beginning with Oblivon. Note that you will have to: - Run the Oblivion installer to install (see below) - On your calculator, find and unarchive oblivion\oblvtext - Send the oblvtext file from the appropriate translation. STORY ===== The year is 2144, and Earth has become polluted and has dangerously low levels of natural resources. The CES (Coalition for Earth's Survival) has deemed it necessary to find new sources for coal and oil, or even a location to colonize. With little time to spare, Earth sends you, Kevin Powers, with a team of researchers and miners, to explore the stars. One day on the ship, the crew is relaxing and making bets on sporting events going on back on Earth. Suddenly, the ship hits a small asteroid. Ironically, the ship's resources are damaged, and it begins to run low on oil and fuel. You desperately try to steer the ship to a nearby planet, but realize that a fatal crash is inevitable. Just before hitting the planetary surface, you eject from the ship. Your crew is not so lucky. You look around yourself. You are badly injured, and see no signs of civilization. You pull yourself together and look around anyway... Be on the lookout for signs of life, civilization, and resources for health and nourishment. If you have any hope of getting off this planet, or letting Earth know that it's safe to colonize, you'll need to find the planet's Central Communication and Linkup Center to establish any outside contact. According to your ship's data right before the crash, the Center isn't anywhere close by... so prepare to explore. CALC LOADING INSTRUCTIONS: ========================== Oblivion is a very large game, so it has a special way to be loaded onto the calc. 1. Send either the contents of the [89] (TI-89) or [92p_v200] (TI-92+ or Voyage 200) folders to your calculator. 2. All files should remain in MAIN. 3. Run oblvinst(). 4. Follow the instructions. Files should be extracted to a folder called "Oblivion". If you see any boxes prompting you to make a folder or garbage collect, press ENTER (Yes). If the installer tells you that there isn't enough memory, you will need to free either RAM or Flash ROM (archive memory), depending on what the error message indicates. To free RAM, see "How to Free RAM" in Troubleshooting. To free Flash ROM, see "How to free Flash ROM" in Troubleshooting. 5. Run oblivion\execoblv() and enjoy the game. You can run oblivion() directly if you are already in the OBLIVION folder. Titanium users PLEASE READ TITANIUM.TXT!!!!!!!!!!!! DEFAULT KEYS (TI-89): ===================== 2nd - Shoot Diamond - Strafe HOME - Press Button Shift - Switch Weapon alpha - Walk Faster F1 - Pause F5 - Boss (Teacher) Key F3 - Save Game F4 - Load Game DEFAULT KEYS (TI-92+): ====================== F1 - Shoot F2 - Strafe F3 - Press Button F5 - Switch Weapon F6 - Walk Faster HAND (LOCK) - Pause F8 - Boss (Teacher) Key F4 - Save Game F7 - Load Game DEFAULT KEYS (Voyage 200): ========================== HAND (LOCK) - Shoot Q - Strafe A - Press Button F1 - Switch Weapon W - Walk Faster F2 - Pause F8 - Boss (Teacher) Key F3 - Save Game F5 - Load Game CHEAT KEYS: =========== ??? - Full Health & Armor, RocketLauncher/PlasmaGun/Railgun :-) Keys can be changed in the Options menu. TROUBLESHOOTING: Read if you have any problems =================================================== Oblivion is a very large game, so almost all of the problems that you may encounter have to do with a lack of memory. Specific error messages, and how to correct them: Out of Memory-------------------------------- You need more RAM free. See "How to Free RAM." GFX File or Out of Memory-------------------- You need more RAM free. See "How to Free RAM." OR, you are missing a graphics file. Make sure oblvgfx0-4 are on your calculator. This shouldn't be a problem since installation of all files is automated. Incorrect size for data file!---------------- One of the Oblivion data files (mainly oblvtext) is not the right size. You should not see this error, but if you do, report the problem to me. Map is missing needed tiles!----------------- One of the Oblivion maps is missing a spawn or exit point. You should not see this error, but if you do, report the problem to me (including what level you were on). Map file error!------------------------------- There is a problem with OblivMap, or it is not on your calculator. You should not see this error, but if you do, report the problem to me (including what level you were on). Unknown FAT Error----------------------------- You should not see this error, but if you do, report the problem to me. Game not ExePacked---------------------------- You should not see this error, but if you do, report the problem to me. Send this FATLIB version---------------------- Make sure that you are using the version of FATLIB that came with Oblivion, and not an older version from another 3D game. Just send the version under [89] or [92p_v200] to fix this error. Locking FATengine failed---------------------- You should not see this error, but if you do, report the problem to me. FAT: Out of Memory---------------------------- You need more RAM free. See "How to Free RAM." How to Free RAM: ---------------- (1) The easiest way is to archive files (move them to Archive memory). To archive a file, open VAR-LINK (2nd -), choose the file (or more than one, using F4), then press F1 and 8. (2) If you have FlashAPPS installed, these take up RAM as well as Archive Memory (Flash ROM). You may have to remove FlashAPPS such as Statistics or Geometer's Sketchpad to gain enough free RAM. To remove a FlashAPP: open VAR-LINK (2nd -), press F7 (the key that specifies 'FlashApp'), and delete a FlashAPP by pressing Backspace next to the main name. If you want to keep your FlashAPPS and only want to "hide" them temporarily, try ExtendeD's FlashAPP hider. TI-89: http://www.ticalc.org/archives/files/fileinfo/272/27238.html TI-92+: http://www.ticalc.org/archives/files/fileinfo/272/27239.html Voyage 200: http://www.ticalc.org/archives/files/fileinfo/271/27128.html Note that the tool is a 3rd party program, and is NOT supported by me. (3) If you still need more RAM, try uninstalling TSRs and/or kernels. To uninstall a kernel or TSR, use its accompanying Uninstaller. Most TSRs use Kevin Kofler's UnInEvHk program, and most kernels (PreOS, UniOS,...) have a program named uninst(al). How to Free Flash ROM: ---------------------- Through VAR-LINK (2nd -), unarchive (F1 8) and delete (F1 1) unnecessary programs/variables/data files. To remove a FlashAPP: open VAR-LINK (2nd -), press F7 (the key that specifies 'FlashApp'), and delete a FlashAPP by pressing Backspace next to the main name. CREDITS: ========== Malcolm Smith - Graphics, Game Code, Tools, Documentation, Levels Thomas Nussbaumer - FAT Engine, Text Scroller Base, Starfield Base, FAT-Related Tools Michael Holt - Menu Interface Base, Bmp2bin tool Scott Noveck - FAT Engine Enhancements Jeff Wilcox - Corridor 92 Demo (inspiration), Help with FAT Engine Beta Testers: Thanks a ton! The game wouldn't have been playable without your help ;-) Your bug-finding help and suggestions have been very much appreciated. (#s in parentheses show which Release Candidates the testers helped to review specifically) TI89coder (RC 1-7) Digital (RC 6-7) MacIntoc (RC 5) MasterZog (RC 1) nEUrOO (RC 1) StoopidGuy (RC 1) fisch2 (RC 1) Suggestions By: (Game Specific) Michael879 MastaZog JimRandomH MrKazooti (General Programming) Lots of people on the TICT TIGCC Programming board - Thanks a bunch! (Miscellaneous) paulygon Tim101