home *** CD-ROM | disk | FTP | other *** search
/ Shareware 1 2 the Maxx / sw_1.zip / sw_1 / GAMES / GSLITE.ZIP / GSLITE.ARC / INSTRUCT.DOC < prev    next >
Text File  |  1992-10-15  |  34KB  |  680 lines

  1.                          GAMESCAPE LITE ver C.1
  2.                     Copyright 1988-92 Dennis Drew. 
  3.                      Copyright strictly enforced.
  4.  
  5.               NOW FEATURING INSTANT ON-LINE REGISTRATION!
  6.  
  7. Documentation file.  Please read this.  Use PGUP/PGDN to move through 
  8. the file.  When finished, press ESC to continue with the GSCAPE program.
  9. To print out this file, press P and then use PGDN to move through the 
  10. entire file.  It will be printed as you scroll.
  11.  
  12.                            REGISTRATION FORM
  13.                         (please print clearly)
  14.  
  15. NAME: __________________________________________________________
  16.  
  17. COMPANY NAME: __________________________________________________
  18.  
  19. ADDRESS: _______________________________________________________
  20.  
  21. CITY: ______________________ STATE: _______ ZIP: _______________
  22.  
  23. PHONE: (_____)_______-_______  PURCHASE DATE: _____/_____/______
  24.  
  25. I acquired this program from:___________________________________
  26.  
  27.               On a scale of 1-10, I rate this program a: 
  28.  
  29.                     1  2  3  4  5  6  7  8  9   10
  30.  
  31.  
  32.  
  33. I acknowledge that I have read and agree to the licensing agreement. I 
  34. request to have my name added to your mailing list for future updates 
  35. and information.  
  36.  
  37.  
  38. ___________________________________________ ___________________
  39. signed                                      date
  40.  
  41.             Please send:  ___ 5.25" disks    ___ 3.5" disks
  42.  
  43.                enclose your check (we pay shipping) for:
  44.      $35 for Gamescape LITE (economy version, character graphics)
  45.  $95 for Gamescape GRAPHIC (hi-res color graphics, advanced commands)
  46.  
  47.               Dennis Drew  PO Box 101   Joplin, MO  64802
  48.                        VISA/MASTERCARD accepted
  49.  
  50. Please pay by international money order or a check drawn on a U.S. 
  51. bank.  Due to difficulty in processing, no foreign checks, please. 
  52.  
  53.                          ALL USERS!!! IMPORTANT!!!
  54.     The following two lines (with the minimum configurations shown) must 
  55. be in your CONFIG.SYS file on your DOS BOOT disk.  
  56.  
  57.                             FILES=20
  58.                             BUFFERS=20
  59.  
  60.     If you do not have a CONFIG.SYS file on your DOS BOOT disk, or if it 
  61. does not contain at least the above specs, then you must update your 
  62. CONFIG.SYS file so that it does.   To do this, switch to your main 
  63. boot drive (usually either A: or C:) and then enter the following 
  64. lines EXACTLY:
  65.  
  66.     COPY CONFIG.SYS + CON CONFIG.SYS (press enter)
  67.     FILES=20 (press enter)
  68.     BUFFERS=20 (press enter)
  69.     (press F6 key)
  70.     (press ENTER)
  71.     (reboot your computer)
  72.  
  73.     If you are unsure about how to do this, contact your computer dealer.  
  74. This computer file is a STANDARD requirement of most modern computer 
  75. programs and should be present on every computer system.   
  76.  
  77.                           WHAT IS GAMESCAPE?
  78.     GAMESCAPE is the fantastic program that allows you to design and 
  79. distribute your own adventure games.  GAMESCAPE is a powerful 
  80. "adventure engine" that allows you to describe locations and rooms, 
  81. objects, recognizable words, messages, and occurrences that happen 
  82. within the game.  You can also include sound, music, and any of the 
  83. standard IBM special graphics characters (terrific for mapping).   
  84. Registered users of GAMESCAPE GRAPHIC can create high-resolution color 
  85. graphics to go with their games (Gamescape LITE allows character 
  86. graphics)! 
  87.     Gamescape encodes information so your game secrets cannot be 
  88. easily deciphered by end users.  It provides you the ability to design 
  89. incredibly detailed adventure games with far greater ease than using a 
  90. raw programming langauge.   Once the game is finished, registered 
  91. users are allowed to distribute the games with NO ROYALTY FEE-- the 
  92. initial registration is all that's required.  
  93.  
  94.  
  95.      IMPORTANT NOTICE ON NON-REGISTERED GAME DISTRIBUTION LICENSE:
  96.     You may distribute your GAMESCAPE adventures without being a 
  97. registered user, under the following license requirements: 
  98.     1. You may not charge for your game in any form, not even a 
  99. diskette duplication fee.  It is illegal to commercially distribute a 
  100. game without express, written permission from the author.  What this 
  101. means in short is that you may give copies to your friends, send them 
  102. to penpals, and enter them in GAMESCAPE contests, but you may not 
  103. market them in any fashion, regardless of profit or non-profit motive, 
  104. without express written permission from the author.  You may not 
  105. distribute your game through shareware channels or across BBSs.
  106.     2. You may not present the game as registered.  You may not use a 
  107. registered version of GAMESCAPE to produce your game (you must use the 
  108. shareware version).
  109.     3. The SCAPERUN.EXE program must be included (of course, or the 
  110. game won't work). 
  111.     Non-compliance with any of these requirements will, by terms of 
  112. our license, void your ownership of your work (in other words, games 
  113. distributed against our license requirements become our property).  
  114. This is not so much for our benefit as it is to protect those who DO 
  115. pay for registration; they deserve the rewards of their payment.
  116.  
  117.                    SPECIAL REGISTERED USER NOTICE!!!
  118.     If you're a registered user, CONGRATULATIONS!  You can just about 
  119. do what you want.  That's what you paid for.  You can charge bucks for 
  120. your work.  You can distribute through shareware.  You don't have to 
  121. pay royalties of any kind.  You can give your games away or sell them, 
  122. and pursue any marketing method you wish.  You are fully licensed.  
  123. About the only thing we require is standard, forseeable stuff, such 
  124. as: 
  125.     1. You must include the SCAPERUN.EXE program when you distribute 
  126. your game (naturally; it's the run-time module).
  127.     2. You may not alter or misrepresent the GAMESCAPE system in any 
  128. manner, or present your games in a manner contrary or harmful to our 
  129. concepts and purposes of GAMESCAPE.  That's all; pretty simple stuff. 
  130.  
  131.     The bottom line:  if you're an unregistered user, feel free to 
  132. give your games to friends and to enter GAMESCAPE contests.  Enjoy 
  133. yourself; we want you to have fun using this excellent program.  But 
  134. remember that there's a lot more available to you if you register! 
  135.  
  136.  
  137.                    INSTRUCTIONS FOR USING GAMESCAPE
  138.     Gamescape is an adventure game development system.  As such it is 
  139. a "programming environment" that provides great power and time-saving 
  140. methods of producing adventure games.
  141.     To see how Gamescape works, enter the following command after 
  142. installation:      GSCAPE SAMPLE
  143.  
  144.     This is the game compiler that will turn the SAMPLE.ADV file into 
  145. an adventure game.  Once the game is compiled, you may then play it by 
  146. exiting Gamescape and entering the command:     SCAPERUN SAMPLE
  147.  
  148.     This will allow you to play the sample adventure game.
  149.  
  150.     Included with this program is GSEDIT.EXE, the powerful Gamescape 
  151. editor.  By examining the TEST.ADV, EASY.ADV and SAMPLE.ADV files you 
  152. may get an idea of how the Gamescape development system works.
  153.  
  154.                        DEVELOPING YOUR OWN GAMES
  155.     The registered version of Gamescape comes with a fully detailed 
  156. instruction manual that lists all of the Gamescape commands and their 
  157. functions.  It also gives you a lot of information about special 
  158. functions of Gamescape not available in the shareware version.
  159.     At this time however, you may begin developing simple adventure 
  160. games by means of the Gamescape Editor, a brand new part of Gamescape 
  161. that helps you in writing correct Gamescape code.  To begin using the 
  162. editor, enter the command:     GSEDIT
  163.  
  164.     We've included a very simple adventure game called EASY that is 
  165. already configured with GSEDIT.  Feel free to examine this file and 
  166. the way it is set up by entering:  GSEDIT EASY
  167.  
  168. ======================================================================
  169.  
  170.                             GAMESCAPE  (TM)
  171. This shortened manual is designed to give you an idea of the 
  172. possibilities of GameScape.  The full manual along with extended 
  173. program commands is included with the registered version. 
  174.  
  175.  
  176.  
  177. Copyright 1991 Dennis Drew.  Copyright strictly enforced. Gamescape TM 
  178. by Dennis Drew.  All rights reserved.  This manual is copyrighted.  
  179. Copying of this manual is expressly forbidden and punishable under 
  180. Federal and Civil law.  Feel free to copy and circulate the SHAREWARE 
  181. version of this program, but NOT THE MANUAL or the REGISTERED DISK ! 
  182.  
  183.                        Produced by Drew Software 
  184.                     PO Box 101   Joplin, MO  64802  
  185.                              (417)781-4248 
  186.  
  187.                                Gamescape
  188.  
  189.     Imagine writing your own adventure games!  Have your family play 
  190. them, give them to your friends, hand them out at computer clubs, or 
  191. even sell them and make a few bucks! 
  192.     Gamescape is the incredible adventure game design system that lets 
  193. you do all this.  Using simple commands which are thoroughly explained 
  194. by an easy-to-understand manual, you can do just about anything you 
  195. would want to do in adventure gaming: 
  196.     * Define rooms, objects, monsters, and actions 
  197.     * Draw maps using IBM character graphics 
  198.     * Play music, sound alarms, beep warnings 
  199.     * NEW !  High resolution color graphics ability !  
  200.  
  201.     Gamescape also allows you to do things that no other adventure 
  202. system allows.  Your games can be of unlimited size and cover multiple 
  203. disks!  Full random features allow you to perform different actions, 
  204. depending on a "throw of the die".  Rather than hundreds of pages of 
  205. instructions and loads of complex commands, Gamescape has a short, 
  206. consise, uncomplicated manual and just a few short but very powerful 
  207. and versatile commands.  There is virtually no limitation to the 
  208. things you can do with Gamescape! 
  209.  
  210.     Purchasing this package and registering as an official user gives 
  211. you the right to distribute your adventure games without paying any 
  212. kind of a royalty fee.  
  213.     So join the world of adventure gaming today.  Gamescape is raw, 
  214. unbridled power, in an easy-to-use package. 
  215.  
  216.                        Produced by Drew Software   
  217.               PO Box 101  Joplin MO  64802  (417)781-4248 
  218.  
  219.     Welcome to Gamescape, the program that lets you write your own 
  220. adventure games AND distribute them for fun or profit! 
  221.  
  222.  
  223.                             GAMESCAPE FILES 
  224.     Once the GS system is "unarced", the following files are present: 
  225.  
  226. GSCAPE.EXE        Main GS "compiler", turns your adventure into 
  227.                   machine readable code.    
  228. GSEDIT.EXE        The new GS editor, guides you through editing your
  229.                   games-- helps prevent grammar errors.
  230. GSGRAPH.EXE       High resolution graphics development program.  
  231.                   (Available in GAMESCAPE GRAPHIC registered version).
  232. SCAPERUN.EXE      "Run-time module", must be distributed with your 
  233.                   compiled adventure code in order for the code to 
  234.                   work.  There is no royalty charge for this module. 
  235. MOUSECUR.COM      Nice mouse driver to use with GSGRAPH. 
  236.                   (Available in GAMESCAPE GRAPHIC).
  237. PALETTE.DAT       Standard palette color file (alterable to suit your 
  238.                   taste in colors) 
  239.                   (Available in GAMESCAPE GRAPHIC registered version).
  240. TABCONVT.EXE      Converts tabs to spaces in your adventure files. 
  241.                   (Available in GAMESCAPE GRAPHIC).
  242. FIXWS.COM         Converts WordStar and other non-ASCII files to 
  243.                   straight ASCII. 
  244.                   (Available in GAMESCAPE GRAPHIC).
  245. EASY.ADV          An easy to understand, simple adventure game example. 
  246. EASY.*            Support files to be used with GSEDIT.EXE
  247. TEST.ADV          A sample adventure game that tests most GS functions. 
  248. STARTER.FIL       Startup file that should be used as a basic model for 
  249.                   all of your adventure games. 
  250. SAMPLE.ADV        Small, fully-developed sample adventure game. 
  251. SAMPLE.IN?        "Include" files for SAMPLE.ADV. 
  252. 1.GR0 thru 5.GR6  Graphics files for SAMPLE.ADV 
  253.                   (Available in GAMESCAPE GRAPHIC).
  254.         
  255.     If these files are not present, please contact us immediately with 
  256. the name and phone/address of the distributor who supplied the game to 
  257. you, and we'll make them rue their existence on earth (as well as 
  258. correct the situation). 
  259.  
  260.                           WHAT IS GAMESCAPE? 
  261.     Gamescape is an adventure engine.  This means that it makes your 
  262. adventure go, by providing the "fuel". 
  263.     An adventure engine allows you to write an adventure game, and 
  264. then execute it by feeding it into a distributable "run-time" program 
  265. that proceeds to make the game work.  This allows the game to be 
  266. distributed.  Gamescape has no memory limitation, for it pulls its 
  267. information from disk.  While the disk access takes a tiny bit longer 
  268. than a totally memory resident system, it does allow you to write 
  269. adventure games limited only by the size of your imagination 
  270. (Gamescape allows linking of multiple disks and/or multiple game 
  271. modules on a hard disk.  NOTE:  Gamescape LITE limits your games to 
  272. the space of one disk.  The size of your game will depend on the size 
  273. of your disk and memory limitations).
  274.  
  275.                       GAMESCAPE AND YOUR COMPUTER 
  276.     As with any development system, the faster your computer, the 
  277. better.  Gamescape is powerful.  It allows you to develop games of 
  278. almost unlimited size and versatility.  This of course takes 
  279. microprocessor, RAM and disk access time.  While Gamescape works 
  280. properly on a "PC/XT" type machine (8088 microprocessor), it works 
  281. much better on faster computers. 
  282.     8088 systems will work, but will be somewhat slow, especially 
  283. those that are floppy-based.  This is not a fault of Gamescape, but of 
  284. the slow disk and memory access times of those machines.  Of course, 
  285. using Gamescape is still much faster than trying to write an adventure 
  286. game with a standard language compiler.  Then too, there is the 
  287. benefit that your games are no longer limited in size; you can design 
  288. adventure games limited only by the size of your disk.  Gamescape 
  289. really smokes on a 12mhz 286 with a 28ms hard disk drive; that's the 
  290. minimal type of system we recommend for best results from your game 
  291. development environment.  
  292.     But even 8088 disk users will derive value from Gamescape.  Just 
  293. remember that if you have a slow computer, access will be slow.  Be 
  294. patient.  Realize that the first MS-DOS 8088 based computers were 
  295. produced over 10 years ago.  While they're by no means dinosaurs, the 
  296. industry has come a long way since then.  If you plan to write and 
  297. distribute adventure games, you might want to move up to a faster 
  298. machine. 
  299.  
  300.        THE GAMESCAPE INTERFACE -- or how to make the thing work 
  301.  
  302.  
  303.     NORMAL USE.  To use Gamescape, you should start out with the 
  304. GSEDIT program and examine the EASY module.  Check it out and study 
  305. how the logic works.  Then when you have developed your basic skills, 
  306. you can move up to the more advanced functions using the registered 
  307. version of Gamescape and a text editor.
  308.  
  309.     Once you've written the actual adventure, you use the GSCAPE.EXE 
  310. program to compile it.  Compilation turns your adventure into a form 
  311. that Gamescape can read later when the game is actually played. If no 
  312. extension is present, Gamescape automatically adds the .ADV extension. 
  313. So to get the system to compile, you enter the command: GSCAPE 
  314. filename  (you supply the filename) 
  315.     The compiling function creates six new files with the same name as 
  316. your original database, but with the extensions of .GS1 through .GS6.  
  317.     Then you execute the finished game by typing in: SCAPERUN filename 
  318.     Everything is automatic from there on.  Don't expect your 
  319. adventure to work 100% correct the first time; as with any other 
  320. computer project, you'll make mistakes.  But I've put a couple of 
  321. things in the programs to help you locate those errors, so you should 
  322. do OK.  
  323.     Of course, when you distribute your adventure, you have to include 
  324. the SCAPERUN.EXE program with it, because that's what makes the thing 
  325. work.  No problem there; Gamescape was designed with that in mind.  
  326. Just read the licensing agreement and you're all set.  Remember that 
  327. registered users do have extra goodies that they can add to their 
  328. games.  You will find that I'm very friendly with registered users.  
  329. I'll answer questions.  I'll answer letters.  Invite me to a party, 
  330. and I'll probably show up (you pay the travel expenses, o' course!).  
  331.  
  332.                        TRY OUT THE SAMPLE GAME! 
  333.     I've included three sample adventure games called EASY.ADV, 
  334. SAMPLE.ADV, and TEST.ADV.  Try the EASY adventure first.  Then try 
  335. SAMPLE and finally TEST.  SAMPLE contains graphics, and demonstrates 
  336. how graphics appear in the Gamescape environment. 
  337.     This will give you a feel for how Gamescape works, and will show 
  338. you how an adventure data file interfaces with the Gamescape program.  
  339. Go ahead and do this now before reading any further.  SAMPLE is a 
  340. relatively easy adventure game.  It may take you several tries before 
  341. you conquer it, but it only has 5 rooms and will take from 15 minutes 
  342. to an hour to play, depending on your gaming experience.  Once you've 
  343. played it, and read this manual, examine the files thoroughly to see 
  344. how Gamescape works. 
  345.  
  346.                     HOW TO WRITE AN ADVENTURE GAME 
  347.     There are 8 basic steps involved in writing an adventure game.  
  348. These are my concept and you can choose to follow them, alter them for 
  349. your own use, or ignore them as you wish.  But I've found they work 
  350. for me and I feel that if you skip (or skimp on) any one of them, it 
  351. will detract from your game. 
  352.  
  353.     STEP 1.  Start with a theme, a plot that tells what your game is 
  354. going to do.  For example, with my popular game MAROONED AGAIN the 
  355. theme was: 
  356.  
  357.     You have crash-landed on an alien planet.  But all is not lost; 
  358. you have found an alien ship.  The crew apparently died from some 
  359. strange disease.  The ship is still in good condition, but it was not 
  360. built for human anatomy to withstand a blast-off. 
  361.     Fortunately, you have super-strong clones aboard your ship, but 
  362. they were damaged in the crash.  They now only recognize 1 or 2 words 
  363. at a time.  Your goal:  send them aboard the alien ship, find the 
  364. components required to get it to blast off, and send them for help. 
  365.  
  366.     See how that works?  You need a theme of your own, something to 
  367. tie the entire game together. 
  368.  
  369.     STEP 2.  Once the theme is established, start writing down 
  370. individual things you'd like to have happen in the game.  For example, 
  371. you may find a key that's required to open a door located elsewhere.  
  372. Or you may have to fight a robot to gain access to a room.  Don't get 
  373. too complex.  Take my word for it; adventure games get complex all on 
  374. their own as you start writing the actual code.  
  375.  
  376.     STEP 3.  Draw a map.  Set up rooms and corridors, or open land 
  377. areas, etc., keeping in mind the things in step 2 so you can 
  378. incorporate them into your map.  Use a big sheet of paper and make the 
  379. rooms large (2" square is a good size) because you're going to be 
  380. scribbling in details later.  The key to proper adventure game writing 
  381. is advanced planning.  You should have the entire game designed before 
  382. you begin writing one line of code! 
  383.  
  384.     STEP 4.  Number the rooms.  Room #1 is always the starting 
  385. location of the adventure. 
  386.  
  387.     STEP 5.  Go through the rooms one by one and make a list of the 
  388. OBJECTS in the rooms, and the WORDS that will be required to play the 
  389. adventure.  This will only be a partial list; as you test the 
  390. adventure you'll probably find more objects and words that you'll 
  391. need.  Try to be as thorough as possible. 
  392.  
  393.     STEP 6.  Make sure the game is logical.  One of the worst problems 
  394. with many adventure games is that the things the author requires you 
  395. to do don't make any sense.  I remember one game I played where I 
  396. found an Egyptian statue that would kill me every time I got near it.  
  397. I could find no way around this.  When I started asking around and 
  398. tore the game apart, I finally discovered that a ruby found earlier in 
  399. the game (which the game stated was a treasure) was actually the heart 
  400. of the statue, and had to be thrown into a lava pit.  There were no 
  401. clues that this should be done, no hints.  Totally illogical.  I hate 
  402. an adventure game that requires the player to be stupid and do 
  403. ignorant and dumb things in order to make the game work (there is a 
  404. difference of course, between stupid things and sneaky things).  So 
  405. ask yourself as you write the game: If I were playing the game, would 
  406. this be a logical thing to do, something that I might actually think 
  407. of doing?  If the answer is "no", eliminate that thing and do it some 
  408. other way. 
  409.  
  410.  
  411.     STEP 7.  Once you're convinced the game is logical, begin writing 
  412. the code.  There is a file called STARTER.FIL that should be the heart 
  413. of every adventure you write.  It includes standard adventure 
  414. functions, as well as a few required adventure functions that you'll 
  415. need for each game.  You can alter it any way you wish; it's just a 
  416. guideline to use.  
  417.     Of course, do not alter  STARTER.FIL itself; copy it to another 
  418. file:     COPY STARTER.FIL MYGAME.ADV 
  419.     Then use the MYGAME.ADV file to write your adventure. 
  420.  
  421.     STEP 8.  Writing the game and testing it yourself is called the 
  422. alpha stage.  Beta test stage is the important one.  Call in a friend 
  423. who enjoys playing adventure games (not two, because you'll want to 
  424. beta test this on several individuals) and let him have at it.  Grab a 
  425. pencil and notebook and sit by him the whole time.  Don't give any 
  426. hints; figuring out the adventure is part of the testing.  Give hints 
  427. and you'll ruin the spontenaity such testing requires.  Resign 
  428. yourself to the fact that you will most likely need several sessions 
  429. to test a game propery.  This is the research & development stage; R&D 
  430. takes time.  Anything worth doing... 
  431.     As you note errors in the game (and you will) write down the 
  432. circumstances and errors that result.  Take legible, detailed notes.  
  433. But don't alter the game right then unless it is unplayable due to 
  434. that error.  Let your friend finish playing, all the while writing 
  435. down alterations.  Also, make notes of things you wish to add to the 
  436. game; you'll find lots of things to include that you didn't think of 
  437. before.  
  438.     Once your friend has finished playing (this may take many, many 
  439. hours, or even several sessions, depending on the complexity of the 
  440. game) then make the changes to your game, and call over another 
  441. friend.  Go through the same process again.  Do this two, three, four, 
  442. or five times if necessary, until the game is playable.  Don't try to 
  443. cover every possible situation that might occur; just make sure that 
  444. the things you do allow in your game, work properly.  
  445.     After this is done, you are now to gamma production stage, which 
  446. means that your game is ready to distribute. You may still find minor 
  447. bugs in your code as the months go by, but none of them should 
  448. seriously affect game play and for the most part everything will be 
  449. fine.  
  450.  
  451.  
  452.                     VERY IMPORTANT!  DEBUGGING CODE 
  453.     Gamescape is a very complex project, and I would be foolish to 
  454. imagine that some obscure bug doesn't exist somewhere.  If you find a 
  455. legitimate bug, I will appreciate you letting me know.  However, 
  456. please do so under the following guidelines: 
  457.  
  458.     #1 AND MOST IMPORTANT:  Remember that Gamescape is a programming 
  459. environment, and it has been used to generate very complex adventure 
  460. games.  It is therefore reasonable to assume that most (if not all) of 
  461. the bugs have been discovered.  Whenever you find what you think is a 
  462. bug, realize that it is most likely in your game code, and not a 
  463. problem with Gamescape.  
  464.     Before you report a bug, go over your code with a fine tooth comb.  
  465. Whether or not we charge you for examining your code depends on 
  466. whether the bug is caused by Gamescape, or by user coding errors. If 
  467. we have to spend time hunting for a bug that we find to be user 
  468. programming code errors, we will have to bill the user for that time.  
  469. This may seem unfair, but A) we will help the user discover the 
  470. mistake and thus have rendered a programming service and B) we deserve 
  471. to be reimbursed for time/wage/computer expense involved in finding 
  472. user coding errors.  Even in such a case, our rates are reasonable, 
  473. and can be avoided completely if you make sure that a bug report is an 
  474. actual bug.  
  475.     Note that billing will only be done if we feel that significant 
  476. time was wasted.  We're not going to worry about minor work... that's 
  477. just part of doing business and supporting you as a registered user of 
  478. Gamescape.  
  479.     #2:  An error message does not mean a Gamescape bug.  It likely is 
  480. pointing out a problem with your code.  Check out the error; you may 
  481. find it means something like "printer not on" or "disk full" or 
  482. something like that.  Or, it may mean you've left out a part of an 
  483. IF/DO line which causes Gamescape to return an error such as "Out of 
  484. string space" or "Bad record number" or "Illegal function call" (that 
  485. happens more than adventure programmers like to admit). Such things 
  486. are programmer errors, and are not likely to be a fault of Gamescape.  
  487.     #3:  If you do find what you feel to be a legitimate bug, write us 
  488. a letter fully documenting the info.  A phone call is allowed as well, 
  489. but the phone is mainly for answering questions, not in trying to 
  490. trace down a supposed bug.  If you can send us a disk with your source 
  491. code, that will be appreciated as well (source codes will be kept 
  492. extremely private and secured... we will not release or distribute 
  493. them under any circumstance.  They will be used solely for the purpose 
  494. of documenting the bug). 
  495.     #4:  We will not consider any bug report from an unregistered 
  496. user.  No exceptions.  If you claim you have found a bug and we find 
  497. you are not registered, we will totally ignore you. Sorry, but that's 
  498. what registration means: support.  If you are unregistered then you 
  499. are not aware of updates, changes, techniques, etc.  We will not waste 
  500. time with an unregistered user, no matter how legitimate you think 
  501. your problem may be. Bottom line:  if you want the support, then 
  502. please register. 
  503.     #5:  If you do find a legitimate bug, we will send you one of our 
  504. nifty adventures free of charge, as well as give you credit for the 
  505. bug find in future documentation! 
  506.  
  507.     Thanks for your attention to these matters. 
  508.  
  509.  
  510.                          GAMESCAPE ERROR CODES
  511.     Gamescape is written using Microsoft QuickBASIC 3.0 and uses most 
  512. standard BASIC error codes.  I am listing them here for your 
  513. convenience in tracking down your game code errors.  Please note that 
  514. an error that pops up does not likely mean Gamescape has a bug; if you 
  515. have not yet read the section on debugging code, do so now.  It is 
  516. extremely important.  
  517.  
  518. 1   NEXT WITHOUT FOR            
  519. 2   SYNTAX 
  520. 3   RETURN WITHOUT GOSUB    
  521. 4   OUT OF DATA 
  522. 5   ILLEGAL FUNCTION CALL    
  523. 6   OVERFLOW 
  524. 7   OUT OF MEMORY                
  525. 8   UNDEFINED LINE NUMBER 
  526. 9   SUBSCRIPT OUT OF RANGE      
  527. 10  DUPLICATE DEFINITION 
  528. 11  DIVISION BY ZERO                
  529. 12  ILLEGAL DIRECT 
  530. 13  TYPE MISMATCH                
  531. 14  OUT OF STRING SPACE 
  532. 15  STRING TOO LONG                
  533. 16  STRING FORMULA TOO COMPLEX         
  534. 17  CAN'T CONTINUE                
  535. 18  UNDEFINED USER FUNCTION 
  536. 19  NO RESUME                              
  537. 20  RESUME WITHOUT ERROR 
  538. 22  MISSING OPERAND                
  539. 23  LINE BUFFER OVERFLOW 
  540. 24  DEVICE TIMEOUT                
  541. 25  DEVICE FAULT 
  542. 26  FOR WITHOUT NEXT              
  543. 27  OUT OF PAPER  
  544. 29  WHILE WITHOUT WEND        
  545. 30  WEND WITHOUT WHILE 
  546. 50  FIELD OVERFLOW                
  547. 51  INTERNAL ERROR 
  548. 52  BAD FILE NUMBER                
  549. 53  FILE NOT FOUND 
  550. 54  BAD FILE MODE                    
  551. 55  FILE ALREADY OPEN 
  552. 57  DEVICE I/O ERROR                
  553. 58  FILE ALREADY EXISTS 
  554. 61  DISK FULL                        
  555. 62  INPUT PAST END                    
  556. 63  BAD RECORD NUMBER        
  557. 64  BAD FILE NAME                        
  558. 66  DIRECT STATEMENT IN FILE 
  559. 67  TOO MANY FILES 
  560. 68  DEVICE UNAVAILABLE        
  561. 69  COMMUNICATION BUFFER OVERFLOW 
  562. 70  DISK WRITE PROTECT         
  563. 71  DISK NOT READY 
  564. 72  DISK MEDIA ERROR            
  565. 73  ADVANCED FEATURE 
  566. 74  RENAME ACROSS DISKS         
  567. 75  PATH/FILE ACCESS ERROR     
  568. 76  PATH NOT FOUND 
  569.          (you probably didn't install CONFIG.SYS properly) 
  570.  
  571.  
  572.     Please register for Gamescape.  Not only does registration provide 
  573. you with expanded abilities and privileges,  registrations encourage 
  574. us to update the program and add even more power, so that your games 
  575. can be more impressive than ever before.  The more registrations we 
  576. receive, the more eager we are to provide regular updates to the 
  577. program.  Thank you for registering ! 
  578.  
  579.  
  580.     The remainder of this manual is contained in the registered 
  581. version.  To get started writing your own adventure games, please use 
  582. the GSEDIT program.  Realize however, that the registered manual 
  583. provides you with a great deal of information that is required for 
  584. professional game development.  
  585.  
  586.                    THANK YOU FOR EXAMINING GAMESCAPE
  587.  
  588.  
  589.                             end of manual 
  590.  
  591.                 Gamescape is written and published by: 
  592.  
  593.       Drew Software    PO Box 101   Joplin, MO  64802   (417)781-4248 
  594.  
  595. ======================================================================
  596.                       Please read the following: 
  597.     
  598.            IMPORTANT:   HOW TO OBTAIN THE INSTRUCTION MANUAL 
  599.     Our programs are very easy to use.  You do not need an instruction 
  600. manual to operate them.  However, the manual allows you to gain 
  601. greater benefit from this program.  To get the manual, you must 
  602. REGISTER with us.  We depend on your registration fee to continue 
  603. operation.  Registration brings you: 
  604.     1. Instruction manual.
  605.     2. Call-in telephone support.
  606.     3. Places you on our mailing list for notification of future 
  607. updates.  
  608.     4. Usually brings you a more advanced version of the program.
  609.  
  610.     We will support you if you register; absolutely no support will be 
  611. given to non-registered users.  
  612.                                 
  613.                 USER REGISTRATION AND LICENSE AGREEMENT
  614.  
  615. ARTICLE 1. ACCEPTANCE.
  616.     In registering for our programs, the user agrees to abide by all 
  617. articles and restrictions of this license. It is the responsibility of 
  618. the purchaser to note the items of this license, and decide upon 
  619. agreeability of its terms prior to the registration of the program.  
  620.  
  621. ARTICLE 2. LICENSING.  
  622.     This program is licensed, not sold. As such, the user/ 
  623. purchaser has the right to use the program on a day-to-day basis, 
  624. but recognizes the ownership of the program and all materials as 
  625. belonging to Dennis Drew.
  626.  
  627. ARTICLE 3. COPYING AND MULTI-USER.
  628.     This program is USER SUPPORTED.  You are encouraged to copy 
  629. the SHAREWARE diskette and give it to your friends and acquaintences.  
  630. You may use this program freely and distribute it as you wish.  
  631. However, the following restrictions do apply: 
  632.     1. You may not charge a fee for this program, other than for 
  633. the cost of duplication.  
  634.     2. You may not alter the program or supporting items in any 
  635. manner, may not add to or remove items from the disk.  
  636.     3. You may not copy or reproduce in any way the instruction manual 
  637. that is available for this program. The instruction manual is provided 
  638. to REGISTERED USERS ONLY.  Copying of this manual in any form is 
  639. strictly forbidden.  If several copies of the manual are required, 
  640. then a discount is provided on request.  
  641.     4. Shareware companies must obtain a distribution license from the 
  642. author.
  643.  
  644. ARTICLE 4. WARRANTY AND LIABILITY.
  645.      It is the responsibility of the purchaser to decide upon 
  646. usability and application of this program to his/her particular 
  647. needs. Every effort has been made to insure the accuracy and 
  648. reliability of this program. However, since the success of this 
  649. program relies a great deal upon individual use and dedication to 
  650. the use thereof, and the fact that this program is user copiable 
  651. (thus limiting our control over what the end-user receives), 
  652. We will not be held responsible for any results obtained from the 
  653. direct or indirect use of this program nor does this program 
  654. comply to the laws of merchantability of any state.  
  655.  
  656. ARTICLE 5. TERMINATION.
  657.      If the user/purchaser breaks any article of this agreement, 
  658. all items pertaining to the program shall be returned to the 
  659. publisher. This will not exclude any additional punitive damages 
  660. incurred according to national and civil laws.  
  661.  
  662. ARTICLE 6. CUSTOMER SUPPORT.
  663.      We are eager to support our customers. Technical 
  664. assistance is available to REGISTERED USERS ONLY by calling 
  665. (417)781-4248 Monday through Friday during the hours of 9am to 
  666. 5pm.  
  667.      If your diskette is damaged in any way, return it to us along 
  668. with $10.00 to cover cost of replacement. We will rush you a new 
  669. diskette.  
  670.      It is recognized that the purchaser is already bound by the terms 
  671. of the LICENSING AGREEMENT enclosed with this package. This 
  672. registration form serves two purposes: 
  673.      1. To emphasize agreement with the terms of the license.
  674.      2. To allow us to provide you with timely updates and information.  
  675.      
  676.  
  677.                     Thank you for registering!
  678.  
  679.  
  680.