home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / DOOR / CAS-125.ZIP / SYSOP.DOC < prev   
Text File  |  1996-03-26  |  19KB  |  660 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.                             C A S T L E   S I E G E
  22.  
  23.                               Sysop Documentation
  24.  
  25.                                  Version 1.25
  26.  
  27.                  Copyright (c) 1993-96 by W & W Communications
  28.  
  29.                         Written by Peter R. Woodmansee
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.                                 Distributed by
  38.  
  39.                              W & W Communications
  40.  
  41.                                The Holodeck BBS
  42.  
  43.                                 (408) 261-1313
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.     Castle Siege                                                      Page i
  60.     ───────────────────────────────────────────────────────────────────────
  61.  
  62.                        T A B L E   O F   C O N T E N T S
  63.  
  64.       1.0 Introduction . . . . . . . . . . . . . . . . . . . . . . . . .  1
  65.  
  66.       2.0 Registration . . . . . . . . . . . . . . . . . . . . . . . . .  2
  67.  
  68.          2.1 Limitations in the Evaluation Copy  . . . . . . . . . . . .  2
  69.  
  70.       3.0 Installing and Executing Castle Siege  . . . . . . . . . . . .  3
  71.  
  72.          3.1 Option: -Node . . . . . . . . . . . . . . . . . . . . . . .  4
  73.          3.2 Option: -DropFile . . . . . . . . . . . . . . . . . . . . .  4
  74.          3.3 Option: -Fossil . . . . . . . . . . . . . . . . . . . . . .  5
  75.          3.4 Option: -ComPort. . . . . . . . . . . . . . . . . . . . . .  5
  76.          3.5 Option: -Initialize . . . . . . . . . . . . . . . . . . . .  5
  77.          3.6 Option: -Reset  . . . . . . . . . . . . . . . . . . . . . .  5
  78.  
  79.       4.0 Ram Disk Support . . . . . . . . . . . . . . . . . . . . . . .  6
  80.  
  81.       5.0 Configuration File . . . . . . . . . . . . . . . . . . . . . .  7
  82.  
  83.       6.0 Sysop Message File . . . . . . . . . . . . . . . . . . . . . .  8
  84.  
  85.       7.0 Sysop Controls . . . . . . . . . . . . . . . . . . . . . . . .  9
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.     ───────────────────────────────────────────────────────────────────────
  120.      Castle Siege                                        W & W Communications
  121.     Castle Siege                                                      Page 1
  122.     ───────────────────────────────────────────────────────────────────────
  123.  
  124.       1.0 Introduction
  125.       ════════════════
  126.  
  127.       Welcome to Castle Siege .
  128.  
  129.       Castle Siege is a game of adventure and conquest.  The object of the
  130.       game is to conquer the Castle.  In order to do this you must defeat
  131.       the Giant Cyclops who is guarding the entrance to the Castle.  Each
  132.       player must not only find the location of the Castle but also build
  133.       his forces up to a point where he stands a chance of surviving the
  134.       encounter with the Cyclops.
  135.  
  136.       Beware... Enemy warriors as well as other players also are roaming the
  137.       rooms.  Encounters with them will be many and often.  Treasures such
  138.       as gems and gold can be found laying around as well as buried beneath
  139.       the ground.  Enemy warriors also carry various items.  Some of these
  140.       include gems, gold, food, magic potions, and magic scrolls.
  141.  
  142.       All of this is COMPLETELY MULTINODE-REALTIME-INTERACTIVE.  This way
  143.       (on a multinode bbs) you can actually battle with others online at
  144.       the same time... or help each other in a battle against a tough group
  145.       of enemy warriors.
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.     ───────────────────────────────────────────────────────────────────────
  180.      Castle Siege                                        W & W Communications
  181.     Castle Siege                                                      Page 2
  182.     ───────────────────────────────────────────────────────────────────────
  183.  
  184.       2.0 Registration
  185.       ════════════════
  186.  
  187.       Castle Siege is distributed as an Evaluation Copy.  Please read and
  188.       return the registration form in REGISTER.DOC.  Also be sure that you
  189.       have a recent version of the registration form.  Each form is dated
  190.       at the top with an expiration date.  This date is there mainly to
  191.       make sure you have a recent version of the software.  If your form is
  192.       out of date you should call The Holodeck BBS (408) 248-0869 and get
  193.       the most recent form as well as checking for a more recent version
  194.       of this door.  All of our doorware products can be downloaded by
  195.       going to our FILE MENU and selecting the "W" option.  A complete
  196.       list will be presented to you.  You can also FREQ any of our files
  197.       at 1:143/129.  FREQ 'FILES' for a complete list of our doorware
  198.       products.
  199.  
  200.       When you register, you will be given a small file to put into
  201.       your Castle Siege directory.  It will be named CASTLE.COD.
  202.       This file will enable the various features that did not work in the
  203.       Evaluation Copy.
  204.  
  205.       Make sure you keep a copy of the file in a safe place, since it will
  206.       be used with future versions as well.
  207.  
  208.  
  209.          2.1 Limitations in the Evaluation Copy
  210.          ──────────────────────────────────────
  211.  
  212.          The Evaluation Copy of this game has some limitations.  These
  213.          limitations are to encourage the registration of the game. If you
  214.          and your users enjoy the game, you should register it.
  215.  
  216.          1)  Unregistered copies will use the DEFAULT values in the CASTLE.CFG
  217.              file. Once you register the game you will be able to modify these
  218.              values in order to customize Castle Siege for your bbs.
  219.          2)  Unregistered copies will not display the sysop.msg file.
  220.              (this file is described in section 5.0)
  221.          3)  Unregistered copies will only allow players to advance to
  222.              an experience level of 8.
  223.  
  224.  
  225.          If you and your users enjoy playing Castle Siege please consider
  226.          showing your support by registering your copy.  Once registered,
  227.          you will be able to customize the game by modifying your config file.
  228.          No re-initialization will be necessary unless you decide to increase
  229.          the MAX_PLAYERS variable.
  230.  
  231.          Thanks in advance for your support!
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.     ───────────────────────────────────────────────────────────────────────
  240.      Castle Siege                                        W & W Communications
  241.     Castle Siege                                                      Page 3
  242.     ───────────────────────────────────────────────────────────────────────
  243.  
  244.       3.0 Installing and Executing Castle Siege
  245.       ═══════════════════════════════════════════
  246.  
  247.       To install Castle Siege on your system, use the INSTALL program
  248.       supplied with the package.  If you have an authorization file,
  249.       copy it into the Castle Siege directory.  Once you have installed
  250.       Castle Siege via our installation program just type:
  251.                         CASTLE -INITIALIZE
  252.       from the castle subdirectory.  This will build all of the subdirectories
  253.       and files needed for the game to run.  Initializing the game is only
  254.       required one time, but you can do it as often as you like.  Each time
  255.       you initialize the game all users are deleted and scores are reset.
  256.       If you are using a RAM DISK, note that -initialize will initialize
  257.       your MASTER files (the ones on your hard drive, NOT the ram disk)
  258.  
  259.       That's all there is to it!
  260.  
  261.       LOCAL MODE:
  262.       -----------
  263.       You can now execute the game in local mode by typing:
  264.  
  265.       CASTLE
  266.  
  267.       at the DOS prompt.  To run it with your BBS, you will need to have a
  268.       batch file do the following (this batch file is automatically created
  269.       for you by the install program):
  270.  
  271.       A. Change to the Castle Siege directory.
  272.  
  273.       B. Execute the game.  The format for this is:
  274.  
  275.  
  276.            CASTLE <options>
  277.  
  278.          Where <options> is one or more of the options listed below.
  279.          Each option starts with a dash (-) and is followed by one or
  280.          more characters specifying which option you want (case does not
  281.          matter).  If an option takes a parameter, follow the option
  282.          name with an equal sign (=) and then the parameters for
  283.          that option.  No spaces are allowed to separate the option from
  284.          its parameters!  For example:
  285.  
  286.             CASTLE -Node=1      <--- CORRECT FORMAT
  287.  
  288.          is allowed, however,
  289.  
  290.             CASTLE -Node = 1     <--- BAD FORMAT
  291.  
  292.          is not.
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.    ───────────────────────────────────────────────────────────────────────
  300.     Castle Siege                                        W & W Communications
  301.    Castle Siege                                                      Page 4
  302.    ───────────────────────────────────────────────────────────────────────
  303.  
  304.  
  305.       3.1 Option: -Node
  306.       ─────────────────
  307.       This option is REQUIRED if you want to run Castle Siege with a BBS.
  308.       It takes the node number as its parameter.  If the BBS only has one
  309.       node, use 1.  Example:
  310.  
  311.          -Node=1
  312.  
  313.       3.2 Option: -DropFile
  314.       ─────────────────────
  315.       This option is REQUIRED if you want to run Castle Siege with a BBS.
  316.       It takes the path to the information file your BBS creates for doors
  317.       as its parameter.  The following BBS types are supported:
  318.  
  319.          Generic DOOR.SYS        --> any BBS which generates DOOR.SYS
  320.          GAP                     --> generates DOOR.SYS
  321.          PCBoard                 --> generates PCBOARD.SYS
  322.          Quick BBS / RBBS        --> generates DORINFOx.DEF
  323.          Spitfire (door menu)    --> generates SFDOORS.DAT
  324.          Spitfire (file menu)    --> generates SFFILE.DAT
  325.          Spitfire (main menu)    --> generates SFMAIN.DAT
  326.          Spitfire (message menu) --> generates SFMESS.DAT
  327.          Wildcat! 2.x or lower   --> generates CALLINFO.BBS
  328.          Wildcat! 3.x            --> generates DOOR.SYS
  329.          WWIV                    --> generates CHAIN.TXT
  330.  
  331.       Example:
  332.  
  333.             -DropFile=C:\SF\NODE1\SFDOORS.DAT
  334.  
  335.       If you are running a BBS type not specifically supported here and
  336.       you have the format of the door file it produces, feel free to
  337.       contact us and share your information -- we will most likely add
  338.       that BBS type for future versions.
  339.  
  340.       3.3 Option: -Fossil
  341.       ───────────────────
  342.       This option has no parameters.  If you include it on the command
  343.       line, Castle Siege will attempt to use a FOSSIL driver rather than
  344.       its own internal comm handlers for communications.  If no FOSSIL
  345.       driver is loaded, an error will be generated and Castle Siege will
  346.       exit.  Currently supported FOSSIL drivers are X00 & BNU.  Example:
  347.  
  348.          -Fossil
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.    ───────────────────────────────────────────────────────────────────────
  360.     Castle Siege                                        W & W Communications
  361.    Castle Siege                                                      Page 5
  362.    ───────────────────────────────────────────────────────────────────────
  363.  
  364.       3.4 Option: -ComPort
  365.       ────────────────────
  366.       This option allows you to specify the exact COM port configuration
  367.       for Castle Siege to use.  Two items are required as parameters for
  368.       this option, separated by a comma:  the base address of the COM port
  369.       (in hex, prefixed with 0x) and the IRQ number to use.  Example:
  370.  
  371.          -ComPort=0x3F8,4
  372.  
  373.       3.5 Option: -Initialize
  374.       ───────────────────────
  375.       This option has no parameters.  It initializes the game.
  376.       For Castle Siege it will build all of the subdirectories
  377.       and files needed for the game to run.  Initializing the game is only
  378.       required one time, but you can do it as often as you like.  Each time
  379.       you initialize the game all users are deleted and scores are reset.
  380.  
  381.  
  382.       3.6 Option: -Reset
  383.       ──────────────────
  384.       Don't get this command confused with -INITIALIZE.  -Initialize will
  385.       complete reinitialize the game (start it from scratch), while -RESET
  386.       will merely reset the INUSE and INGAME flags in the player records.
  387.  
  388.       If you ever have a player enter the game and have the Castle Siege tell
  389.       them that they are already in the game, you will need to use this option.
  390.       This could be the result of a power failure or system crash while a user
  391.       is in the game.
  392.       CASTLE -RESET
  393.       tells Castle Siege to reset all of the 'inuse' and 'ingame' flags.
  394.       If you are using the RAM DISK option the -reset will reset the
  395.       players.dat file in your ram disk, not the hard drive.
  396.  
  397.       ONLY USE THIS OPTION WHEN NO ONE IS IN THE GAME.
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.     ───────────────────────────────────────────────────────────────────────
  419.      Castle Siege                                        W & W Communications
  420.     Castle Siege                                                      Page 6
  421.     ───────────────────────────────────────────────────────────────────────
  422.  
  423.       4.0 Ram Disk Support
  424.       ════════════════════
  425.  
  426.       Castle Siege now supports the use of a Ram Disk (as of version 1.25).
  427.       In the config file, CASTLE.CFG, there is a parameter labeled DATAFILES.
  428.       All of the MAPS along with the EMEMY.DAT, PLAYERS.DAT and TALKING.DAT
  429.       can exist in a ramdisk for quicker disk access during the game.
  430.       LEAVE THIS OPTION BLANK (i.e. DATAFILES = ) IF YOU DON'T PLAN ON USING
  431.       A RAM DISK.
  432.  
  433.       As an example, lets say you have a ramdisk set up as drive F with
  434.       a subdirectory called Castle for the games files.
  435.       In the CASTLE.CFG file you would have:
  436.           DATAFILES = F:\CASTLE
  437.       You would also want to create a MAPS subdirectory from within the Castle
  438.       subdirectory.  This is where all of the maps will reside.
  439.       You will most likely want to have a batch file set up to copy all of
  440.       the maps from your harddrive (lets assume for this example that you
  441.       originally set up a Castle subdirectory on your C drive. (C:\CASTLE)
  442.       Your batch file would look something like:
  443.           Copy c:\castle\maps\*.* f:\castle\maps
  444.           Copy c:\castle\players.dat f:\castle
  445.           Copy c:\castle\enemy.dat f:\castle
  446.     (you don't need to copy talking.dat over, as it will be created each time)
  447.  
  448.       Now whenever a player is in the game (assuming you have the
  449.       DATAFILES = F:\CASTLE in your castle.cfg) the game will read/write
  450.       to and from the files on your ramdisk.  This should significantly
  451.       increase the games overall speed, especially on systems which have
  452.       slow hard drives or are running in a multitasking environment.
  453.  
  454.       -------------
  455.       !!!WARNING!!!
  456.       -------------
  457.  
  458.       If you turn your computer off, or if your system crashes and you lose
  459.       your ramdisk, ALL data WILL be lost.  I suggest coping the ramdisk
  460.       files back over to your hard drive at least once per day to ensure
  461.       minimal loss if you should lose your ramdrive.
  462.  
  463.  
  464.       Also note that during a CASTLE -INITIALIZE your ramdisk files will
  465.       not be used.  Only the files on your hard drive will actually be
  466.       initialized.  It is up to you, after initializing a game, to copy
  467.       the appropriate files over to the ramdisk.
  468.  
  469.  
  470.       If you do a CASTLE -RESET, the players.dat file on your ram disk will
  471.       be the one reset.  A reset does not restart a game, it merely resets
  472.       some flags in the player records.  See -Reset for more info.
  473.  
  474.  
  475.  
  476.  
  477.     ───────────────────────────────────────────────────────────────────────
  478.      Castle Siege                                        W & W Communications
  479.     Castle Siege                                                      Page 7
  480.     ───────────────────────────────────────────────────────────────────────
  481.  
  482.       5.0 Configuration File
  483.       ══════════════════════
  484.  
  485.       The Castle Siege configuration file should be located in the same
  486.       directory as Castle Siege and is used to control various aspects
  487.       of the game. It should be named CASTLE.CFG and a sample has been included
  488.       in this packet of files.  Inside the file, lines which start with a
  489.       pound sign (#) are considered comments.  Each configuration line is
  490.       made up of a keyword, an equal sign, and a value to assign to the
  491.       keyword.  Please refer to the CASTLE.CFG file for descriptions of
  492.       each keyword.
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.     ───────────────────────────────────────────────────────────────────────
  538.      Castle Siege                                        W & W Communications
  539.     Castle Siege                                                      Page 8
  540.     ───────────────────────────────────────────────────────────────────────
  541.  
  542.       6.0 Sysop Message File
  543.       ══════════════════════
  544.  
  545.       Registered versions of Castle Siege support a Sysop Message File.
  546.       A Sysop Message File is an ASCII file that will be displayed to the
  547.       players just prior to the Castle Siege main menu.  The file must be
  548.       named 'SYSOP.MSG'.  If the file exists in the Castle Siege subdirectory,
  549.       it will be displayed to the players.  There is no limit to the length
  550.       of the Sysop.msg file.
  551.  
  552.       If 'Sysop.msg' does not exist or if you are running a non-registered
  553.       version of Castle Siege, nothing will be displayed.
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.     ───────────────────────────────────────────────────────────────────────
  598.      Castle Siege                                        W & W Communications
  599.     Castle Siege                                                      Page 9
  600.     ───────────────────────────────────────────────────────────────────────
  601.  
  602.       7.0 Sysop Controls
  603.       ══════════════════
  604.  
  605.       The Sysop has the following set of functions available:
  606.  
  607.          (local keyboard only)
  608.  
  609.          ALT-C or F10      Initiate CHAT mode.
  610.  
  611.          ALT-J or ALT-D    Jump to DOS.
  612.  
  613.          Up Arrow          Increase user's remaining time by five minutes.
  614.  
  615.          Down Arrow        Decrease user's remaining time by five minutes.
  616.  
  617.          Left Arrow        Decrease user's remaining time by one minute.
  618.  
  619.          Right Arrow       Increase user's remaining time by one minute.
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.     ───────────────────────────────────────────────────────────────────────
  655.      Castle Siege                                      W & W Communications
  656.     ───────────────────────────────────────────────────────────────────────
  657.  
  658.  
  659.  
  660.