home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / BBS_GAME / KNG120.ZIP / SYSOP.DOC < prev    next >
Text File  |  1994-02-24  |  18KB  |  505 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                                      KINGDOM
  21.                                   Version 1.20
  22.                             ** SYSOP Documentation **
  23.  
  24.                              Last Revision: 02/24/94
  25.  
  26.  
  27.                     Find support at for Caliber Software at:
  28.                               ProTem University BBS
  29.                                  (816) 429-1751
  30.                                 1:280/71 Fido Net
  31.                                75:7816/2 Door Net
  32.  
  33.  
  34.                            Contact us at: Caliber Software
  35.                                           1406 Kingswood
  36.                                           Fulton, MO 65251
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.         KINGDOM Sysop Documentation                           Ben Vegiard
  66.  
  67.  
  68.                                ╔════════════════╗
  69.                             ▓░▒║  INTRODUCTION  ║▒░▓
  70.                                ╚════════════════╝
  71.  
  72.          Kingdom is an old classic computer game brought to the world of
  73.          BBS door games.  It is a simple economics game where the user
  74.          rules a Kingdom for 50 years.  The player starts off with a small
  75.          amount of bushels (the food and money of the game), land to plant,
  76.          and peasant workers and must manipulate these variables to produce
  77.          and thriving Kingdom.  It is actually quite a simple game, but I
  78.          have added a few new twists and some nice graphics to make things
  79.          more interesting.
  80.  
  81.          As with all Caliber Software, Kingdom is simple to configure, run,
  82.          and maintain.  It uses up a minimum of hard drive space, and is
  83.          configurable to your tastes.
  84.  
  85.  
  86.                             ╔══════════════════════╗
  87.                          ▓░▒║  WHAT YOU WILL NEED  ║▒░▓
  88.                             ╚══════════════════════╝
  89.  
  90.          - IBM Compatible Personal Computer
  91.          - Approximately 350k Free RAM space
  92.          - BBS Software that supports either DORINFOx.DEF or DOOR.SYS.
  93.          - A fossil driver such as X00 or BNU.
  94.  
  95.  
  96.                                ╔═════════════════╗
  97.                             ▓░▒║  CONFIGURATION  ║▒░▓
  98.                                ╚═════════════════╝
  99.  
  100.          It's simple.  Type up a file using you text editor by the name
  101.          KINGDOM.CFG (or just alter the one that is included) and put in
  102.          the following parameters:
  103.  
  104.          Line 1: BBS NAME
  105.          Line 2: Path and name to ASCII winners listing.  For example:
  106.                  C:\BBS\BULLETIN\BULL14.TXT
  107.                  Be sure to put the filename and DO NOT LEAVE THIS LINE
  108.                  BLANK!
  109.                  If no path is specified then OBSESSION will write the
  110.                  bulletin in the same directory where the executable file
  111.                  resides.
  112.          Line 3: Path and name to ANSI winners listing.  For example:
  113.                  C:\BBS\BULLETIN\BULL14.ASC
  114.                  Be sure to put the filename and DO NOT LEAVE THIS LINE
  115.                  BLANK!
  116.                  If no path is specified then OBSESSION will write the
  117.                  bulletin in the same directory where the executable file
  118.                  resides.
  119.          Line 4: Path and name of desired door drop file.  For example:
  120.                  C:\BBS\DORINFO1.DEF, or C:\DOORS\KINGDOM\DORINFO2.DEF, or
  121.                  C:\BBS\NODE1\DOOR.SYS.  KINGDOM supports DORINFOx.DEF and
  122.                  DOOR.SYS.
  123.  
  124.          Page 2
  125.  
  126.  
  127.  
  128.         KINGDOM Sysop Documentation                           Ben Vegiard
  129.  
  130.  
  131.          Line 5: Level of difficulty.  1 = Easy, 2 = Medeum, 3 = Hard!
  132.                  0 = Let the player choose their own level
  133.                  See OTHER NOTES for more details.
  134.          Line 6: Number of minutes the player is allowed to play in one
  135.                  day.  If this is set to 0 then the player is allowed as
  136.                  much time as he/she has left on the BBS
  137.          Line 7: No longer used.  Please leave this line blank.
  138.          Line 8: Registration Number.
  139.                  If you register your copy of KINGDOM is registered, place
  140.                  your registration number here EXACTLY as it appears.
  141.                  If you have not registered KINGDOM (yet (G)) place a 0
  142.                  here.
  143.  
  144.  
  145.                            ╔════════════════════════╗
  146.                         ▓░▒║  LET'S RUN THIS PUPPY  ║▒░▓
  147.                            ╚════════════════════════╝
  148.  
  149.          Simply set up you batch file along these lines:
  150.  
  151.          CD \BBS\DOORS\KINGDOM
  152.          KINGDOM KINGDOM.CFG
  153.          CD \BBS
  154.          BOARD
  155.  
  156.          and that should do it.  There are no mandatory command line
  157.          parameters to mess with.  Just be sure your config file is in the
  158.          same directory as your executable file or you supply a path on the
  159.          command line.
  160.  
  161.          Alternate configurations can be called from the command line.  For
  162.          example, to use a config file by the name KNGNODE2.CFG call
  163.          KINGDOM by the statement KINGDOM KNGNODE2.CFG
  164.  
  165.          Kingdom may also be called from DOS.  Use KINGDOM KINGDOM.CFG /L
  166.          to run from a DOS prompt, or to force local mode from a batch
  167.          file.  See COMMAND LINE SWITCHES below for details.
  168.  
  169.          NOTE: If no configuration file is specified then Kingdom will
  170.          default to KINGDOM.CFG as the config file name.
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.          Page 3
  188.  
  189.  
  190.  
  191.         KINGDOM Sysop Documentation                           Ben Vegiard
  192.  
  193.  
  194.                              ╔════════════════════╗
  195.                           ▓░▒║  MULTI-NODE USAGE  ║▒░▓
  196.                              ╚════════════════════╝
  197.  
  198.          KINGDOM is multi-node aware in the sense that it creates a
  199.          temperary file (LOCK.KNG) everytime it writes to the disk.  Before
  200.          anything is written to the disk KINGDOM checks for this file.  If
  201.          the file is present then it waits a until the KINGDOM game running
  202.          on another node finishes up what it is doing.  If it has to wait
  203.          too long the game aborts, assuming the game on the other node has
  204.          crashed for whatever reason.
  205.  
  206.          This little trick helps to avoid file sharing conflicts and allows
  207.          two games to run simultaneously on 2 different nodes in peaceful
  208.          harmony.
  209.  
  210.  
  211.                            ╔═════════════════════════╗
  212.                         ▓░▒║  COMMAND LINE SWITCHES  ║▒░▓
  213.                            ╚═════════════════════════╝
  214.  
  215.          A number of command line switches are supported by Kingdom.  Below
  216.          are the details of each switch.  All switches must have a
  217.          backslash (/) or a dash (-) in front of them.  For example:
  218.          KINGDOM KINGDOM.CFG  /L  would  run  kingdom  in  local  mode  (as
  219.          described below) Command line switches ARE NOT case sensitive.
  220.  
  221.          H  (or ?) displays a short help screen with all command line
  222.             options and brief descriptions.
  223.  
  224.          L  Local mode.  Using this switch forces KINGDOM will ignore
  225.             sending or receiving characters from the comport.  When called
  226.             in this manner KINGDOM will not need the use of door files
  227.             (DOOR.SYS, etc) but DOES need a config file setting.  The
  228.             program will prompt you for your name and whether you want
  229.             graphics or not, all other settings (such as time left, etc)
  230.             will default to internal settings.
  231.  
  232.          NB No Status Bar.  This switch will tell KINGDOM to default to
  233.             having the status bar turned off upon log-in.  This switch is
  234.             useful for getting a better feeling of what the user sees
  235.             without the 2 line status bar at the bottom, or in conjunction
  236.             with the NS switch will complete clear the screen.
  237.  
  238.          NS No Snoop.  This switch will turn the snoop feature off (blank
  239.             the screen while the user is in the door so you don't see what
  240.             the user is up to.)
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.          Page 4
  251.  
  252.  
  253.  
  254.         KINGDOM Sysop Documentation                           Ben Vegiard
  255.  
  256.  
  257.                                 ╔══════════════╗
  258.                              ▓░▒║  SYSOP KEYS  ║▒░▓
  259.                                 ╚══════════════╝
  260.  
  261.          Various key combinations have been included in this program.
  262.          Following is a brief description of what they are and what they
  263.          do.
  264.  
  265.          ALT-F1: Display help.  This will give a summary of the available
  266.          SYSOP keys along the bottom of the status bar.  As soon as the
  267.          next minute rolls around the normal status bar will appear.
  268.  
  269.          ALT-B : Toggle Status Bar ON/OFF.  Using this function will turn
  270.          the status bar ON/OFF.  This comes in handy if you wish to have
  271.          more of an idea what the user would be seeing (without the 2 line
  272.          status bar at the bottom of the screen)  Used in conjunction with
  273.          ALT-S it can be used to completely blank a screen.
  274.  
  275.          ALT-C : Chat Mode.  This key combination toggles chat mode.  When
  276.          chat is entered the screen is quickly memorized and re-drawn when
  277.          chat is exited.  This memorization only occurs if the user has
  278.          ANSI graphics enabled.  The re-draw feature helps the user to pick
  279.          back up where they were before the chat.  Time IS lost during
  280.          chat.  Use ALT-C again to exit chat mode.
  281.  
  282.          ALT-D : DROP TO DOS.  This function allows the SYSOP to drop to
  283.          DOS to do whatever.  The user will see nothing, and cannot
  284.          activate this function so the door is 'hack proof'  Be aware that
  285.          this program does not perform a memory swap before dropping, so a
  286.          minimum amount of memory is required.  This amount varies from
  287.          system to system, largely due to the type of software being run.
  288.          If you do not have enough memory then you will simply be returned
  289.          to the program.
  290.  
  291.          ALT-S : Toggle Snoop ON/OFF.  Some SYSOPs prefer not to watch what
  292.          a user is doing while in a door for whatever reasons.  Using this
  293.          function will clear the local screen and nothing will be written
  294.          to the local screen until ALT-S is pressed again, or until the
  295.          door is exited.  Note that the status bar will remain on unless it
  296.          has been toggled off.  This allows you to see who the user is, how
  297.          much time is left, etc.
  298.  
  299.          ALT-<UP ARROW>: Adds one minute to users time in the door (not
  300.          added to BBS time limit!)
  301.  
  302.          ALT-<DOWN ARROW>: Deducts one minute from the users time in the
  303.          door (not deducted from BBS time limit!)
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.          Page 5
  314.  
  315.  
  316.  
  317.         KINGDOM Sysop Documentation                           Ben Vegiard
  318.  
  319.  
  320.                                 ╔═══════════════╗
  321.                              ▓░▒║  OTHER NOTES  ║▒░▓
  322.                                 ╚═══════════════╝
  323.  
  324.          - A FILE NOT FOUND error message will appear when viewing a top
  325.            rankings file before anyone plays.  Kingdom doesn't create the
  326.            bulletin until someone plays a game.  It is attempting to
  327.            display the bulletin that hasn't been created yet.
  328.          - INSTRUCT.KNG may be edited, by a text editor, to meet your
  329.            needs.
  330.          - KINGDOM has three levels of play, easy, medium, and hard.  The
  331.            level setting is displayed to the user on the opening screen.
  332.            Easy simply means that it's not too hard to stay alive, but you
  333.            still need to work to make your kingdom better, Medium becomes a
  334.            struggle to keep afloat at first, and hard a almost impossible.
  335.            By placing a 0 in the config on this option you allow the player
  336.            the option of choosing their own level.  If players choose their
  337.            own level then their final score is adjusted by the level of
  338.            difficulty to reflect how well they played relative to other
  339.            levels.
  340.  
  341.  
  342.                               ╔═══════════════════╗
  343.                            ▓░▒║  HOW TO REGISTER  ║▒░▓
  344.                               ╚═══════════════════╝
  345.  
  346.          See the bottom of this section to see what you will recieve for
  347.          your registration.
  348.  
  349.          Registration is simple.  Fill out the inclosed form (FORM.DOC),
  350.          pop in a check or money order made out to Caliber Software for
  351.          the amount due.  (U.S.  Funds) and send it to the address written
  352.          on the form.  Also, comments and questions are welcome at the same
  353.          address.  Please  support  shareware  so  that  programmers  will
  354.          continue to produce quality software.
  355.  
  356.          If you have "lost" the form then send $11.00 (in U.S. Funds) to:
  357.  
  358.          Caliber Software
  359.          1406 Kingswood
  360.          Fulton, MO 65251
  361.  
  362.          Please include your BBS name (as it appears in your config file)
  363.          your BBS  phone  number(s),  your  address,  your  voice  phone
  364.          (optional) and where you got KINGDOM (friend, BBS, etc) If you are
  365.          FIDO compatible then please include your Net/Node number.
  366.  
  367.          WHAT YOU GET FOR REGISTERING: Registration will entitle you to the
  368.          latest version of KINGDOM (if you are not already using it), a
  369.          registration number for your config file that will work on all
  370.          updates and upgrades of this programs, and of course full credit
  371.          on the opening screen, and beside the castle during play.
  372.  
  373.  
  374.  
  375.  
  376.          Page 6
  377.  
  378.  
  379.  
  380.         KINGDOM Sysop Documentation                           Ben Vegiard
  381.  
  382.  
  383.                                ╔════════════════╗
  384.                             ▓░▒║  LEGAL NOTICE  ║▒░▓
  385.                                ╚════════════════╝
  386.  
  387.      This product is licensed "As is" without any warranty of
  388.      merchantability or fitness for a particular purpose, performance, or
  389.      otherwise.  All warranties are expressly disclaimed.  By using this
  390.      program you agree to that Ben Vegiard will not be liable to you or any
  391.      third party for any use, or inability to use, or performance of this
  392.      program for any damages whatsoever whether based on contract, tort, or
  393.      otherwise, even if I am notified of such possibility in advance.
  394.  
  395.      You may not reverse-engineer, disassemble, modify,  decompile or
  396.      create derivative works of this program.  Piracy has been investigate
  397.      by the FBI and prosecuted under federal statutes.  Applicable law
  398.      provides for damages and recovery of attorney's fees.  Distribution,
  399.      in any  medium,  without  its  accompanying  documentation  is  an
  400.      unauthorized modification.  That is a theft of intellectual property.
  401.  
  402.  
  403.                               ╔══════════════════╗
  404.                            ▓░▒║  SPECIAL THANKS  ║▒░▓
  405.                               ╚══════════════════╝
  406.  
  407.      I would like to thank Larry Burton of the IDEATE BBS for his help in
  408.      Beta testing KINGDOM, and for the solid ANSI suggestions.  I would
  409.      also like to give him credit for the ANSI graphic of the castle
  410.      displayed during play.
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.          Page 7
  440.  
  441.  
  442.  
  443.         KINGDOM Sysop Documentation                           Ben Vegiard
  444.  
  445.  
  446.                               ╔═══════════════════╗
  447.                            ▓░▒║  RELEASE HISTORY  ║▒░▓
  448.                               ╚═══════════════════╝
  449.  
  450.           - 01/15/92 Beta Release.
  451.  
  452.           - 03/28/92 Version 1.0:
  453.             Fixed  : 2 of the disasters did not subtract the penalties.
  454.             Fixed  : Local screen scrolled on 'Sleeping' disaster.
  455.             Fixed  : Redraw of screen workd properly after end of chat.
  456.             Changed: Some of the formulas on Easy and Hard levels to
  457.                      reflect more even scores.
  458.             Changed: (and enganced) Manu of the error messages.
  459.             Changed: Sysop and User Documentation.
  460.             Changed: Line 3 of the Config (Door drop file path) to help
  461.                      support multi-line operation better.
  462.             Added  : More natural disasters (including some GOOD ones...)
  463.             Added  : Improved command line support including the /L, /F,
  464.                      /NS, /NB, /H, and /? switches.
  465.             Added  : The Top Scores bulletin now adds in the dates when
  466.                      the scores where obtained.
  467.             Added  : Screen length support when reading instructions if
  468.                      using the DOOR.SYS door drop file.
  469.             Added  : The option to (S)top reading instructions in the
  470.                      middle of them.
  471.             Added  : Colors to the instruction screen and lightened the
  472.                      general color to accomodate monochrome users eyes.
  473.             Added  : Toggle snoop and status bar ALT keys and updated help
  474.                      line (ALT-F1) accordingly.
  475.             Added  : File locking for multi-node operations.
  476.             Added  : KING_UP.EXE file to the archive.
  477.             Added  : Wizard events on years 10, 20, 30, and 40 to make the
  478.                      game more 'interesting.'
  479.  
  480.           - 07/10/92 Version 1.1
  481.             Changed: Some of the spacings and colors, nothing major.
  482.             Changed: Software label name from Beeenware to Caliber.
  483.             Fixed  : ANSI bulletin now correctly show the propper dates.
  484.             Added  : New ANSI system which will hopefully speed the game
  485.                      displays up a bit.
  486.             Added  : Graphics toggle on main menu
  487.  
  488.           - 02/24/94 Version 1.2
  489.             Changed: a fossile driver is now required to run Kingdom.
  490.             Removed: Wizard events on year 10, 20, 30, and 40.  Player's found
  491.                      these displays annoying.
  492.             Updated: Packaging and registration forms.
  493.             Changed: Some of the settings for the easy level so that it is not
  494.                      quite so fall down easy.  Also changed some of the settings
  495.                      for the hard level so that it is not quite so impossible.
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.          Page 8
  503.  
  504.  
  505.