home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / KING804.ZIP / KING800.DOC < prev    next >
Text File  |  1992-11-27  |  18KB  |  390 lines
  1.                              King of the Board
  2.                  Copyrighted June 1988,1989,1990,1991,1992
  3.                    By Chuck Valecek - Suburban Software
  4.                                Version 8.0
  5.                              November 1, 1992
  6.  
  7. BACKGROUND
  8.  
  9.     King of the Board started about a 4 years ago as a Door written in 
  10. QuickBasic, and incorporated Door routines in DOORPATCH. Since then, 
  11. it has been modified from version 1.0 through 5.4 with suggestions 
  12. by users and Sysops. It has become very popular with PCBoards all 
  13. over the country and very popular with the users.
  14.  
  15.     The 7.0 was the first official release of the door which was completly
  16. rewritten using Turbo Pascal and ProKit Door routines. This will, I hope,
  17. satisfy those Sysops who wanted to use the door but could not, due to
  18. the newer modem speeds and system incompatibilities.
  19.  
  20.     Since the version 7 release there have been quite a few sysops that are
  21. running the door under BBS software other than PCBoard. This was a real task
  22. since the door required PCBoard files. There were converters to create the
  23. files but some sysops still had problems getting the DOOR to run correctly.
  24.  
  25.     Introducing version 8.0. This version is a complete rewrite of the 7.0
  26. version. This time it supports MOST major brands of BBS Software. A list of
  27. the supported Systems are described later in this file.
  28.  
  29. FILES
  30.  
  31. The following files are either included in the package or created by the door.
  32.  
  33. KINGxxx.EXE  The door program itself (xxx would be the version number)
  34. QUESTION.DAT Question file (included)
  35. NEXTQUES.DAT Next question (created by the door)
  36. NEW_QUES.DAT New questions entered by the users (created by the door)
  37. KINGUTIL.EXE Utility program to list users etc (included)
  38. KINGxxx.CNF  Sample config file
  39. KINGxxx      Sample batch file
  40. KING.LOG     Optional log file (created by the door)
  41. KING.HLP     Help file
  42. KINGP.HLP    Help file if using the Point version.
  43. KOBG.DAT     Sign on screen for King - Color Version
  44. QOBG.DAT     Sign on screen for Queen - Color Version
  45. KOB.DAT      Sign on screen for King - No Color
  46. QOB.DAT      Sign on screen for Queen - No Color
  47. ADOPT.DAT    Sample of a Adopt-a-door screen that can be used - No Color
  48. ADOPTG.DAT   Sample of a Adopt-a-door screen that can be used - Color
  49.  
  50.  
  51. THE DOOR
  52.  
  53.     King is a trivia game in which users try to make it up the pyramid
  54. to the top. To accomplish this, the user must challenge another user 
  55. in a position above him. The user is asked a question and if he gets 
  56. it right he changes places with the user he challenged. It's a quick 
  57. game and won't tie up your board as some games do, because the user is 
  58. asked only one question and is allowed only one play per day. He may 
  59. call back tomorrow and find himself back were he was or even further
  60. down the pyramid. If the user is beyond the playing grid (only 28 
  61. users on the grid) he can challenge only the 26th, 27th, and 28th 
  62. positions. If he is on the grid he can only challenge one of the next 
  63. three players. After the player has a turn he is asked if he would 
  64. like to enter a qustion into the game. These questions are placed in 
  65. a hold file for the sysop to review and merge into the question 
  66. file. Each time a user calls in the question is changed. The program 
  67. reads the question file sequentially so the more questions in the 
  68. file the less chance the user will get a repeat. The sysop also has 
  69. the option to limit the number of chances the user gets to answer 
  70. correctly. I use 3 and it seems to work out just fine. One sysop, I 
  71. won't mention his name, changes the number of chances, so his users 
  72. never know how many tries they get. The format of the question is 
  73. shown to the user. All alpha characters are replaced with a *, all 
  74. digits are replaced with a N and special characters (!@#$$%) are 
  75. shown as is. After each guess the user is prompted to see if he 
  76. would like to try again. If so, the correct letters are replaced so 
  77. as to give him a hint. This helps if the user is unsure of the 
  78. correct spelling. Only letters that are in the correct position are 
  79. replaced.
  80.  
  81.  
  82.    There is an option that allows the sysop to choose whether he 
  83. wants the game to use a point system. The point system assigns a 
  84. point value to the person being challenged. The points are assigned 
  85. as follows: A person 3 positions above the player is worth 2500 
  86. points. A person 2 positions above the player is worth 2000 points. 
  87. A person 1 position above the player is worth 1500 points.
  88.  
  89. If the player answers the question incorrectly the person he 
  90. challenged gets a bonus of 500 points.
  91.  
  92. If you choose to set the point option, an extra file will be created 
  93. by the door which will contain the point standings. This will only 
  94. appear if the point option is set. The user will also be asked if he 
  95. would like to review the file before the door terminates. If you 
  96. wish, this file could be copied over as a bulletin in the door batch 
  97. file.
  98.  
  99. Just add "copy kingpts c:\pcb\gen\bltnn" and "copy kingptsg c:\pcb\gen\bltnng
  100. in your batch file before you return to the board.
  101.  
  102.  
  103.  
  104.    That's about it for the door operation. It's simple yet fun!
  105.  
  106. SETUP
  107.  
  108.     Most of you out there are familiar with the setup of a door. This door 
  109. follows the standard setup of Doors.
  110.  
  111.  
  112. Since the config file has gotten so large, I have incorporated a configuration
  113. option in the KOBUTIL.EXE. It will allow you to edit or create the config file
  114. through a series of prompts. Answer the prompts and a config file will be
  115. created. You can always rerun the program to create another file or edit your
  116. existing config file. 
  117.  
  118. If you are a previous registered sysop of King of the Board your old 
  119. registration number will work with this door.
  120.  
  121.  
  122. And you thought it was hard!
  123.  
  124. Okay, now to set up a batch file for the door to run. Remember this is just like
  125. any other batch file except there is no ".BAT" extension.
  126.  
  127. The standard DOOR script for ProKit doors has this format:
  128.      echo off
  129.      cd \king
  130.      KINGxxx KINGxxx.CFG 
  131.      copy KINGPTS C:\PCB\GEN\BLT30  (Only if the points are in effect) OPTIONAL
  132.      copy KINGPTSG C:\PCB\GEN\BLT30G (Only if the points are in effect) OPTIONAL
  133.      cd \pcb
  134.      board
  135.  There is nothing else required in this batch file.
  136.  
  137.  
  138. UTILITIES
  139.  
  140. Okay, now to the new Sysops. There is a program called KINGUTIL.EXE. This 
  141. utility will display the users file, print the users file, Purge users from the users
  142. file, Verify the question file (explained later), Merge the new questions into
  143. the question file, Create a TEXT file from the question file for editing and
  144. rebuild the question file from a TEXT file. Since the question file is a
  145. encrypted file it may look like gibberish to you. Choosing the option
  146. Convert to text will allow you to use any text type editor and edit the questions
  147. or answers, and then rebuild the question file. All the options are 
  148. in LOTUS type menus. Select the option with the arrow keys and press 
  149. return.
  150.  
  151.     The questions entered by the users go into a file called NEW_QUES.DAT.
  152. This is a standard text file and can be edited with any text editor. Edit this
  153. file before merging the new questions into the question file.
  154. The format of the data is question,answer,user. That is the question followed
  155. by a comma followed by the answer followed by a comma followed by the username.
  156. As of this release all three (3) fields must be present.
  157.  
  158.  
  159.     If you convert the question file into a text file, the first line will be 
  160. the number of questions in the file. Example: 1147,0. There is no need to change 
  161. this record. Leave as it is the KINGUTIL will place the correct number of 
  162. questions in the first record. Why this record? The door creates a file called
  163. NEXTQUES.DAT that contains the number of the next question. If this number
  164. exceeds the number of questions it will reset to 2 allowing the first question
  165. to be asked. In future release this may be removed and a editor built into the
  166. KINGUTIL to accomodate editing of the questions. But for now this is the way
  167. it has to be.
  168.     
  169.     PLEASE edit your new question file!!! I have had users call me long
  170. distance to complain that they lost because of a word was entered incorrectly.
  171. This is not MY problem. It's up to you to insure that the answers are correct.
  172.  
  173.     I believe I have tried to cover most of the requirements of the programs.
  174. Sample config files, batch files and questions have been included in the 
  175. package.
  176.  
  177.  
  178.  
  179. Conversion:
  180.  
  181. DO NOT RUN DUMPQUES.EXE ON THE QUESTION FILE CONTAINED IN THIS PACKET
  182. DO NOT USE ANY PROGRAM FROM THE PREVIOUS VERSIONS, THEY WILL NOT WORK
  183.  
  184. Either create a new directory or remove all the files except the KING.USR and
  185. QUESTION.DAT, if you create a new one then copy those files in.
  186.  
  187. Run DUMPKOB.EXE - It will convert the KING.USR to a text file.
  188.  
  189. Run DUMPQUES.EXE - It will dump the question file into a text file.
  190.  
  191. Run BLDKOB.EXE - It will create a new QUESTION.DAT file and a new KING.USR
  192. file for the door.
  193.  
  194. KOBUTIL.EXE will allow you to create a new config file or you may edit your
  195. old one the choice is yours.
  196.  
  197. YOU MUST RUN THIS AS SOME OPTIONS HAVE CHANGED OR ADDED.
  198.  
  199. If you get a error from the door when it executes then the CFG file was not
  200. updated for this version of the door.
  201.  
  202. The KINGUTIL.EXE is all new so before you use any of the options make sure that
  203. the KING.USR and QUESTION.DAT file are properly backed up.
  204.  
  205.  
  206. I would recommend to all PCBoard Sysops to use the USERS.SYS file instead
  207. of the PCBOARD.SYS file. To do this go into PCBSETUP Main Conference setup.
  208. Go into the DOORS.DAT file and select the USERS.SYS file in the door setup.
  209.  
  210.  
  211.  
  212. GENERAL CONFIGURATION EXAMPLES
  213.  
  214.         EXAMPLE CONFIGURATION FILE FOR PCBOARD.SYS
  215.         ------------------------------------------
  216.  
  217.         C:\PCB\PCBOARD.SYS       <=-  (Full pathname of your PCBOARD.SYS file)
  218.         Suburban Software        <=-  (Change this to your BBS name)
  219.         Chuck                    <=-  (The Sysop's first name)
  220.         Valecek                  <=-  (The Sysop's last name)
  221.  
  222.         EXAMPLE CONFIGURATION FILE FOR USERS.SYS
  223.         ------------------------------------------
  224.  
  225.         C:\PCB\USERS.SYS         <=-  (Full pathname of your USERS.SYS file)
  226.         Suburban Software        <=-  (Change this to your BBS name)
  227.         Chuck                    <=-  (The Sysop's first name)
  228.         Valecek                  <=-  (The Sysop's last name)
  229.  
  230.         EXAMPLE CONFIGURATION FILE FOR DOOR.SYS
  231.         ---------------------------------------
  232.  
  233.         C:\BBS\DOOR.SYS          <=-  (Full pathname of your DOOR.SYS file)
  234.         Suburban Software        <=-  (Change this to your BBS name)
  235.         Chuck                    <=-  (The Sysop's first name)
  236.         Valecek                  <=-  (The Sysop's last name)
  237.  
  238.         EXAMPLE CONFIGURATION FILE FOR CALLINFO.BBS
  239.         -------------------------------------------
  240.  
  241.         C:\BBS\CALLINFO.BBS      <=-  (Full pathname of your CALLINFO.BBS file)
  242.         Suburban Software        <=-  (Change this to your BBS name)
  243.         Chuck                    <=-  (The Sysop's first name)
  244.         Valecek                  <=-  (The Sysop's last name)
  245.  
  246.         EXAMPLE CONFIGURATION FILE FOR DORINFOx.DEF
  247.         -------------------------------------------
  248.  
  249.         C:\BBS\DORINFOx.DEF      <=-  (Full pathname of your DORINFOx.DEF file
  250.                                   where 'x' is the BBS Node number.
  251.         Suburban Software        <=-  (Change this to your BBS name)
  252.         Chuck                    <=-  (The Sysop's first name)
  253.         Valecek                  <=-  (The Sysop's last name)
  254.  
  255.         EXAMPLE CONFIGURATION FILE FOR SFDOORS.DAT
  256.         ------------------------------------------
  257.  
  258.         C:\BBS\SFDOORS.DAT       <=-  (Full pathname of your SFDOORS.DAT file)
  259.         Suburban Software        <=-  (Change this to your BBS name)
  260.         Chuck                    <=-  (The Sysop's first name)
  261.         Valecek                  <=-  (The Sysop's last name)
  262.  
  263.         EXAMPLE CONFIGURATION FILE FOR CHAIN.TXT
  264.         ----------------------------------------
  265.  
  266.         C:\BBS\CHAIN.TXT        <=-  (Full pathname of your CHAIN.TXT file)
  267.         Suburban Software       <=-  (Change this to your BBS name)
  268.         Chuck                   <=-  (The Sysop's first name)
  269.         Valecek                 <=-  (The Sysop's last name)
  270.  
  271.  
  272. NOTE: This Door supports COM 1-4 on the standard IRQ's - COM1/COM3 = IRQ4 and
  273.       COM2/COM4 = IRQ3. If you wish to use a non-standard IRQ, add the IRQ
  274.       number after the configuration filename. Let's assume your Door is
  275.       called KING and you want to use COM1 and IRQ5. The command line
  276.       passed to your Door would be:
  277.         KING KING.CFG /5
  278.         or  KING KING.CFG /%IRQ%  for the environment variable.
  279.       The /5 tells the Door to use IRQ5 rather than the standard IRQ4 that
  280.       is normally used with COM1. No /x parameter is needed for the standard
  281.       IRQ's.
  282.  
  283.                               ==============
  284.                      ------------------------------------
  285.  
  286.                                 DOOR OPERATION
  287.                                 --------------
  288.   
  289.   F3    -   Toggles the printer On/Off.
  290.             Value is passed to PCBoard.
  291.   F4    -   Toggles the Page Bell On/Off.
  292.             Value is passed to PCBoard.
  293.   F5    -   DOS Shell.  Allows SysOp to exit to DOS from inside a DOOR.
  294.   F7    -   Toggles the Caller Alarm On/Off.
  295.             Value is passed to PCBoard.
  296.   F8    -   Returns the caller involuntarily to PCBoard.
  297.             Without letting them know that the sysop called them back!
  298.   F9    -   Toggles the local display On/Off.
  299.             Value is passed to PCBoard.
  300.   F10   -   Activates SysOp CHAT mode within the DOOR.
  301.  
  302.   ESC   -   Deactivates CHAT mode.  DOOR is resumed.
  303.   HOME  -   HELP key for status line options.
  304.   UP    -   Allows the SysOp to temporarily give the caller extra time
  305.             while in the DOOR.  This time is NOT passed to PCBoard.
  306.   DN    -   Allows the SysOp to temporarily subtract time from the
  307.             caller while in the DOOR.  This time is NOT passed to PCBoard.
  308.   ALT-N -   SysOp next on toggle.
  309.             Value is passed to PCBoard.
  310.   ALT-X -   PCBoard will exit after current caller logs off.
  311.             Value is passed to PCBoard.
  312.  
  313.                             WATCHDOG/CTTY/ANSI.SYS
  314.                             ----------------------
  315.  
  316.         CTTY and WATCHDOG are not required and should not be used with
  317.         this program.  The Door contains its own communication routines
  318.         which monitor the COM port.  If carrier is lost, it will return
  319.         to system where the BBS will log the user off the system.
  320.         ANSI.SYS, or something similar, is required for the door to
  321.         function properly!
  322.  
  323. Thats it for now
  324.  
  325.     I would like to take a few lines and thank those who made this 
  326. door possible: Clark Development for writing the BEST BBS program 
  327. out, Ted Freeman for doing such a GREAT job on the routines used in 
  328. this door and to all of you that have taken the time to register the 
  329. door and have added suggestions to the door. 
  330.  
  331.     And a special Thanks to Howard Hartman of Network East, Heather Broadhurst 
  332. for the edited question file, Israel Silverman, Sysop of The Round Table BBS
  333. for editing this doc file so it is more "readable" and to all the sysops who 
  334. have help me test the beta release and for thier suggestions.
  335.  
  336.    If you have an idea that you would like to see turn into a door. Drop me a 
  337. line and we can discuss your ideas. And maybe turn it into a door!!
  338.  
  339.  
  340. REGISTRATION
  341.  
  342.     If you wish to register the door it would be greatly appreciated. For a
  343. mere $20.00 you can get rid of that stupid message <EVALUATION COPY> and
  344.  
  345.     $$$$ Please help the sysop Register this door $$$ 
  346.    
  347.     I will contact you by BBS or mail you the latest version of the door along
  348. with a registration number. This number will turn off the messages and allow
  349. your BBS name to be displayed on the opening and closing screens. As I stated 
  350. before this door is not Crippled in any way or form and will run forever even
  351. if you did not register it. All monies received go back to other Door Authors
  352. for their doors that run on my system.
  353.  
  354.    I always have a open door for sysops on my board. Sign in and go into my
  355. Support Confrence and you will find the latest version of my doors there
  356. for downloading.
  357.  
  358.     Please if you have a problem with setting it up or find a bug (?) Don't 
  359. call Salt Air and gripe about it, call my board and you will get a FASTER
  360. response. I know there are some Sysops out there that can vouch for this. I
  361. called many Sysops voice and tried to help them out at my expense, even before
  362. they registered the door.
  363.  
  364.     If you are a Author of a door and want to exchange registered copies let
  365. me know. We can work out something!! I may even throw my kids into the deal!
  366.  
  367. OH! One more thing. If you have any suggestions, please drop me a line. Please
  368. direct all complaints about the door to my wife, I am trying to get even with
  369. here!!!
  370.  
  371. All the changes to the door in the past years have been suggestions made by 
  372. sysops who have registered the door. I will review all suggestions and if they
  373. have any merit I will incorporate them in the next release or so. If time
  374. permits I will compile a list of suggestions that have not yet made it into 
  375. the code for you to review and voice your opinion on.
  376.  
  377. Okay here is the address to send the MILLIONS!!
  378.  
  379. Chuck Valecek
  380. Suburban Software
  381. P. O. Box 368
  382. Oak Lawn, IL 60454
  383.  
  384. (708)-636-6694 (Node 1) (708)-636-6697 (Node 2) USR HST 19200
  385.  
  386. Effective November 1989 our area code was changed from 312 to 708 so please make
  387. a note of it. Oh! Please make the checks or money order payable to me NOT
  388. Suburban Software. Believe it or not my bank won't cash them unless I open a 
  389. business account.
  390.