home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / WCSUNO20.ZIP / WCSUNO.DOC < prev    next >
Text File  |  1995-06-20  |  20KB  |  487 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.      _____________________________________________________________________
  19.  
  20.  
  21.  
  22.  
  23.                                  WCS Uno v2.0
  24.                                         
  25.                                   Written by
  26.  
  27.                                  Rob Williams
  28.                                  WCS Software
  29.  
  30.  
  31.      _____________________________________________________________________
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.                           
  53.                             Copyright Notice
  54.                             ----------------
  55.  
  56.      This door game is distributed under the SHAREWARE concept.  This
  57.      concept gives you the chance to "try before you buy", and see if it
  58.      meets your needs.  
  59.  
  60.      I've decided to break away from the standard "30 day trial period"
  61.      that many door authors are using and instead go to a much simpler
  62.      and more realistic policy. This is simply; Try it on your BBS.
  63.      If you like it and your users like it, then register it.  If it's not 
  64.      good enough to register, then delete it.  
  65.  
  66.      While I'd like you to register my doors as soon as possible, I'm also 
  67.      realistic enough to know that different boards have different requirements
  68.      and interests, and sometimes it takes longer befor a game catches on, or a
  69.      sysop can get to the Doors on his list to register.  And frankly, I'd 
  70.      rather you ran it for awhile and register, than try it for a short 
  71.      period of time and delete it. Nobody wins that way...I lose out on a 
  72.      registration and your users lose out on the chance of having the 
  73.      registered door to play.
  74.  
  75.      The above "extended trial" statement was copied with permission from
  76.      Mike Jordan of M&S Doors.
  77.  
  78.      As a shareware  program, WCS Uno may be freely distributed.
  79.      Shareware distributors may distribute copies of WCS Uno on disk
  80.      for a modest disk duplication charge not to exceed $4 per disk.
  81.  
  82.  
  83.  
  84.                                     Warranty
  85.                                     --------
  86.  
  87.      WCS Uno is distributed on as as is basis.  In no event will
  88.      Rob Williams or WCS Software be liable to you for damages, including 
  89.      any loss of profits, lost savings, or other incidental or  
  90.      consequential damages arising out of your use of or inability to use 
  91.      this program, even if Rob Williams, WCS Software, or an authorized 
  92.      representative has been advised of the possibility of such damages.  
  93.      Rob Williams and WCS Software will not be liable for any such claim 
  94.      by any other party.
  95.  
  96.  
  97.                           Features of WCS Uno
  98.                           -------------------
  99.  
  100.      WCS Uno is fully InterBBS capable, with very little attention
  101.      needed from the sysop.  Automatic messaging to/from the game hub
  102.      in Fido standard *.MSG format messages with file attachments.
  103.  
  104.      Assembly language serial input/output routines for maximum speed.
  105.  
  106.      Fully supports high speed modems: 16550 FIFO buffering and locked
  107.      serial ports.
  108.  
  109.      Built in ANSI terminal emulator.  No need to have ANSI.SYS loaded in
  110.      memory.
  111.  
  112.      DesqView, Windows, and OS/2 aware.
  113.  
  114.      Supports all of the most popular door data file formats:
  115.      TriBBS, PCBoard, GAP  (DOOR.SYS), Spitfire, WildCat!,  RBBS, and WWIV.
  116.  
  117.      ANSI and ASCII Bulletins of high scorers.
  118.  
  119.      Automatic maintenance with no intervention from the Sysop.
  120.  
  121.      Supports play ahead and make up days when registered.  This is
  122.      completely sysop configurable.
  123.  
  124.      WCS Uno is Multinode Aware!
  125.  
  126.  
  127.                          Files used in the Program
  128.                          -------------------------
  129.  
  130.      WCSUNO.EXE    -   The main WCS Uno program
  131.  
  132.      REGISTER.FRM  -   Information on registration
  133.  
  134.      SAMPLE.CFG    -   Sample configuration file
  135.  
  136.      SAMPLE.BAT    -   Sample batch file to run WCS Uno
  137.  
  138.      HISCORE.DAT   -   Created when the program runs-contains hi score info
  139.  
  140.      UNOUSER.DAT   -   Created when the program runs-contains user info
  141.  
  142.      WCSUNO.KEY    -   Key file for registered versions
  143.  
  144.      WCSUNO.USE    -   Created when the game is running, will be deleted
  145.                        when the user exits normally.
  146.                        (only in single user/non-registered versions)
  147.  
  148.      *************************************************************************
  149.      ** IMPORTANT - The game will not run if this file (WCSUNO.USE) exists **
  150.      *************************************************************************
  151.  
  152.      WCSUNO.HLP    -   Help file for the game.  When the Instructions option
  153.                        is selected, this file is displayed.  You may edit
  154.                        this file if you wish.  It is a plain ASCII text file.
  155.  
  156.      WCSUNO.HIS    -   History of the product.  Shows what enhancements were
  157.                        made in what version.
  158.  
  159.      WCSINFO.TXT   -   A text file explaining more about WCS Software and
  160.                        showing all currently available WCS Software programs.
  161.  
  162.      READ.ME       -   A brief text file explaining how to get up and running
  163.                        quickly.
  164.  
  165.      NOBEEP        -   If this file exists in the game directory, the game
  166.                        not make noises when you play it (either remotely or
  167.                        locally)  Good for those sysops who play games locally
  168.                        late at night <grin>.
  169.  
  170.      INTERBBS.DOC  -   A document explaining how to set up WCS Uno to
  171.                        run in an InterBBS League.
  172.  
  173.      *****  IT IS VERY IMPORTANT TO READ THIS FILE FULLY BEFORE ATTEMPTING
  174.      *****  TO RUN WCS UNO IN AN INTERBBS LEAGUE.
  175.      *****  YOU SHOULD ALSO BE WELL VERSED IN FIDO TERMINOLOGY.
  176.  
  177.      DBRIDGE.HLP   -   Help file for people running D'Bridge mailers.  Also
  178.                        helpful as a fallback if you have problems getting
  179.                        the score files automatically processed.
  180.  
  181.  
  182.                            Setting up WCS Uno
  183.                            -------------------
  184.  
  185.      WCS Uno is run by  entering a command similar to the
  186.      following:
  187.       
  188.      WCSUNO WCSUNO.CFG
  189.  
  190.      The configuration file can have any name you choose, but it must
  191.      reside in the same directory as the door.  The configuration file is
  192.      an ASCII text file with the following format:
  193.  
  194.      Line 1:   Door data file type.
  195.      Line 2:   Path to the door data file(s).
  196.      Line 3:   BBS name.
  197.      Line 4:   Sysop's name.
  198.      Line 5:   Locked baud rate.
  199.      Line 6:   ASCII High Score Bulletin Name
  200.      Line 7:   ANSI High Score Bulletin Name
  201.      Line 8:   File name to write comments to
  202.      Line 9:   Number of Games per day
  203. *    Line 10:  Number of extra days allowed for make up days
  204. *    Line 11:  Day to start playing make up days-31 to disable
  205.      Line 12:  Write log files (explained below)
  206. *    Line 13:  Line to display a message (donated by, etc)
  207.      Line 14:  Name of the computer opponent
  208.      Line 15:  InterBBS Play (Y or N)
  209.  
  210.      Lines with a "*" to the left indicate features only present in the
  211.      registered version of the program.  *** The lines must be present,
  212.      even if the door is not registered. ***
  213.  
  214.      As illustrated above, the door's data file type is specified in line 1
  215.      and can be PCB for PCBoard, GAP for GAP (DOOR.SYS), SF for Spitfire,
  216.      RBBS for RBBS, WC for WildCat!, TRIBBS for TriBBS, or WWIV for WWIV.
  217.      The locked baud rate is specified in line 5.  If you don't lock your
  218.      serial port, you must specify 0 for the locked baud rate.
  219.      The following is a sample door configuration file:
  220.  
  221.      ************************************************************************
  222.      ** IMPORTANT - If you are running WC 4.x, use the GAP drop file       **
  223.      ************************************************************************
  224.  
  225.      WC                             <== BBS Type
  226.      C:\WC30\WCWORK\NODE1           <== Drop file location
  227.      WCS Software BBS               <== BBS Name
  228.      Rob Williams                   <== Sysop Name
  229.      0                              <== Locked baud rate
  230.      C:\WC30\BULL\BULL10.BBS        <== ASCII bulletin
  231.      C:\WC30\BULL\BULL10.SCR        <== ANSI bulletin
  232.      C:\WC30\COMMENTS.DRS           <== File name to write comments to
  233.      10                             <== # of questions per day
  234.      2                              <== Extra days allowed for make up days
  235.      10                             <== Day to start make up days
  236.      A                              <== Write a log file (See Below)
  237.      By WCS Software                <== Donated by line
  238.      Joe                            <== Computer opponents name
  239.      Y                              <== InterBBS Play
  240.      ************************************************************************
  241.      ** IMPORTANT - Even if the game is not registered, the last  three    **
  242.      ** lines must exist, or the game will not run.  You will get an error **
  243.      ** when the game starts up.                                           **
  244.      ************************************************************************
  245.  
  246.      On line 12, the valid options for a log file are:
  247.         - P for Play log ONLY  (WCSUNO.nodenumber)
  248.         - N for No logs
  249.         - C for Comments log ONLY (COMMENTS.MSG)
  250.         - A for ALL Logs (play log and comment log)
  251.  
  252.      WCS Uno can be run locally without a door data file (handy
  253.      for the sysop to use the door without logging on to the BBS) by
  254.      specifying /L after the  configuration  file  parameter in  the  DOS
  255.      command line.  WCS Uno will request you to enter your name before
  256.      running the door.
  257.  
  258.      To play the game in Multiuser mode, you must have a registered multinode 
  259.      copy,and DOS SHARE must be loaded.  If these two things are not done,  
  260.      the game will display a message if you try to run multinode.
  261.  
  262.      Nonstandard IRQs can be used by specifying the IRQ number after the 
  263.      "config" parameter in the command line used to run the door as
  264.      follows:
  265.  
  266.      WCSUNO WCSUNO.CFG 4
  267.  
  268.               Setting up WCS Uno for Multinode Play
  269.               --------------------------------------
  270.  
  271.     In order to set WCS Uno up for multinode play, you need to create a
  272.     .cfg file for each node that will be using the game.  The .cfg files
  273.     will be similar, except that lines 2 and possibly 5 will be different.
  274.     Line 2 is the location of the door drop file.  This needs to be unique
  275.     for each node that runs the game.  Line 5 is the locked baud rate for
  276.     the node.  If you have nodes that are locked at different rates, then
  277.     this line may be different for different nodes.  For example, the
  278.     configuration file for node 1 (WCSUNO.CF1) might look like this:
  279.  
  280.       GAP
  281.       H:\WILDCAT\WCWORK\NODE1     <=== Notice this is the node 1 directory
  282.       Williams Computer Services BBS
  283.       Rob Williams
  284.       19200
  285.       [etc].....
  286.  
  287.     And the configuration file for node 2 (WCSUNO.CF2) might look like this:
  288.  
  289.       GAP
  290.       H:\WILDCAT\WCWORK\NODE2     <=== Notice this is the node 2 directory
  291.       Williams Computer Services BBS
  292.       Rob Williams
  293.       19200
  294.       [etc].....
  295.  
  296.     You will also need to set an environment variable to tell the program
  297.     what node it is currently running on.  Since I run Wildcat, I call
  298.     this variable WCNODEID.  In my .BAT file that calls the BBS, I set the
  299.     WCNODEID to whatever node is running.  You can use wahtever name you
  300.     wish, it just needs to be a unique node ID.
  301.  
  302.     Next, in the batch file that calls WCS Uno, you would change the sample.bat
  303.     that is included with this archive to look like this:
  304.  
  305.        CD\WCSUNO
  306.        WCSUNO WCSUNO.CF%WCNODEID%
  307.  
  308.     What this will do, is when the game is started, it will look for the
  309.     WCNODEID (or whatever you called it), and append that to WCSUNO.CF.  So
  310.     when the game runs, and you run it from node 1 say, it will use .cfg file
  311.     WCSUNO.CF1.
  312.  
  313.     Hopefully, I have not totally confused you on how to set the door up for
  314.     mult-node use.  If you have questions on environment variables, refer
  315.     to your DOS manual.
  316.  
  317.    **************************************************************************
  318.    ** Running this game on more than a single node at a time requires a    **
  319.    ** Multi-Node Key.  When running in Evaluation mode, only one (1) Node  **
  320.    ** will be able to access the door at a time.                           **
  321.    **************************************************************************
  322.  
  323.  
  324.                             Playing the Game
  325.                             ----------------
  326.  
  327.      "WCS Uno" is similar to the card game of "Uno".  Seven cards are dealt
  328.      to you and your computer opponent, and a card is put on the discard
  329.      pile. Who plays first in each hand alternates between you and your
  330.      opponent. Type in the number under the card you choose to <P>lay.
  331.      You may play...
  332.        1] ...a card that matches the number of the card on the discard pile.
  333.        2] ...a card that matches the color of the card on the discard pile.
  334.        3] ...a card that matches the kind of the card on the discard pile.
  335.        4] ...a wild card.
  336.  
  337.      If you can't do any of the above, you must <D>raw a card from the draw
  338.      pile, and your opponent gets to play. Whoever plays all the cards first
  339.      wins the hand. The number of hands you may play are a configurable
  340.      option of the Sysop.
  341.  
  342.      Scoring
  343.      -------
  344.      Scoring is very simple. Losers score nothing. Winners are awarded the
  345.      value of the cards in the opponent's hand.
  346.  
  347.                  Uno Card            Point Value
  348.                  --------            -----------
  349.                  Number Cards:       Face value
  350.                  Draw Two:           20 points
  351.                  Skip Cards:         20 points
  352.                  Reverse Cards:      20 points
  353.                  Wild Cards:         50 points
  354.                  Wild Draw 4:        50 points
  355.  
  356.      Scores are reset the 1st of every month.
  357.  
  358.      When you go into the door, you will see an opening screen, it will
  359.      wait for you to press a key, then show you the main menu.  From here,
  360.      there are four options.  P will take you to the playing screen, H will
  361.      show you the high score list, I will show you a help file for playing
  362.      the game, and Q will return you to the BBS.
  363.  
  364.      The first time a player plays the game each month, the system will
  365.      automatically reset the player statistics.  This process should not
  366.      take more than a few seconds, and is automatic, so no intervention
  367.      from the Sysop is necessary.
  368.  
  369.  
  370.  
  371.                            Make-Up Days Explanation
  372.                            ------------------------
  373.  
  374.      The make up days feature warrants a little more explanation here.
  375.      When the game is registered, after you have played your game for today,
  376.      it will check to see if make up days has been enabled (start day < 31).
  377.      If today is greater than the start day, and the total number of days you
  378.      have played is not greater than what was specified in the .cfg file, it
  379.      will ask you if you want to play a make up day.  It will then show a
  380.      calendar of days for the current month.  Days that you have played will
  381.      show up in red with an x, playable days will show up in green with an o.
  382.      Choose a valid date (one with an o, within the current month), and you
  383.      will start another days game.  If you changed your mind and do not want
  384.      to play a make up day, enter 99, and you will be asked if you want to
  385.      view the high scores, then be returned to the BBS.
  386.                             
  387.                               Special Keys
  388.                               ------------
  389.                                     
  390.      While WCS Uno is running, the sysop can press certain special keys to
  391.      perform a variety of functions.   The following is a list of the
  392.      functions that the special keys perform:
  393.  
  394.      Key(s)              Function
  395.  
  396.      HOME                Toggles between the user  status window and a help
  397.                          display that lists the special keys.
  398.  
  399.      F6                  Takes 5 minutes away from the caller.
  400.                          NOTE:  This will NOT be returned to BBS.
  401.  
  402.      F7                  Gives 5 minutes to the caller.
  403.                          NOTE:  This will NOT be returned to the BBS.
  404.  
  405.      F9                  Quit the door and return the caller to the BBS.
  406.  
  407.      F10                 Enter  chat mode.  Pressing the  ESC key exits the
  408.                          chat mode.
  409.  
  410.      Alt+D               Drop to DOS.
  411.  
  412.                                  
  413.                                 Support
  414.                                 -------
  415.  
  416.      If you have problems, I will try and help as best I can, whether you
  417.      are registered or not.  Registered users will get priority over non-
  418.      registered users, though.  You may get help with problems by calling 
  419.      Williams Computer Services BBS at (503) 631-8439, or by writing to 
  420.      the author at the following addresses:
  421.  
  422.      FIDO     : 1:105/278
  423.  
  424.      Internet : rob@wcs.org
  425.  
  426.      US Mail:
  427.  
  428.           Rob Williams
  429.           18370 S. Henrici Road
  430.           Oregon City, OR 97045
  431.  
  432.  
  433.                          Registering WCS Uno
  434.                          -------------------
  435.  
  436.      Registration of WCS Uno is only $15.00 for single node
  437.      or $20.00 for Multi-Node.   Please use the form in the file
  438.      REGISTER.FRM.   When  you register,  you will receive a registration
  439.      key that will turn your version into a registered version.
  440.  
  441.      You may also now register and get your keys immediately by calling
  442.      Williams Computer Services BBS at (503) 631-8439 and using the online
  443.      registration door.  Have your Visa or Mastercard ready, fill out the
  444.      proper information, and your keys will be downloaded to you immediately!
  445.  
  446.      Registered users will have access to the special area of the support
  447.      BBS for additional questions, be able to run multi node (if you purchased
  448.      a multi node version), and have access to make-up days.
  449.  
  450.  
  451.         ***** ALL UPDATES ARE FREE FOR THE LIFE OF THE PROGRAM *****
  452.  
  453.                             Acknowledgements
  454.                             ----------------
  455.  
  456.  Thanks go to the following people/companies (Listed in no particular order):
  457.  
  458.           - Mustang Software for creating Wildcat!
  459.           - Randy Hunt and Mark Goodwin for creating RMDoor which was used
  460.             to create this game.
  461.           - Mike Jordan for his help with some of the routines, and for the
  462.             idea of the make up days, and also help in testing, and his help
  463.             in helping me get started in door programming.  Also for helping
  464.             with the InterBBS part of things.
  465.           - Andy Stewart for his programming help, and also for help in creating
  466.             the main play screen, and for also writing some of the InterBBS
  467.             routines.  These are available with the DDPlus door kit, and are
  468.             FREEWARE!
  469.           - Matt Somerville - BIG thanks for helping test the InterBBS play
  470.             (a lot of messages went back and forth testing it...<Grin>)
  471.           - Norman Scott for helping correct the documentation and writing the
  472.             help screen.
  473.           - Gayle Davis and all the people that have contributed to the
  474.             SWAG archives.  I have used various snippets from those
  475.             archives, as well as them giving me good ideas on how to
  476.             proceed next.  Thank you.
  477.           - A Big THANK YOU to all my beta testers:
  478.                Norman Scott at 1:375/8
  479.                Walter Cade at 1:398/2
  480.                Mike Jordan at 1:105/314
  481.                Matt Somerville at 1:2250/8
  482.                Andy Stewart
  483.  
  484. There are probably more people that I have forgotten, but these have been
  485. the most instrumental in the writing of this program.
  486.  
  487.