home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / bbs / airdef31 / sysop.txt < prev    next >
Text File  |  1991-04-07  |  7KB  |  148 lines
  1.                Air Defense Setup Instructions
  2.                     As of: April 7, 1991 
  3.                          Version 2.4
  4.  
  5.     I think you will enjoy Air Defense.
  6.  
  7.     This game is written by Darel Schartman, a user on my 
  8. BBS.  I've known Darel for a few years and he has programmed 
  9. several on-line games for Forem XEP, the 8-bit BBS program.  
  10. This is Darel's first game specifically for Forem ST.  Air 
  11. Defense has been Beta Tested by Nodes 391, Carlis Darby, and 
  12. 398, Bill Day, and myself at Node 224 for over a month prior 
  13. to this release.  Our thanks to both for their help.  As an 
  14. overall protection, there is a general error routine that 
  15. will trap all fatal game errors, return the user to the BBS, 
  16. and write an Air.Err file in the Air Defense game folder.  
  17. AIR.ERR will contain the date, time, and error code 
  18. responsible for the untimely program termination.
  19.  
  20.     The modem code and the message routines are the two 
  21. places where the user interacts with the program, and 
  22. through that, your BBS.  The input routines are armored to 
  23. filter out all but ASCII characters.  No hanky panky 
  24. allowed.  Even the famous 1e45 from SEE has been tested -- 
  25. it will cause Air Defense to abort to the BBS, however, 
  26. because of the times that data is saved, it won't do a user 
  27. any good to use it.  The input routines all have time-out 
  28. features and will terminate the game if there is no input 
  29. for approximately 2 minutes.  Like Forem, a 30 second 
  30. warning will be given.
  31.  
  32.     The players login name is read from Forem.Dat.  I chose 
  33. to do this instead of using Dorinfo1.dat because that was 
  34. the code I wrote previously for NFL Picks.  I'm lazy.  If 
  35. you have a good argument for using Dorinfo1.dat instead, 
  36. I'll change the code to read Forem.Opt (to find out where 
  37. the silly bugger is), and then the code to read the info.
  38.  
  39.     In NFL Picks, I used a routine to look for carrier 
  40. detect and if found, assumed the player was on the modem.  
  41. Conversely, if carrier was not present, the game defaulted 
  42. to local mode.  I changed this for Air Defense to look 
  43. instead for the word "local" as a parameter to the run line 
  44. in the Fdoorsx.dat file.  There's a little less room for 
  45. error this way.
  46.  
  47.     I will personally guarantee that there is NO backdoor 
  48. in this program, nor any code to accomplish anything except 
  49. handle game play.  I have examined every routine, not 
  50. because I didn't trust Darel, but because I was helping him 
  51. debug the code and get the Forem functions working properly.  
  52.  
  53. Game Setup
  54.  
  55.     Create a game folder on the drive of your choice and 
  56. copy all game files into it.
  57.  
  58.     You need to create two text files, AIR.SET and 
  59. PATHS.DAT.  You can do this with a text editor or by using 
  60. the supplied AIR_CNFG.PRG.  To use the AIR_CNFG.PRG, you 
  61. must follow the instructions below.
  62.  
  63.     AIR.SET contains three lines, the path to Forem.Dat and 
  64. the path to the Air Defense game files, and the reset 
  65. period:  blank for no reset, 1 for monthly, and 2 for bi-
  66. monthly.
  67.  
  68.         c:\
  69.         d:\defense\
  70.         2
  71.  
  72.     PATHS.DAT contains six lines as follows:
  73.  
  74.         line 1 - path to news and hall of fame file
  75.         line 2 - hall of fame filename   <--- Note:  
  76. filename only
  77.         line 3 - Today's News filename   <--- Note:  
  78. filename only
  79.         line 4 - Yesterday's News filename  <--- same as 
  80. above
  81.         line 5 - Sysop's login name
  82.         line 6 - Alternate Sysop's login name
  83.  
  84.         For example, my file reads as follows:
  85.         e:\games\
  86.         db015.003
  87.         db015.001
  88.         db015.002
  89.         DOC HOLIDAY
  90.         DAREL SCHARTMAN
  91.  
  92.     The PATHS.DAT file gives you the capability to put the 
  93. files anywhere you choose and with any name.  They will be 
  94. maintained by the game and are also viewable from within the 
  95. game.  Note that the data base files contain information 
  96. that the internal game files don't.  I strongly suggest you 
  97. add these files to an appropriate database area.  The Sysop 
  98. and Alternate Game Sysop entries are case sensitive and DO 
  99. NOT automatically convert your entries to upper case.  This 
  100. is to allow for the later versions of Forem which permit 
  101. mixed case logins.
  102.  
  103.     Place the AIR.SET file in the same directory as 
  104. Forem.Tos.  The PATHS.DAT file is placed in the same folder 
  105. as the Air Defense program files.
  106.  
  107.     Included with the game program is a program called 
  108. AIR_CNFG.PRG.  This is a configuration program that can be 
  109. used to create or alter the AIR.SET and PATHS.DAT files.  
  110. The AIR.SET file will be written to where you have FOREM.TOS 
  111. and PATHS.DAT will be written to the game folder you 
  112. specified in AIR.SET.  However, this program is designed to 
  113. be installed in DOORS and will work from local or from 
  114. remote.  You can retrieve and reset the values at any time.  
  115. Note that you CANNOT run this program from the desktop 
  116. without a "local" parameter.  This is because it looks in 
  117. the basepage for the "local" command.  You can, however, run 
  118. the program from within FOREM's sysop mode using the 
  119. "system" or "K" command ("k" only on the newer versions of 
  120. Forem) to execute the file.  Just type the full path and 
  121. filename, add a space, and type "local" (example:  
  122. d:\defense\air_cnfg.prg local).  You can then use this 
  123. program to automatically generate or modify your game path 
  124. files.  Remember that you also select a reset period.  You 
  125. have three choices, no reset, reset monthly, or reset bi-
  126. monthly.  Based upon your selection, when the month changes, 
  127. the game will note the change and if reset is due, the game 
  128. will be reset and the winner recognized in the Hall of Fame 
  129. file.
  130.  
  131.     The first time you run the game, all the necessary 
  132. files will be created and placed in accordance with the 
  133. PATHS.DAT file.  The Hall of Fame, Today's News, and 
  134. Yesterday's News will only be created when there is 
  135. something to report.
  136.  
  137.     When you as the Sysop or your designated Game Sysop 
  138. complete game play, you will be shown an additional System 
  139. menu.  From this menu you may alter any of the paths or 
  140. filenames in PATHS.DAT or redesignate the Sysop or Game 
  141. Sysop.  You can also reset the game.  Resetting creates an 
  142. entry in the Hall of Fame file.  What this means is that the 
  143. game runs until you decide to reset it.  The menu also has 
  144. two other commands.  One prints the player file to your 
  145. screen.  You use this command to find out what user is 
  146. playing with what game alias and what player number he/she 
  147. is.  The purpose of having this list available is to aid you 
  148. in using the last command available, the