home *** CD-ROM | disk | FTP | other *** search
/ Duke Nukem 3D - Kill-A-Ton / Duke_Nukem_3D_Kill-A-Ton_Collection_-_CD3.iso / dukedc / dukedc / readme.txt < prev   
Text File  |  1997-10-16  |  11KB  |  237 lines
  1.   GAMER (Game Add-on Manager) developed by Sunstorm Interactive Inc. (1997)
  2. -----------------------------------------------------------------------------
  3.  
  4. Thank you very much for purchasing a Sunstorm Interactive product. This help
  5. file will aid you through running the GAMER program, as well as provide
  6. helpful information should you come across any problems. Again, we thank you
  7. very much, and hope you enjoy the levels as much as we enjoy bringing them to
  8. you!
  9.  
  10. -----------------------------------------------------------------------------
  11. Notes on running GAMER
  12. -----------------------------------------------------------------------------
  13.  
  14. GETTING FAMILIAR WITH THE INTERFACE
  15. -----------------------------------
  16. When you start up the GAMER there will be two windows that will appear, and
  17. this is how you select the add-on packs you want to install (ACTIVATE is how
  18. it is referred to in GAMER). The top, larger window will list all the add-on
  19. packs (.SSI files) that you have installed, and for what game they were
  20. developed for. For example:
  21.  
  22. DUKE NUKEM 3D 1.3D - DUKE IT OUT IN D.C.
  23.  
  24. The game it is developed for is Duke Nukem 3D version 1.3D, and the add-on
  25. pack is `Duke It Out In D.C.'
  26.  
  27. The bottom window shows the details of the currently selected add-on pack.
  28. It provides the title of the add-on, the long description, and its current
  29. status (ACTIVATED or NOT ACTIVATED). When you select an add-on and install it,
  30. the red NOT ACTIVATED message will change to a green ACTIVATED message. Easy
  31. enough... right?
  32.  
  33. Just use the up and down arrows to move between the different add-on packs,
  34. and when you have the one you want to activate or deactivate, then press
  35. <ENTER>. You will be asked if you are sure, select yes to move on. When you
  36. have activated an add-on pack, the white selection bar will change to yellow
  37. when over the activated add-on pack. Plus, the normal text within the menu
  38. for each activated add-on will be green instead of the default white. This
  39. helps you to easily see what you currently have setup on your computer.
  40.  
  41. NOTES ON ACTIVATING, ETC.
  42. -------------------------
  43. The menu listing all the add-on packs will list every one installed, and for
  44. every game. You can only have ONE add-on pack activated per game, but you can
  45. have more than one add-on pack installed for different games. When you select
  46. to activate an add-on pack for a certain game, GAMER will check to see if any
  47. others are already installed, if they are it deactivates the current one and
  48. then activates the one you selected. If you would like to deactivate an add-on
  49. pack without activating another one, then just hit <ENTER> on the currently
  50. activated add-on, and it will be deactivated and the game returned to normal.
  51.  
  52. When GAMER puts the new files in your game directory to activate the add-on,
  53. it checks to see if there are any files that currently have the same name for
  54. one of the new files. If it does, it will create a directory called
  55. SSIFILES.BAK and copy those into that directory. When the add-on is
  56. deactivated the files in that directory will be restored, and your game will
  57. be returned to the exact state it was in before you activated the add-on.
  58.  
  59. Once an add-on has been activated, you will be presented with the option to
  60. run the game or not. In that window, you will also be presented with some
  61. important information. The launcher is the name of the program you need to
  62. run in order to play the addon properly. So, for example, it might say:
  63.  
  64. Run LAUNCHER.EXE to play.
  65.  
  66. That is the program you need to run in your Duke Nukem 3D directory to play
  67. the add-on while it is activated.
  68.  
  69. MISC. NOTES
  70. -----------
  71. GAMER is a DOS based program. It does, however, run much faster under
  72. Windows 95. It doesn't matter what environment you run it in, so just run it
  73. under the same environment you need to run your game(s) in.
  74.  
  75. When an add-on pack is being referred to, it may be named add-on pack or
  76. SSI file. They are both the same thing.
  77.  
  78. -----------------------------------------------------------------------------
  79. How to remove an add-on pack if you delete GAMER or GAMER fails
  80. -----------------------------------------------------------------------------
  81.  
  82. First of all, if you don't try to remove things by hand, and don't delete or
  83. modify files without _absolutely_ understanding what you are doing, then
  84. GAMER should not fail.
  85.  
  86. Also, if you choose to delete GAMER, then please, please, PLEASE make sure
  87. that you have deactivated _all_ add-on packs before you do this. Otherwise you
  88. run the risk of not being able to recover the original state of your games.
  89. But, it is possible to fix if you do happen to do this. Simply follow these
  90. steps.
  91.  
  92. 1) Re-install GAMER, and whatever add-on pack is currently activated on the
  93. game you need to restore to it's original state.
  94.  
  95. 2) Now, when you enter GAMER, it will not list the add-on as being activated,
  96. but that is OK. Go ahead and activate it. Now, don't chose to play the game.
  97. Remain in GAMER and de-activate the add-on pack. This _should_ restore the
  98. game back to its original state.
  99.  
  100. 3) This can be done to any number of games/add-on packs. After you have done
  101. this, you can remove GAMER safely.
  102.  
  103. -----------------------------------------------------------------------------
  104. Problems, fixes, workarounds
  105. -----------------------------------------------------------------------------
  106.  
  107. ERROR MESSAGES
  108. --------------
  109. - Error 001: GAMER.INI not properly formatted for use with GAMER
  110. This means that you have either modified the GAMER.INI in a way that makes
  111. it corrupt, or the file has been corrupted on your hard drive. You will need
  112. to go above and read the section on manually installing GAMER. Look for the
  113. sections on updating the GAMER.INI file and check to see that everything is
  114. set correctly. You may need to delete the GAMER directory and reinstall from
  115. scratch.
  116.  
  117. - Error 001: Invalid directory in GAMER.INI - <DIRECTORY>
  118. This means that you probably moved the location of one of your games, and thus
  119. GAMER can not install the specified add-on pack. Either don't move your games
  120. around, or read the section below on updating your game information.
  121.  
  122. - Error 001: GAMER.INI does not exist!
  123. This simply means that the initialization file named GAMER.INI is not in the
  124. same directory as your GAMER.EXE program. Please just leave this file alone,
  125. otherwise you could potentially disable GAMER and you won't be able to
  126. install any of your add-on packs without reinstalling the entire GAMER
  127. software, and even then it might not detect all of your add-ons.
  128.  
  129. - Error 001: Could not detect any add-ons!
  130. There are no SSI files installed on your computer. This will usually occur
  131. if you attempt to remove SSI files without properly updating the GAMER.INI
  132. file. Please read about updating your settings below.
  133.  
  134. - Error 001: Not enough disk space available. Please free some and try again.
  135. You do not have enough hard drive space to activate the add-on pack. Simply
  136. free up enough disk space and try to activate it again.
  137.  
  138. - Error 001: Currently activated addon not found - <ADDON NAME>
  139. This means that you activated an SSI file, and then deleted it before you
  140. deactivated it. Shame on you. Go to the section above that tells you about
  141. "How to remove an add-on pack if you delete GAMER or GAMER fails"
  142. It will tell you how to restore you game to it's original settings. In the
  143. future, please deactive an SSI file before you choose to delete it.
  144.  
  145. QUESTIONS, PROBLEMS
  146. -------------------
  147.  
  148. -Q GAMER starts to load and then freezes on a blank screen.
  149.  
  150. -A This occurs when two add-on packs have exactly the same name. The only way
  151.    this could happen is if you copied an SSI file to a different name, thus
  152.    having the exact same file just with two different FILE names. Simply
  153.    remove one of them.
  154.  
  155. -Q I want to remove an SSI file, how would I go about doing this?
  156.  
  157. -A Go into the directory where the SSI file is located, and delete the one
  158.    that you want to remove.
  159.  
  160.    If it is the only SSI file in that directory, then also remove that
  161.    directory. Then, open up GAMER.INI in DOS Edit by typing
  162.  
  163.    EDIT GAMER.INI
  164.  
  165.    You should find the section that refers to your game... for example for
  166.    Duke Nukem 3D version 1.3D you would see something like this:
  167.  
  168.    DUKE NUKEM 3D 1.3D
  169.    DUKE3D13
  170.    NONE
  171.    C:\GAMES\DUKE3D\
  172.  
  173.    Remove all four of those lines from the information. Now, go to the
  174.    second line in the file, and it should be a number. Just subtract one from
  175.    that and replace it. So, simple enough... if it is 3 change it to a 2.
  176.  
  177. -Q I moved my game directory, and now GAMER can't install for it.
  178.  
  179. -A You can either move your game back to its original location, or modify
  180.    the GAMER.INI file. To modify the GAMER.INI file, open it up in DOS Edit by
  181.    typing
  182.  
  183.    EDIT GAMER.INI
  184.  
  185.    Then, look for the section relation to your game. You should see the game
  186.    title, a subdirectory for the add-on packs, an add-on pack title (or the
  187.    word NONE), and then the directory where your game is located. Just
  188.    replace that directory with your new directory. Be sure to include the
  189.    drive letter, and make sure that you have the last \ at the end of it.
  190.  
  191. -Q I installed an add-on pack... and then deleted GAMER, and now I can't get
  192.    my original game settings back! How do I fix this?
  193.  
  194. -A Don't panic. Before you go starting to delete files from your game
  195.    directory, this a simple and easy way to restore the original game. Simply
  196.    reinstall the GAMER software, and the add-on pack that you last activated
  197.    for that game. Then, start up the GAMER software, activate that add-on
  198.    pack, and then deactivate it. This _should_ restore your entire game back
  199.    to its original settings, provided you didn't modify any files or move
  200.    anything around. The best solution is *always* to let GAMER handle the
  201.    activation and deactivation of SSI file add-on packs.
  202.  
  203. Should you continue to experience problems, feel free to contact us and we
  204. will attempt to help you out. Read below to find out how to get support.
  205.  
  206. -----------------------------------------------------------------------------
  207. How to get technical support for the GAMER software
  208. -----------------------------------------------------------------------------
  209.  
  210. For technical support on GAMER, please contact:
  211.  
  212. WizardWorks Technical Support
  213. 2300 Berkshire Lane North
  214. Plymouth, MN 55441
  215.  
  216. (612) 559-5301
  217. 9am - 5pm Monday-Friday
  218.  
  219. E-mail
  220. support@wizworks.com
  221. http://www.wizworks.com
  222.  
  223. Apogee/3D Realms does not provide support for this product.
  224.  
  225. -----------------------------------------------------------------------------
  226. Credits
  227. -----------------------------------------------------------------------------
  228.  
  229. Watch for more great add-ons from Sunstorm for cutting edge 3D games.
  230. Stop by our website at http://www.sunstorm.net to get the latest updates!
  231.  
  232. The GAMER add-on management program and all documentation was developed by 
  233. Charlie Wiederhold. Some artwork in Sunstorm's add-ons are created by 3DI 
  234. Software Inc. Stop by and see them at www.3di-soft.com
  235.  
  236. Duke Nukem is a trademark of 3D Realms Entertainment. All rights reserved.
  237.