home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 15 / CD_ASCQ_15_070894.iso / vrac / stack_30.zip / ST!SYSOP.DOC < prev    next >
Text File  |  1994-06-10  |  16KB  |  362 lines
  1.     //////////////////////////////////////////////////////////////////
  2.     /                                                                /
  3.     /                            Stack'Em!                           /
  4.     /                           Version 3.0                          /
  5.     /                                                                /
  6.     /                        (c) Copyright 1994                      /
  7.     /                        All Rights Reserved                     /
  8.     /                          J & W Software                        /
  9.     /                                                                /
  10.     /                                                                /
  11.     /       DOOR game  for  Wildcat!,  PCBoard,  RA/QBBS,  GAP,      /
  12.     /       SPITFIRE  and  other BBS  software which  uses door      /
  13.     /       information files compatible with the above.             /
  14.     /                                                                /
  15.     /                                                                /
  16.     /                           Support BBS:                         /
  17.     /                          Gulf Coast BBS                        /
  18.     /                          (904) 563-2547                        /
  19.     /                     1200 - 14400 HST/v.32bis                   /
  20.     //////////////////////////////////////////////////////////////////
  21.  
  22.  
  23.     INTRODUCTION
  24.     ------------
  25.  
  26.     Stack'Em! is a game where the  player has to join different shaped
  27.     falling  pieces  together  to  form  completed  horizontal  lines.
  28.     Scoring is based on  how many pieces are played and  the number of
  29.     lines completed.  Players compete  for weekly as  well as all time
  30.     high scores.
  31.  
  32.  
  33.     FEATURES
  34.     --------
  35.  
  36.     - ANSI Color and Mono screens with animation
  37.     - RIPscrip graphics
  38.     - Full multi-node support
  39.     - Support for locked DTE up to 115K bps
  40.     - Support for COM1 through COM8 and IRQs 1 through 15
  41.     - FOSSIL support
  42.     - DESQview aware
  43.     - Easy installation and no maintenance
  44.  
  45.  
  46.     SETUP
  47.     -----
  48.  
  49.     Setup is  very  simple.  Create  a directory  and place  the files
  50.     STACKEM.EXE,  ST!SETUP.EXE,  LOCAL.BAT   and  SCREEN.LIB  in  this
  51.     directory.  If you are upgrading  a previous version of Stack'Em!,
  52.     see the UPGRADING section below for instructions on upgrading your
  53.     current version.
  54.  
  55.     Change to  this  directory  and run  ST!SETUP.EXE.  A screen  with
  56.     several fields  will be  displayed.  There will  be a  box at  the
  57.     bottom of the screen  that will display help  information for each
  58.     field. The following edit keys are allowed:  HOME, END, BACKSPACE,
  59.     LEFT and  RIGHT ARROW. Use the  ENTER,  UP and  DOWN ARROW keys to
  60.     move between the different fields.
  61.  
  62.     Each field is described below:
  63.  
  64.     Name: The name of the person registering the program as it will be
  65.     displayed on  the opening screen (when registered).  This does not
  66.     necessarily have to be the SysOp, it could be the name of the user
  67.     who donated the registration fee.
  68.  
  69.     BBS Name:  The  name of the  BBS  as  it  will be displayed on the
  70.     opening screen (when registered).
  71.  
  72.     Key Number:  If registered, enter your Key Number here.  Until the
  73.     program  is registered leave this field  as  all zeroes.   See the
  74.     registration section below for more information about registering.
  75.  
  76.     Allowable plays per day:  The number of plays per day that will be
  77.     allowed.  A value of 0 means unlimited plays per day.
  78.  
  79.     Display 'Next Piece' [Y/N]:  If 'Y', the next piece  to  be played
  80.     will be displayed to the player.
  81.  
  82.     Use the  'Doughnut'  piece [Y/N]:  If 'Y',  the  large  'Doughnut'
  83.     shaped piece will be used.  You may not want to use the 'Doughnut'
  84.     shaped piece if small children will be playing the game.
  85.  
  86.                                    Doughnut
  87.  
  88.                                     ██████
  89.                                     ██  ██
  90.                                     ██████
  91.  
  92.  
  93.     Bonus for completing 4 lines:   Set this  to the  number of  bonus
  94.     points a player will receive for completing 4 lines at once. Enter
  95.     a value of 0 to disable the bonus feature.
  96.  
  97.     Penalty for  Throw Away Piece  command:  Set this to the number of
  98.     points to subtract from the players  score when they use the Throw
  99.     Away Piece  command.  If you  choose to enable  this command it is
  100.     recommended that this be set  to a minimum of 500 points.  A value
  101.     of 0 will disable the command, not allowing it to be used.
  102.  
  103.     Number of points per Round:  Set this to the number of points  you
  104.     wish  to use in each round.  At the end of each  round, the screen
  105.     will be cleared of all pieces and  random blocks will be placed at
  106.     the bottom  of the screen.  Each successive  round will  have more
  107.     blocks than the last. If you do not wish to use rounds, then enter
  108.     a value of 0.
  109.  
  110.     Number of entries in score file: Set this to the number of entries
  111.     to display in the score (and bulletin) file displays.  Use this to
  112.     limit the number of entries  displayed for very large score files.
  113.     Enter a value of 0 to not limit the number of entries displayed.
  114.  
  115.     Display All or High scores only:  In the  score file,  display all
  116.     scores or only each player's highest score. Setting this option to
  117.     'H' will limit  each player to  only one entry  in the  score (and
  118.     bulletin)  files with  only their  highest single game score being
  119.     shown. When set to 'A', all scores will be shown.
  120.  
  121.     Path and Name of ANSI Bulletin: Path and name for the ANSI (Color)
  122.     bulletin file. If left blank no file will be written.
  123.  
  124.     Path and Name of ASCII Bulletin: Path and name for the ASCII (Non-
  125.     Color) bulletin file.  If left blank no file will be written.
  126.  
  127.     Use  Internal  or  FOSSIL  com   routines  [I/F]:    The  type  of
  128.     communications support  that  should  be used.  Stack'Em! can  use
  129.     either its own  Internal  communication  routines  or an installed
  130.     FOSSIL  driver.  For  systems  not  using a FOSSIL driver,  choose
  131.     Internal  routines.  The Internal  communication routines  support
  132.     COM1 through COM8 with IRQs  of 1 through 15.  For systems using a
  133.     FOSSIL  driver,  you  may choose  either the  Internal  or  FOSSIL
  134.     routines.
  135.  
  136.     Base Address  (COM1 through COM8):  If you are  using the Internal
  137.     communication routines on ports  other than  COM1 or COM2 you must
  138.     enter the Base Address of the ports, in hex, for the ports you are
  139.     using.  Note that  the Base Address  for COM1 and  COM2  cannot be
  140.     changed.
  141.  
  142.     IRQ  (COM1 through COM8):   If  you   are   using   the   Internal
  143.     communication  routines on ports other  than COM1 or COM2 you must
  144.     enter the IRQ of the  ports you are using.  Note that the IRQs for
  145.     COM1 and COM2 cannot be changed.
  146.  
  147.     After entering all  of the information,  press 'ESC'. ST!SETUP.EXE
  148.     will ask if you want to save  the configuration  file.  If this is
  149.     the first time  ST!SETUP.EXE  has been run or you  have previously
  150.     run ST!SETUP.EXE but changed some  of the information,  press 'Y'.
  151.     This will create  or update the configuration  file (STACKEM.CFG).
  152.     It will also create a STACKEM.SCO file if one does not exist. This
  153.     is the score file and is needed for the program to run.
  154.  
  155.     ST!SETUP.EXE will then ask if you  want to create the registration
  156.     file (STACKEM.REG).  The registration file will be needed when the
  157.     program is registered, so you will need to answer 'Y' at least one
  158.     time for this file  to be created.  Please be sure all information
  159.     is correct as your 'Key Number' will be based on this information.
  160.  
  161.     Consult your BBS manual regarding the creation of DOOR batch files
  162.     for your BBS.  STACKEM.EXE  must be started from  the directory it
  163.     resides in for the game to function.  The command line for calling 
  164.     Stack'Em! is as follows:
  165.  
  166.     STACKEM STACKEM.CFG 'Full path and name of BBS information file'
  167.  
  168.     'Full path and name of BBS information file'
  169.  
  170.     This  will be the full path and filename of your  BBS  information 
  171.     file.   For  example:  C:\PCB\PCBOARD.SYS.   Stack'Em!  uses  this
  172.     filename  to  determine the BBS software which is  being  used  as 
  173.     follows:
  174.  
  175.     CALLINFO.BBS (Wildcat 2.xx)
  176.     PCBOARD.SYS  (PCBoard)
  177.     DOOR.SYS     (GAP, Wildcat! 3.0 and other systems using DOOR.SYS)
  178.     SFDOORS.DAT  (SPITFIRE)
  179.     DORINFOx.DEF (RA/QBBS/RBBS)
  180.  
  181.     Please  note that the DORINFOx.DEF file that RA/QBBS uses  is  not
  182.     fully compatible with RBBS. By default, Stack'Em! uses the RA/QBBS
  183.     DORINFOx.DEF  format.  If  you  are  using  the  RBBS  version  of
  184.     DORINFOx.DEF,  use the parameter  "/RBBS"  (without quotes) on the
  185.     command line in your calling batch file.
  186.  
  187.     An example of a batch file for PCBoard:
  188.  
  189.     CD\STACKEM
  190.     STACKEM STACKEM.CFG C:\PCB\PCBOARD.SYS
  191.     CD\PCB
  192.     BOARD.BAT
  193.  
  194.     An example of a batch file for RBBS using DORINFOx.DEF:
  195.  
  196.     CD\STACKEM
  197.     STACKEM STACKEM.CFG C:\RBBS\DORINFO1.DEF /RBBS
  198.     CD\RBBS
  199.     BOARD.BAT
  200.  
  201.  
  202.     RIPSCRIP GRAPHICS
  203.     -----------------
  204.  
  205.     If the caller  is using a RIPscrip  compatible terminal, Stack'Em!
  206.     will  automatically detect  and use  RIPscrip  mode for displaying
  207.     graphics.  The caller will be able to use  their mouse or keyboard
  208.     when playing the game.
  209.  
  210.     No ICONs are needed when playing Stack'Em! in RIPscrip mode.
  211.  
  212.     When the caller is in  RIPscrip mode a '(R)' will be  displayed on
  213.     the status line after the Node# to indicate RIPscrip mode is being
  214.     used on the  remote end.  ANSI graphics will be  displayed locally
  215.     when the caller is using RIPscrip.
  216.  
  217.     To disable RIPscrip mode place  the command line switch,  "/NORIP"
  218.     (without the quotes) at  the end  of the line  in your batch  file
  219.     calling Stack'Em!.  For example:
  220.  
  221.     STACKEM STACKEM.CFG C:\PCB\PCBOARD.SYS /NORIP
  222.  
  223.  
  224.     UPGRADING
  225.     ---------
  226.  
  227.     To upgrade from versions  1.5+,  replace your existing STACKEM.EXE
  228.     and ST!SETUP.EXE  files  with  the  new  version  3.0  STACKEM.EXE
  229.     and  ST!SETUP.EXE files and run  ST!SETUP.EXE.  Do not delete your
  230.     existing  STACKEM.CFG  or  STACKEM.SCO   files  as  they  will  be
  231.     automatically  updated when  ST!SETUP.EXE is run.  Place the  file
  232.     SCREEN.LIB in the same directory as STACKEM.EXE.
  233.  
  234.     If you  are  using  the  RBBS  version  of  DORINFOx.DEF,  add the
  235.     parameter  "/RBBS"  (without quotes)  to the  command  line in the
  236.     calling batch file.
  237.  
  238.     If you are upgrading from a version earlier than 1.5 you will need
  239.     to delete your score and configuration files and install Stack'Em!
  240.     over again.  This is necessary  since the score  and configuration
  241.     files from earlier versions are not compatible with version 3.0.
  242.  
  243.     Multiple  configuration files are no longer necessary  if  running 
  244.     multi-node.
  245.  
  246.  
  247.     ERRORS
  248.     ------
  249.  
  250.     Any  errors  which may occur  will be written to  the  STACKEM.ERR
  251.     file.  When possible, a descriptive error message will be  written 
  252.     to  STACKEM.ERR  with the exact cause of the error.  If the  error
  253.     cannot  be resolved,  call the  support BBS  (Gulf Coast BBS ) and
  254.     upload a  copy of your  STACKEM.CFG,  STACKEM.SCO and  STACKEM.ERR
  255.     files.  This will allow us to more quickly  determine the cause of
  256.     the error.  All support is handled through the Gulf Coast BBS.
  257.  
  258.  
  259.     MULTI-NODES, NETWORKS, MULTI-TASKERS
  260.     ------------------------------------
  261.  
  262.     Stack'Em!  has  been developed  in  a networked  environment.  All
  263.     multi-node features have been thoroughly tested on multi-node sys-
  264.     tems using DESQview and Peer-To-Peer Local Area Networks. DOS 3.1+
  265.     full record and file locking is supported.  Multiple configuration
  266.     files are NOT necessary when running on multi-node systems.
  267.         
  268.     Stack'Em! is DESQview aware.  It is automatically detected, screen
  269.     and keyboard I/O are "well behaved",  and time slices are released
  270.     to other applications where appropriate. Stack'Em! has been tested
  271.     with 3  nodes  running  simultaneously under  DESQview  (all ports
  272.     locked at 38400) with no noticeable effect on other nodes.
  273.  
  274.  
  275.     MISCELLANEOUS
  276.     -------------
  277.  
  278.     At the  beginning of  each week the score  file will automatically
  279.     be cleared and last week's high scorer will be determined.
  280.  
  281.     If you are using a high speed modem and have your com port LOCKED, 
  282.     the  program will not respond to keyboard input while  your  modem 
  283.     buffer is full.  This is normal.
  284.  
  285.     Stack'Em! may be played from the DOS prompt by typing:
  286.  
  287.     STACKEM STACKEM.CFG LOCAL
  288.  
  289.     Note the user name is hard coded as 'SysOp' and the bulletins  and
  290.     score file will not be updated. This mode is only for testing. The
  291.     file LOCAL.BAT is included for this purpose.
  292.  
  293.     To turn on screen writing, if it is off, press any key.
  294.  
  295.  
  296.     REGISTRATION
  297.     ------------
  298.  
  299.     Registration is required if you choose to continue using this DOOR 
  300.     program.   After 60 days of running the program unregistered,  the 
  301.     score  file  will  cease to be updated.  However,  the  game  will 
  302.     continue  to allow players to play. This should be long enough  to 
  303.     determine if the program meets your needs and is popular with your 
  304.     users.
  305.  
  306.     When  registered, the '[UNREGISTERED COPY]' line will be  replaced 
  307.     with a 'Registered To:' message.  This will show the Name and  BBS 
  308.     Name as configured in ST!SETUP.EXE.
  309.  
  310.     There are two ways to register.
  311.  
  312.                         * Mail order Registration *
  313.  
  314.     If  the   STACKEM.REG  form  was   not  previously   created,  run
  315.     ST!SETUP.EXE and have  it create STACKEM.REG.  Check this  file to
  316.     insure  the   information  is  correct.  If   it  is  not,  re-run
  317.     ST!SETUP.EXE and correct any  errors.  Your Key Number is based on
  318.     the information  in this  file and  must be  correct for  your Key
  319.     Number to work. When done, print the  form to  your printer.  Send
  320.     the completed STACKEM.REG form along with your check, money order,
  321.     VISA or MasterCard credit card information for $15.00 (US) to:
  322.  
  323.                               J & W Software
  324.                           9426 N. China Pink Way
  325.                       Crystal River, FL  34428-9500
  326.  
  327.     Your personalized Key Number will be sent to you promptly. When it
  328.     is received, run ST!SETUP.EXE and enter your Key number. Stack'Em!
  329.     will then be registered.  No other action is necessary.
  330.  
  331.  
  332.                      * Instant On-Line Registration *
  333.  
  334.     You may  register Stack'Em!  with VISA  or MasterCard  and receive
  335.     receive your personalized Key Number instantly by calling the Gulf
  336.     Coast BBS, (904) 563-2547,  and entering REGISTER at the main menu
  337.     prompt.  You  will need the  Name  and  BBS Name  exactly as it is
  338.     entered on lines 1 & 2 of ST!SETUP.EXE as well as your credit card
  339.     information to  register.  You  might  want  to make  note of this
  340.     information to speed  your call.  You will receive your Key Number
  341.     on that call.
  342.  
  343.  
  344.     WARRANTY & DISCLAIMER
  345.     ---------------------
  346.  
  347.     There  are  no warranties, express or  implied,  for  unregistered 
  348.     copies of Stack'Em!.  The author will  NOT  be held liable for any
  349.     direct,  indirect, incidental, or consequential  damage  resulting 
  350.     from  the  use  of  this  program.   Your  use  of  this   program 
  351.     constitutes your AGREEMENT to this disclaimer and your release  of 
  352.     the author from any form of liability.
  353.  
  354.     Registered  copies  of  Stack'Em!  are  warranted  to  perform  as
  355.     described  in this  documentation.  In the  event  Stack'Em!  does
  356.     not  perform as described, the author will elect to either rectify
  357.     the  problem or refund  the amount  paid, provided notification is
  358.     received within 30 days of registration.
  359.  
  360.  
  361.                                  - END -
  362.