home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1996 October / PCO_10.ISO / filesbbs / mgorr.arj / GORR.DOC < prev    next >
Encoding:
Text File  |  1996-09-10  |  14.6 KB  |  397 lines

  1.  
  2.     +----------------------------------------------------+
  3.         | Mines of Gorr, (C) Copyright 1991-95, Scott Jibben |
  4.         +----------------------------------------------------+
  5.  
  6.  
  7. This is a list of the files that should accompany this software
  8. package:
  9.  
  10. CHAMPSCR.ANS - ANSI champions screen for sysop
  11. MOG.ANS      - Alternate ANSI intro screen for MOG or BBS ad.
  12. SK-DRAKE.ANS - ANSI advertisement for Shadow Keep BBS
  13. SPONSOR1.ANS - ANSI template for sponsors #1
  14. SPONSOR2.ANS - ANSI template for sponsors #2
  15. LOCAL.BAT    - Batch file to run Mines of Gorr locally.
  16. GORR.CFG     - Example Mines of Gorr configuration file.
  17. NODES.CFG    - Example BBS nodes configuration file.
  18. FILE_ID.DIZ  - BBS Description File.
  19. CC-ORDER.DOC - Information to register by credit card.
  20. FIDOFREQ.DOC - Listing of Fidonet FREQ'able files and info.
  21. GORR.DOC     - Mines of Gorr Documentation.
  22. INTERNET.DOC - Listing of internet access points.
  23. ORDERFRM.DOC - The order form.
  24. VENDOR.DOC   - Information for disk vendors and SHAREWARE distribution.
  25. WHATSNEW.DOC - The Version History of Mines of Gorr.
  26. GORR.EXE     - Mines of Gorr executable.
  27. GENGORR.EXE  - Mines of Gorr Dungeon, etc. generator.
  28. MOGEDIT.EXE  - Mines of Gorr Editor.
  29. MEHELP.H16   - Mines of Gorr Editor help file.
  30. CATALOG.JSW  - Information on Jibben Software Products.
  31. RES01.RES    - Mines of Gorr Resource File.
  32. AVEXTRA.TXT  - Information regarding PKZIP AV codes.
  33. UPGRADE.TXT  - Instructions for upgrading from previous versions.
  34.  
  35.  
  36. This software should not include any other files other than the ones
  37. listed above.  It was also compressed using the PKZIP AV.
  38.  
  39.  
  40.                 Shareware Trade Association & Resources
  41.  
  42. Scott Jibben is a charter member (#9) of STAR!  STAR is the shareware
  43. industries fastest growing trade association.
  44.  
  45. To obtain other fine software from members of STAR, please contact the
  46. Software Creations BBS.  It is the hub of the STAR distribution network
  47. supporting 53 phone lines.  To access Software Creations, you may call
  48. the following numbers:
  49. (508) 365-2359 - 2400 baud
  50. (508) 368-4137 - US Robotics HST
  51. (508) 368-7423 - Dual Standard, V.32bis
  52.  
  53. Please contact The Warehouse BBS for TECHNICAL SUPPORT at:
  54. (612) 379-8272 - Dual Standard, V.32bis (10 phone lines)
  55.  
  56.  
  57.                        The concept of Shareware
  58.  
  59. Mines of Gorr is being released as a Shareware product.  Shareware
  60. is a marketing concept, in which you get to try out a software package
  61. for a period of time.  If you find that the software is useful to you
  62. (you are still using it), you are obligated to send in a registration
  63. fee for that software to the author.
  64.  
  65. Mines of Gorr's trial period is unlimited.  That means, you may use the
  66. shareware version of the Mines of Gorr as long as you wish.  The
  67. shareware version of Mines of Gorr is functional.  However, it will
  68. only allow the players to explore the first level of the mine. Also,
  69. the game will display the game stats and ad screen on exit with delays.
  70.  
  71. Here's what you get when you register (Please use ORDERFRM.DOC or
  72. CC-ORDER.DOC to order this software):
  73.  
  74. 1.  Support.  You can call and leave e-mail to me on the BBS listed in
  75.     the Technical Support section of this document or CompuServe and
  76.     get a response from me.  I will more than likely answer all
  77.     questions, but the registered individuals will definitely get top
  78.     priority.  You will also receive unlimited telephone support for
  79.     the program.  Registered users will get a phone number that they
  80.     will be able to use to receive support between the hours of 6:00 pm
  81.     - 9:00 pm (Central Standard Time) Monday-Friday.
  82.  
  83. 2.  You will receive a disk with the most recent version of Mines of
  84.     Gorr.  The software will also have all of the registration
  85.     incentives removed.  The name and serial number of your BBS will
  86.     also be displayed in the main menu when the software is run.
  87.  
  88.     NOTE: The extra weapons, armor, and items are found in the Mine.
  89.     The players will have to explore to get them.  Also, the
  90.     Blacksmiths Shop is a running inventory system for any item above
  91.     level 1.  This means an item can be sold out if it isn't found on
  92.     level 1.
  93.  
  94. 3.  Special access to new products.  You will be allowed access to
  95.     beta test any software package that I'm in the process of creating.
  96.     The beta software will be available only on the Warehouse BBS.
  97.     Also you must make arrangements with Jibben Software to get access
  98.     to the new software.  (see Technical Support section of this
  99.     document for details).
  100.  
  101. 4.  You will be able to download and upgrade your registered version
  102.     with the shareware releases of the software.
  103.  
  104.  
  105.                   Requirements for Mines of Gorr
  106.  
  107. Mines of Gorr should have at least 400KB of free memory to run.
  108.  
  109.  
  110.                        Installation Instructions
  111.  
  112. Supported BBS Systems
  113. ---------------------
  114. Mines of Gorr will support any BBS that creates a DOOR.SYS file when
  115. chaining to a door.  Also, Wildcat 2.x (CALLINFO.BBS) and PC Board -
  116. 12.x through 14.x (PCBOARD.SYS) are supported.  Systems using standard
  117. DORINFOx.DEF file (Remote Access) are supported.
  118.  
  119.  
  120. Generating the world for Mines of Gorr
  121. --------------------------------------
  122. In order to play this game you must first run the GENGORR software.
  123. GENGORR creates the mine, blacksmith shop, and other databases.  It
  124. also can be used to reset the player database.  It prompts you for each
  125. option if necessary.  This software can also be re-run to recreate all
  126. these databases to start a new game.
  127.  
  128.  
  129. Setting up Mines of Gorr with NODES.CFG
  130. ---------------------------------------
  131. First of all, you will have to edit the NODES.CFG file.  There are
  132. detailed instructions and information in this file to assist you in
  133. this process.  NODES.CFG is a simple text file that works very similar
  134. to an INI file.
  135.  
  136. Once you have the NODES.CFG updated to match your system.  You will
  137. need to create a batch file to run the game.  This is a very simple
  138. batch file.  Here is an example:
  139.  
  140. C:
  141. CD\DOORS\GORR
  142. GORR 1
  143. CD\
  144.  
  145. The important line to note is 'GORR 1'.  The '1' tells the game which
  146. node you are running.  Ideally, you will pass in the node number from
  147. an environment variable.  Below is an example of using an environment
  148. variable with the Wildcat! BBS software:
  149.  
  150. C:
  151. CD\DOORS\GORR
  152. GORR %wcnodeid%
  153. CD\
  154.  
  155. Remember to copy the ranking file(s) to the appropriate directory on
  156. your BBS if you are going to use them in bulletins.
  157.  
  158. Using the NODES.CFG file is the preferred way of setting up this door
  159. game.  If you want to handle all the setup in the batch file, please
  160. refer to Installation Instructions without NODES.CFG (next).
  161.  
  162.  
  163.           Installation Instructions without NODES.CFG
  164.  
  165. Supported BBS Systems
  166. ---------------------
  167. Mines of Gorr will support any BBS that creates a DOOR.SYS file when
  168. chaining to a door.  Also, Wildcat 2.x (CALLINFO.BBS) and PC Board -
  169. 12.x through 14.x (PCBOARD.SYS) are supported.  Systems using standard
  170. DORINFOx.DEF file (Remote Access) are supported.
  171.  
  172.  
  173. Sample Door Batch File
  174. ----------------------
  175. The door filename is placed on the command line of GORR.EXE.  Here is a
  176. sample batch file to give you an idea of how the door is called:
  177.  
  178. C:
  179. CD\DOORS\GORR
  180. GORR C:\WC\WCWORK\NODE%wcnodeid%\DOOR.SYS
  181. CD\
  182.  
  183.  
  184. Non-Standard Comm Ports
  185. -----------------------
  186. If you have a DigiBoard system or are using Fossil drivers you can
  187. still use this door game!  You will have to add another parameter to
  188. the GORR batch file.  The format of this next parameter is PORT:AAAA:X.
  189.  
  190. The following batch file would request a port using interrupt 4 at
  191. address 03F8.
  192.  
  193. C:
  194. CD\DOORS\GORR
  195. GORR C:\PCBOARD\DOOR.SYS PORT:03F8:4
  196. CD\
  197.  
  198.  
  199. The following batch file would request channel #0 (port #1) on a
  200. DigiBoard.
  201.  
  202. C:
  203. CD\DOORS\GORR
  204. GORR DOOR.SYS PORT:D:0
  205. CD\
  206.  
  207.  
  208. The following batch file would also request channel #0 (port #1) on a
  209. DigiBoard.
  210.  
  211. C:
  212. CD\DOORS\GORR
  213. GORR DOOR.SYS PORT:DP:1
  214. CD\
  215.  
  216.  
  217. The following batch file would request port #2 on a Fossil Driver.
  218.  
  219. C:
  220. CD\DOORS\GORR
  221. GORR DOOR.SYS PORT:F:2
  222. CD\
  223.  
  224.  
  225. Local Mode
  226. ----------
  227. The door can be easily tested in local mode, just use the '/local'
  228. option to run the game.  The game will then prompt you for your BBS
  229. name.
  230.  
  231. GORR /local
  232.  
  233. Also, simply typing LOCAL in the same directory as the other Mines of
  234. Gorr distribution files will start the door in local mode.
  235.  
  236.  
  237. Miscellaneous Setup Issues
  238. --------------------------
  239. Mines of Gorr supports multi-node access!  So, you can safely allow
  240. more than one node to access the door at one time.  However, you will
  241. be responsible for keeping each DOOR.SYS or related door file separate
  242. from other players files.  Make sure that DROPFILE= for each node in
  243. NODES.CFG is different.
  244.  
  245.  
  246.                               Maintenance
  247.  
  248. There is no maintenance software for Mines of Gorr!!!  It multi-tasks
  249. to perform maintenance as players are in the game.
  250.  
  251.  
  252.                       Configuration and Bulletins
  253.  
  254. Mines of Gorr has been written to be easily configured.  You can
  255. now use the MOGEDIT utility to set all these options.  However,
  256. if you want to edit it directly, included with this distribution
  257. software is a file named GORR.CFG.  It is very similar to a Microsoft
  258. Windows *.INI file.  It contains a sample configuration for the game.
  259. It also contains the documentation for the settings and what the
  260. options mean.  Please refer to this file to see how to configure your
  261. copy of Mines of Gorr.  Please examine the GORR.CFG file to determine
  262. how to set up BBS Bulletin files and the other settings for the game.
  263.  
  264.  
  265.                    Mines of Gorr Technical Info
  266.  
  267. Files
  268. -----
  269. Mines of Gorr is the second game released by Jibben Software and it
  270. takes advantage of technology created by Jibben Software called
  271. 'Resource Files'.  This technology allows a software package to contain
  272. all of it's ANSI and DOC files in a single *.RES file.  Because of the
  273. Resource File, Mines of Gorr only requires 5 files to operate even
  274. though it has over 650 ANSI and DOC files!
  275.  
  276. The only files that Mines of Gorr requires are:
  277. NODES.CFG    - Example BBS nodes configuration file.
  278. GORR.CFG     - Mines of Gorr Configuration File.
  279. GORR.EXE     - Mines of Gorr Executable.
  280. RES01.RES    - Mines of Gorr Resource File.
  281. STATS.BIN    - Mines of Gorr Statistics File, optional in
  282.                registered game.
  283.  
  284. All other distribution files may be removed to conserve disk space.
  285.  
  286. Multi-Node Issues
  287. -----------------
  288. In order for Mines of Gorr to allow multi-node access it creates
  289. temporary semaphore files.  These files always have the extension of
  290. *.SEM.  Normally these files will be removed when the player who
  291. created them exits the door.  If you are certain that no one is in the
  292. game and *.SEM files exist, you may safely delete them.
  293.  
  294. Also, a side effect of a BBS crash or similar critical event when GORR is
  295. in use is that files with no extension may exist in the GORR directory.
  296. These files always are 0 bytes for size and will have a 'random' name,
  297. usually starting with '0'.  These may be safely deleted if there are no
  298. players in the game.
  299.  
  300. Mines of Gorr also creates many types of files with the *.$$$
  301. extension.  These are mostly information files for the game as it runs.
  302. If no one is in the game, you can safetly delete them.
  303.  
  304. Finally, Mines of Gorr creates the *.SEM and *.$$$ files in the
  305. directory specified in GORR.CFG, SEMPATH option or the current
  306. directory.
  307.  
  308.  
  309. Data Files
  310. ----------
  311. Mines of Gorr creates several data files.  These files contain game,
  312. player, and ranking information.  They will always have the file
  313. extension of *.DAT.
  314.  
  315. They are:
  316. PLAYER.DAT   - Player data file.
  317. DUNGEON.DAT  - Dungeon data file.
  318. ITEMS.DAT    - Blacksmith shop datafile.
  319. MOGLOG.DAT   - Log data file. (see GORR.CFG for deleting old records.)
  320. GORRMSGS.DAT - Message data files. (see GORR.CFG for deleting old records.)
  321.  
  322.  
  323.                            Development Data
  324.  
  325. Mines of Gorr was written entirely in C++ using Borland C++ 3.1.
  326. MOGEdit was written entirely in C++ using Borland C++ 4.51.
  327.  
  328.  
  329.                        Technical Support
  330.  
  331. For technical support I (Scott Jibben) can be reached at the following
  332. on-line systems:
  333.  
  334. The Warehouse BBS:  612-379-8272  1200-14400 baud V.32bis/HST 16.8K
  335. (N81) - 10 Lines.  The Warehouse is my first (main) line of support.
  336. Since I am a co-sysop of this BBS, I usually log on several times a day
  337. to check for email.  This BBS is a subscription BBS, however anyone
  338. logging on will receive access rights to the file area where my
  339. software can be downloaded for FREE and a message area that is
  340. dedicated to my software.
  341.  
  342. My CompuServe ID is 72657,3303.  Feel free to send me an E-Mail any
  343. time.  I usually log on to CompuServe at least once a day.  This
  344. software can be found in the IBMBBS forum.
  345.  
  346. FidoNet:
  347. The Warehouse BBS is FidoNet Address, 1:282/115.  FREQ 'JSWCAT' for a
  348. catalog of Jibben Software's latest releases.
  349.  
  350. Internet:
  351. My Internet/UUCP address is: sjibben@usinternet.com
  352.  
  353.  
  354.                             Acknowledgments
  355.  
  356.  
  357. I would like to thank those people that have assisted me in the
  358. development of this software:
  359.  
  360. My wife, daughter and son, for the patient support and active
  361. involvement in this business.
  362.  
  363. Travis Carter and Scott Johnson, sysops of the Warehouse BBS, for
  364. testing the software and providing a message forum for supporting
  365. software written by me.
  366.  
  367. The people who beta tested this software on the Warehouse:
  368. Randy Bey, Tony Brown, Travis Carter, Randy Clark, David Ernwine,
  369. Richard Jacobson, Scott Johnson, Rick Kimmel, Kevin Meintsma, Brian
  370. Nyman, Rick Porter, Brynn Rogers, Dave Taraldson, Scott Vidas, and Jack
  371. Williams.  You should thank these people too, many of the features in
  372. the game are the direct result of their input.
  373.  
  374. David Cates, sysop of the Shadow Keep BBS.  The Dragon provided me with
  375. most of the ANSI screens that are used in this game.
  376.  
  377. Finally, all of the people who've registered my software.  I really
  378. appreciate it!
  379.  
  380.  
  381.                            Disclaimers, etc.
  382.  
  383.  
  384. Jibben Software specifically disclaims all other warranties, expressed
  385. or implied, including but not limited to implied warranties of
  386. merchantability and fitness for a particular purpose, functionality or
  387. data integrity.  In no event shall Jibben Software be liable for any
  388. loss of profit or any other commercial damage, including but not
  389. limited to special, incidental, consequential or other damages.
  390.  
  391.  
  392.  
  393. Borland is a registered trademark of Borland International, Inc.
  394. Microsoft Windows is a registered trademark of Microsoft Corporation.
  395. DigiBoard is a registered trademark of DigiBoard Corp.
  396.  
  397.