home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1996 October / PCO_10.ISO / filesbbs / stackem.arj / ST!SYSOP.DOC < prev    next >
Encoding:
Text File  |  1996-09-10  |  16.4 KB  |  361 lines
  1.     //////////////////////////////////////////////////////////////////
  2.     /                                                                /
  3.     /                            Stack'Em!                           /
  4.     /                           Version 3.2                          /
  5.     /                                                                /
  6.     /                        Copyright 1990-1995                     /
  7.     /                        ALL RIGHTS RESERVED                     /
  8.     /                          J & W Software                        /
  9.     /                                                                /
  10.     /                                                                /
  11.     /       DOOR game  for  PCBoard,  Wildcat!,  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.     /                          (352) 563-2547                        /
  19.     /                     1200 - 14400 HST/v.32bis                   /
  20.     /                          FIDO 1:3653/20                        /
  21.     /                                                                /
  22.     /                         InterNet access:                       /
  23.     /                    (Email) jimb@xtalwind.net                   /
  24.     /                (FTP) ftp.xtalwind.net /pub/jwsoft              /
  25.     /              (WWW) http://www.xtalwind.net/jwsoft/             /
  26.     //////////////////////////////////////////////////////////////////
  27.  
  28.  
  29.     INTRODUCTION
  30.     ------------
  31.     Stack'Em! is a game where the  player has to join different shaped
  32.     falling  pieces  together  to  form  completed  horizontal  lines.
  33.     Scoring is based on  how many pieces are played and  the number of
  34.     lines completed.  Players compete  for weekly as  well as all time
  35.     high scores.
  36.  
  37.  
  38.     FEATURES
  39.     --------
  40.     - ANSI Color and Mono screens
  41.     - RIPscrip graphics
  42.     - Full multi-node support
  43.     - Support for locked DTE up to 115K bps
  44.     - Support for COM1 through COM8 and IRQs 1 through 15
  45.     - FOSSIL support
  46.     - DESQview, Windows and OS/2 time slices released
  47.     - Easy installation and no maintenance
  48.  
  49.  
  50.     SETUP
  51.     -----
  52.     Setup is  very  simple.  Create  a directory  and place  the files
  53.     STACKEM.EXE,  ST!SETUP.EXE,  LOCAL.BAT   and  SCREEN.LIB  in  this
  54.     directory.  If you are upgrading  a previous version of Stack'Em!,
  55.     see the UPGRADING section below for instructions on upgrading your
  56.     current version.
  57.  
  58.     Change to  this  directory  and run  ST!SETUP.EXE.  A screen  with
  59.     several fields  will be  displayed.  There will  be a  box at  the
  60.     bottom of the screen  that will display help  information for each
  61.     field. The following edit keys are allowed:  HOME, END, BACKSPACE,
  62.     LEFT and  RIGHT ARROW. Use the  ENTER,  UP and  DOWN ARROW keys to
  63.     move between the different fields.
  64.  
  65.     Each field is described below:
  66.  
  67.     Name: The name of the person registering the program as it will be
  68.     displayed on  the opening screen (when registered).  This does not
  69.     necessarily have to be the SysOp, it could be the name of the user
  70.     who donated the registration fee.
  71.  
  72.     BBS Name:  The  name of the  BBS  as  it  will be displayed on the
  73.     opening screen (when registered).
  74.  
  75.     Key Number:  If registered, enter your Key Number here.  Until the
  76.     program  is registered leave this field  as  all zeroes.   See the
  77.     registration section below for more information about registering.
  78.  
  79.     Allowable plays per day:  The number of plays per day that will be
  80.     allowed.  A value of 0 means unlimited plays per day.
  81.  
  82.     Display 'Next Piece' [Y/N]:  If 'Y', the next piece  to  be played
  83.     will be displayed to the player.
  84.  
  85.     Use the  'Doughnut'  piece [Y/N]:  If 'Y',  the  large  'Doughnut'
  86.     shaped piece will be used.  You may not want to use the 'Doughnut'
  87.     shaped piece if small children will be playing the game.
  88.  
  89.                                    Doughnut
  90.  
  91.                                     ██████
  92.                                     ██  ██
  93.                                     ██████
  94.  
  95.  
  96.     Bonus for completing 4 lines:   Set this  to the  number of  bonus
  97.     points a player will receive for completing 4 lines at once. Enter
  98.     a value of 0 to disable the bonus feature.
  99.  
  100.     Penalty for 'Discard Piece':  Set this to the  number of points to
  101.     subtract from  the players score  when they use  the Discard Piece
  102.     command.  If you choose to  enable this command  it is recommended
  103.     that this be set  to a minimum of 500  points.  A value of  0 will
  104.     disable the command, not allowing it to be used.
  105.  
  106.     Number of points per Round:  Set this to the number of points  you
  107.     wish  to use in each round.  At the end of each  round, the screen
  108.     will be cleared of all pieces and  random blocks will be placed at
  109.     the bottom  of the screen.  Each successive  round will  have more
  110.     blocks than the last. If you do not wish to use rounds, then enter
  111.     a value of 0.
  112.  
  113.     Number of entries in score file: Set this to the number of entries
  114.     to display in the score (and bulletin) file displays.  Use this to
  115.     limit the number of entries  displayed for very large score files.
  116.     Enter a value of 0 to not limit the number of entries displayed.
  117.  
  118.     Display All or High scores only:  In the  score file,  display all
  119.     scores or only each player's highest score. Setting this option to
  120.     'H' will limit  each player to  only one entry  in the  score (and
  121.     bulletin)  files with  only their  highest single game score being
  122.     shown. When set to 'A', all scores will be shown.
  123.  
  124.     Path and Name of ANSI Bulletin: Path and name for the ANSI (Color)
  125.     bulletin file. If left blank no file will be written.
  126.  
  127.     Path and Name of ASCII Bulletin: Path and name for the ASCII (Non-
  128.     Color) bulletin file.  If left blank no file will be written.
  129.  
  130.     Use  Internal  or  FOSSIL  com   routines  [I/F]:    The  type  of
  131.     communications support  that  should  be used.  Stack'Em! can  use
  132.     either its own  Internal  communication  routines  or an installed
  133.     FOSSIL  driver.  For  systems  not  using a FOSSIL driver,  choose
  134.     Internal  routines.  The Internal  communication routines  support
  135.     COM1 through COM8 with IRQs  of 1 through 15.  For systems using a
  136.     FOSSIL  driver,  you  may choose  either the  Internal  or  FOSSIL
  137.     routines.
  138.  
  139.     Base Address  (COM1 through COM8):  If you are  using the Internal
  140.     communication routines on ports  other than  COM1 or COM2 you must
  141.     enter the Base Address of the ports, in hex, for the ports you are
  142.     using.  Note that  the Base Address  for COM1 and  COM2  cannot be
  143.     changed.
  144.  
  145.     IRQ  (COM1 through COM8):   If  you   are   using   the   Internal
  146.     communication  routines on ports other  than COM1 or COM2 you must
  147.     enter the IRQ of the  ports you are using.  Note that the IRQs for
  148.     COM1 and COM2 cannot be changed.
  149.  
  150.     After entering all  of the information,  press 'ESC'. ST!SETUP.EXE
  151.     will ask if you want to save  the configuration  file.  If this is
  152.     the first time  ST!SETUP.EXE  has been run or you  have previously
  153.     run ST!SETUP.EXE but changed some  of the information,  press 'Y'.
  154.     This will create  or update the configuration  file (STACKEM.CFG).
  155.     It will also create a STACKEM.SCO file if one does not exist. This
  156.     is the score file and is needed for the program to run.
  157.  
  158.     ST!SETUP.EXE will then ask if you  want to create the registration
  159.     file (STACKEM.REG).  The registration file will be needed when the
  160.     program is registered, so you will need to answer 'Y' at least one
  161.     time for this file  to be created.  Please be sure all information
  162.     is correct as your 'Key Number' will be based on this information.
  163.  
  164.     Consult your BBS manual regarding the creation of DOOR batch files
  165.     for your BBS.  STACKEM.EXE  must be started from  the directory it
  166.     resides in for the game to function.  The command line for calling 
  167.     Stack'Em! is as follows:
  168.  
  169.     STACKEM STACKEM.CFG 'Full path and name of BBS information file'
  170.  
  171.     'Full path and name of BBS information file'
  172.  
  173.     This  will be the full path and filename of your  BBS  information 
  174.     file.   For  example:  C:\PCB\PCBOARD.SYS.   Stack'Em!  uses  this
  175.     filename  to  determine the BBS software which is  being  used  as 
  176.     follows:
  177.  
  178.     CALLINFO.BBS (Wildcat 2.xx)
  179.     PCBOARD.SYS  (PCBoard)
  180.     DOOR.SYS     (GAP, Wildcat! 3.0 and other systems using DOOR.SYS)
  181.     SFDOORS.DAT  (SPITFIRE)
  182.     DORINFOx.DEF (RA/QBBS/RBBS)
  183.  
  184.     Please  note that the DORINFOx.DEF file that RA/QBBS uses  is  not
  185.     fully compatible with RBBS. By default, Stack'Em! uses the RA/QBBS
  186.     DORINFOx.DEF  format.  If  you  are  using  the  RBBS  version  of
  187.     DORINFOx.DEF,  use the parameter  "/RBBS"  (without quotes) on the
  188.     command line in your calling batch file.
  189.  
  190.     An example of a batch file for PCBoard:
  191.  
  192.     CD\STACKEM
  193.     STACKEM STACKEM.CFG C:\PCB\PCBOARD.SYS
  194.     CD\PCB
  195.     BOARD.BAT
  196.  
  197.     An example of a batch file for RBBS using DORINFOx.DEF:
  198.  
  199.     CD\STACKEM
  200.     STACKEM STACKEM.CFG C:\RBBS\DORINFO1.DEF /RBBS
  201.     CD\RBBS
  202.     BOARD.BAT
  203.  
  204.     In addition  to the  /RBBS command  line parameter,  there is  one
  205.     other optional command line parameter as described below:
  206.  
  207.     /UseAlias - This will cause Stack'Em! to use the alias name of the
  208.     player instead  of their real name.  NOTE: This option  only works
  209.     with DOOR.SYS.  If using  files other  than DOOR.SYS,  the players
  210.     real name will be used whether /UseAlias is used or not.
  211.  
  212.     /NoRIP - This will cause Stack'Em! to disable RIPscrip mode.
  213.  
  214.  
  215.     RIPSCRIP GRAPHICS
  216.     -----------------
  217.     If the caller  is using a RIPscrip  compatible terminal, Stack'Em!
  218.     will  automatically detect  and use  RIPscrip  mode for displaying
  219.     graphics.  The caller will be able to use  their mouse or keyboard
  220.     when playing the game.
  221.  
  222.     No ICONs are needed when playing Stack'Em! in RIPscrip mode.
  223.  
  224.     When the caller is in  RIPscrip mode a '(R)' will be  displayed on
  225.     the status line after the Node# to indicate RIPscrip mode is being
  226.     used on the  remote end.  ANSI graphics will be  displayed locally
  227.     when the caller is using RIPscrip.
  228.  
  229.  
  230.     UPGRADING
  231.     ---------
  232.     When  upgrading,  do  not  delete  your  existing  STACKEM.CFG  or
  233.     STACKEM.SCO files. They will be automatically updated when you run
  234.     ST!SETUP.EXE.
  235.  
  236.     To upgrade from v3.0 or v3.1,  replace your existing  STACKEM.EXE,
  237.     ST!SETUP.EXE and SCREEN.LIB files  with the new version 3.2 files.
  238.  
  239.     To  upgrade  from  versions  1.5  to  2.0,  replace  your existing
  240.     STACKEM.EXE and ST!SETUP.EXE files with the new version 3.2 files.
  241.     Place the file  SCREEN.LIB in the  same directory  as STACKEM.EXE.
  242.     Run ST!SETUP.EXE to update your STACKEM.CFG and STACKEM.SCO files.
  243.  
  244.     If you  are  using  the  RBBS  version  of  DORINFOx.DEF,  add the
  245.     parameter  "/RBBS"  (without quotes)  to the  command  line in the
  246.     calling batch file.
  247.  
  248.     If you are upgrading from a version earlier than 1.5 you will need
  249.     to delete your score and configuration files and install Stack'Em!
  250.     over again.  This is necessary  since the score  and configuration
  251.     files from earlier versions are not compatible with version 3.2.
  252.  
  253.     Multiple  configuration files are no longer necessary  if  running 
  254.     multi-node.
  255.  
  256.  
  257.     ERRORS
  258.     ------
  259.     Any  errors  which may occur  will be written to  the  STACKEM.ERR
  260.     file.  When possible, a descriptive error message will be  written 
  261.     to  STACKEM.ERR  with the exact cause of the error.  If the  error
  262.     cannot  be resolved,  call the  support BBS  (Gulf Coast BBS ) and
  263.     upload a  copy of your  STACKEM.CFG,  STACKEM.SCO and  STACKEM.ERR
  264.     files.  This will allow us to more quickly  determine the cause of
  265.     the error.  All support is handled through the Gulf Coast BBS.
  266.  
  267.  
  268.     MULTI-NODES, NETWORKS, MULTI-TASKERS
  269.     ------------------------------------
  270.     Stack'Em! is  multi-tasker aware.  DESQview,  Windows and OS/2 are
  271.     automatically   detected   and  time  slices  are  released  where
  272.     appropriate.  Full record and file  locking is  supported in those
  273.     environments  and  in networked  systems.  Multiple  configuration
  274.     files are NOT necessary when running on multi-node systems.
  275.  
  276.  
  277.     MISCELLANEOUS
  278.     -------------
  279.     At the  beginning of  each week the score  file will automatically
  280.     be cleared and last week's high scorer will be determined.
  281.  
  282.     If you are using a high speed modem and have your com port LOCKED, 
  283.     the  program will not respond to keyboard input while  your  modem 
  284.     buffer is full.  This is normal.
  285.  
  286.     Stack'Em! may be played from the DOS prompt by typing:
  287.  
  288.     STACKEM STACKEM.CFG LOCAL
  289.  
  290.     Note the user name is hard coded as 'SysOp' and the bulletins  and
  291.     score file will not be updated. This mode is only for testing. The
  292.     file LOCAL.BAT is included for this purpose.
  293.  
  294.     To turn on screen writing, if it is off, press any key.
  295.  
  296.  
  297.     REGISTRATION
  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, (352) 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.     There  are  no warranties, express or  implied,  for  unregistered 
  347.     copies of Stack'Em!.  The author will  NOT  be held liable for any
  348.     direct,  indirect, incidental, or consequential  damage  resulting 
  349.     from  the  use  of  this  program.   Your  use  of  this   program 
  350.     constitutes your AGREEMENT to this disclaimer and your release  of 
  351.     the author from any form of liability.
  352.  
  353.     Registered  copies  of  Stack'Em!  are  warranted  to  perform  as
  354.     described  in this  documentation.  In the  event  Stack'Em!  does
  355.     not  perform as described, the author will elect to either rectify
  356.     the  problem or refund  the amount  paid, provided notification is
  357.     received within 30 days of registration.
  358.  
  359.  
  360.                                  - END -
  361.