home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 12 / CD_ASCQ_12_0294.iso / vrac / ss_31.zip / SS!SYSOP.DOC < prev    next >
Text File  |  1994-01-20  |  17KB  |  370 lines
  1.     //////////////////////////////////////////////////////////////////
  2.     /                                                                /
  3.     /                      S u p e r S l o t s !                     /
  4.     /                           Version 3.1                          /
  5.     /                                                                /
  6.     /                       (c) Copyright 1994                       /
  7.     /                       All Rights Reserved                      /
  8.     /                         J & W Software                         /
  9.     /                                                                /
  10.     /                                                                /
  11.     /     Slot Machine game DOOR  for Wildcat!, PCBoard, RA/QBBS     /
  12.     /     SPITFIRE,  GAP 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.32                     /
  20.     //////////////////////////////////////////////////////////////////
  21.  
  22.  
  23.     INTRODUCTION
  24.     ------------
  25.  
  26.     SuperSlots! is a fun (and addictive) game DOOR for Bulletin  Board 
  27.     Systems.   It is a close approximation of a real slot  machine  at 
  28.     your  favorite casino.  There is even a Super Progressive  Jackpot 
  29.     which  starts out at $100,000,000 and increases by  $10,000  after 
  30.     each game.  Playing the game is simple.  Place your bet, pull  the 
  31.     handle  and let the wheels spin.  The strategy is knowing when  to 
  32.     bet big and when to bet small.  Players compete for weekly/monthly
  33.     and all time high scores.
  34.  
  35.  
  36.     FEATURES
  37.     --------
  38.  
  39.     - ANSI Color and Mono screens with sound and animation
  40.     - RIPscrip graphics
  41.     - ASCII mode for users without ANSI displays
  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 aware
  47.     - Easy installation and no maintenance
  48.  
  49.  
  50.     SETUP
  51.     -----
  52.  
  53.     Setup  is  very simple.  Create a directory and  place  the  files 
  54.     SUPRSLOT.EXE, SS!SETUP.EXE, LOCAL.BAT, SEND.BAT and SSICONS.ZIP in
  55.     this directory.
  56.  
  57.     Change  to  this  directory and  extract the  SS*.ICN  files  from
  58.     SSICONS.ZIP into  this directory.  These files will  be needed for
  59.     players when using RIPscrip mode.
  60.  
  61.     Now  run  SS!SETUP.EXE.  A  screen  with  several  fields  will be
  62.     displayed.  There will be a box at  the bottom of the  screen that
  63.     will display help  information for each field.  The following edit
  64.     keys are allowed:  HOME, END, BACKSPACE, LEFT and RIGHT ARROW. Use
  65.     the  ENTER,  UP and  DOWN ARROW keys to move between the different
  66.     fields on the screen.
  67.  
  68.     Each field is described below:
  69.  
  70.     Name: The name of the person registering the program as it will be
  71.     displayed on  the opening screen (when registered).  This does not
  72.     necessarily have  to  be the SysOp, it could be the name of a user
  73.     who donated the registration fee.
  74.  
  75.     BBS Name:  The  name of the  BBS  as  it  will be displayed on the
  76.     opening screen (when registered).
  77.  
  78.     Key Number:  If registered, enter your Key Number here.  Until the
  79.     program  is registered leave this field  as  all zeroes.   See the
  80.     registration section below for more information about registering.
  81.  
  82.     Initial number of turns:  The initial number  of turns each player
  83.     gets each  day. Note that on each turn that a player wins they get
  84.     an additional turn.
  85.  
  86.     Number of Make-Up days allowed:   The number of days a player will
  87.     be allowed to make up if they have  missed playing for any day(s).
  88.     The maximum number of make-up days allowable is 6 (six). If set to
  89.     0 (zero), make-up days will not be allowed.
  90.  
  91.     Path and Name of ANSI Bulletin: Path and name for the ANSI (Color)
  92.     bulletin file. If left blank no file will be written.
  93.  
  94.     Path and Name of ASCII Bulletin: Path and name for the ASCII (Non-
  95.     Color) bulletin file.  If left blank no file will be written.
  96.  
  97.     Use  Internal  or  FOSSIL  com   routines  [I/F]:    The  type  of
  98.     communications support  that should be used.  SuperSlots!  can use
  99.     either its own  Internal  communication  routines  or an installed
  100.     FOSSIL  driver.  For  systems  not  using a FOSSIL driver,  choose
  101.     Internal  routines.  The Internal  communication routines  support
  102.     COM1 through COM8 with IRQs  of 1 through 15.  For systems using a
  103.     FOSSIL  driver,  you  may choose  either the  Internal  or  FOSSIL
  104.     routines.
  105.  
  106.     Base Address  (COM1 through COM8):  If you are  using the Internal
  107.     communication routines on ports  other than  COM1 or COM2 you must
  108.     enter the Base Address of the ports, in hex, for the ports you are
  109.     using.  Note that  the Base Address  for COM1 and  COM2  cannot be
  110.     changed.
  111.  
  112.     IRQ  (COM1 through COM8):   If  you   are   using   the   Internal
  113.     communication  routines on ports other  than COM1 or COM2 you must
  114.     enter the IRQ of the  ports you are using.  Note that the IRQs for
  115.     COM1 and COM2 cannot be changed.
  116.  
  117.     After entering all of the information, press 'ESC'.  SS!SETUP will 
  118.     ask if you  want to save the  configuration file.  If this  is the
  119.     first time  SS!SETUP  has  been run  or you  have  previously  run
  120.     SS!SETUP  but  changed some of the information, press  'Y'.   This 
  121.     will  create or update the configuration file (SUPRSLOT.CFG).   It 
  122.     will also create a SUPRSLOT.SCO file if one does not exist.   This
  123.     is the score file and is needed for the program to run.
  124.  
  125.     It  will  then  ask if you want to create  the  registration  file 
  126.     (SUPRSLOT.REG).   The  registration file will be needed  when  the 
  127.     program is registered, so you will need to answer 'Y' at least one
  128.     time for this file to be created.  Please be sure all  information 
  129.     is correct as your 'Key Number' will be based on this information.
  130.  
  131.     Consult your BBS manual regarding the creation of DOOR batch files
  132.     for your BBS.  SUPRSLOT.EXE must be started from the  directory it
  133.     resides in for the game to function.  The command line for calling
  134.     SuperSlots! is as follows:
  135.  
  136.     SUPRSLOT SUPRSLOT.CFG 'Full pathname to BBS information file'
  137.  
  138.     'Full pathname to BBS information file'
  139.  
  140.     This  will be the full path and filename of your  BBS  information 
  141.     file.  For  example: C:\PCB\PCBOARD.SYS.   SuperSlots!  uses  this 
  142.     filename  to  determine the BBS software which is  being  used  as 
  143.     follows:
  144.  
  145.     CALLINFO.BBS (Wildcat 2.xx)
  146.     PCBOARD.SYS  (PCBoard)
  147.     DOOR.SYS     (GAP, Wildcat! 3.x and other systems using DOOR.SYS)
  148.     SFDOORS.DAT  (SPITFIRE)
  149.     DORINFOx.DEF (RA/QBBS/RBBS)
  150.  
  151.     Please  note that the DORINFOx.DEF file that RA/QBBS uses  is  not
  152.     fully compatible  with RBBS.  By default, SuperSlots! uses the RA/
  153.     QBBS  DORINFOx.DEF format.  If you  are using  the RBBS version of
  154.     DORINFOx.DEF,  use the parameter  "/RBBS"  (without quotes) on the
  155.     command line in your calling batch file.
  156.  
  157.     An example of a batch file for PCBoard:
  158.  
  159.     CD\SUPRSLOT
  160.     SUPRSLOT SUPRSLOT.CFG C:\PCB\PCBOARD.SYS
  161.     CD\PCB
  162.     BOARD.BAT
  163.  
  164.     An example of a batch file for RBBS using DORINFOx.DEF:
  165.  
  166.     CD\SUPRSLOT
  167.     SUPRSLOT SUPRSLOT.CFG C:\RBBS\DORINFO1.DEF /RBBS
  168.     CD\RBBS
  169.     BOARD.BAT
  170.  
  171.  
  172.     RIPSCRIP GRAPHICS
  173.     -----------------
  174.  
  175.     If the caller is using a RIPscrip compatible terminal, SuperSlots!
  176.     will  automatically detect  and use  RIPscrip  mode for displaying
  177.     graphics.  The caller  will also  be  able to  use  their mouse in
  178.     addition to the keyboard for playing the game.
  179.  
  180.     RIPscrip mode requires the icon files  SS*.ICN be available on the
  181.     caller's machine.  If the caller does not  have these  files, they
  182.     will be asked  if they wish to  download them at  the start of the
  183.     game. You must have the SEND.BAT, SSICONS.ZIP and SS*.ICN files in
  184.     the same directory as SUPRSLOT.EXE for the caller to receive these
  185.     files. SEND.BAT uses DSZ (Omen Technology Inc) to send SSICONS.ZIP
  186.     or the SS*.ICN files to the caller using Zmodem.  SuperSlots! does
  187.     pass the  base address  and  IRQ  of  the  com port being  used to
  188.     SEND.BAT so that  non-standard com ports  may be used.  If you are
  189.     using a  FOSSIL driver  or an  intelligent com port  card, you may
  190.     have to replace  DSZ in SEND.BAT  with a Zmodem driver  compatible
  191.     with your system.
  192.  
  193.     When the caller is in  RIPscrip mode a '(R)' will be  displayed on
  194.     the status line after the Node# to indicate RIPscrip mode is being
  195.     used on the  remote end.  ANSI graphics will be  displayed locally
  196.     when the caller is using RIPscrip.
  197.  
  198.     To disable RIPscrip mode place  the command line switch,  "/NORIP"
  199.     (without the quotes) at  the end  of the line  in your batch  file
  200.     calling SuperSlots!.  For example:
  201.  
  202.     SUPRSLOT SUPRSLOT.CFG C:\PCB\PCBOARD.SYS /NORIP
  203.  
  204.  
  205.     UPGRADING
  206.     ---------
  207.  
  208.     To upgrade  from version  3.0, replace your existing  SUPRSLOT.EXE
  209.     and SS!SETUP.EXE files with the v3.1 SUPRSLOT.EXE and SS!SETUP.EXE
  210.     files. No further action is necessary.
  211.  
  212.     To upgrade from versions 2.5 and up,  replace the old SUPRSLOT.EXE
  213.     and SS!SETUP.EXE files with the new version  3.1 SUPRSLOT.EXE  and
  214.     SS!SETUP.EXE files and  run SS!SETUP.  Do not delete your existing
  215.     SUPRSLOT.CFG file as it will be automatically updated.
  216.  
  217.     Put  the  SEND.BAT  and   SSICONS.ZIP  files  into  the  directory
  218.     SUPRSLOT.EXE resides  in  *AND*  extract  the  SS*.ICN files  from
  219.     SSICONS.ZIP into this directory.
  220.  
  221.     If you  are  using  the  RBBS  version  of  DORINFOx.DEF,  add the
  222.     parameter  "/RBBS"  (without quotes)  to the  command  line in the
  223.     calling batch file.
  224.  
  225.     If  upgrading  from a version earlier than 2.5 you  will  need  to
  226.     delete  your score file and install SuperSlots! over again.   This 
  227.     is  necessary  since the score files from earlier versions are not
  228.     compatible with version 3.1.
  229.  
  230.  
  231.     ERRORS
  232.     ------
  233.  
  234.     Any  errors  which may occur will be written to  the  SUPRSLOT.ERR 
  235.     file.  When possible, a descriptive error message will be  written 
  236.     to  SUPRSLOT.ERR with the exact cause of the error.  If the  error 
  237.     cannot  be resolved,  call the  support BBS  (Gulf Coast BBS)  and
  238.     upload a copy of your SUPRSLOT.CFG,  SUPRSLOT.SCO and SUPRSLOT.ERR
  239.     files.  This will allow us to more quickly  determine the cause of
  240.     the error. All support is handled through the Gulf Coast BBS.
  241.  
  242.  
  243.     MULTI-NODES, NETWORKS, MULTI-TASKERS
  244.     ------------------------------------
  245.  
  246.     SuperSlots! has been  developed in a  networked  environment.  All
  247.     multi-node features have been thoroughly tested on multi-node sys-
  248.     tems using DESQview and Peer-To-Peer Local Area Networks. DOS 3.1+
  249.     full record and file locking is supported.  Multiple configuration
  250.     files are NOT necessary when running on multi-node systems.
  251.         
  252.     SuperSlots!  is  DESQview  aware.  It is  automatically  detected,
  253.     screen and  keyboard I/O are  "well behaved",  and time slices are
  254.     released to other applications where appropriate.  SuperSlots! has
  255.     been  tested with  3 nodes running  simultaneously  under DESQview
  256.     (all ports  locked at  38400)  with no  noticeable effect on other
  257.     nodes.
  258.  
  259.  
  260.     MISCELLANEOUS
  261.     -------------
  262.  
  263.     There is  an optional command line  parameter  (/MONTHLY) to reset
  264.     the score file  at  the beginning  of each  month instead  of each
  265.     week.  Place this at  the very end of the line  in your batch file
  266.     calling SuperSlots!.  For example:
  267.  
  268.     SUPRSLOT SUPRSLOT.CFG C:\PCB\PCBOARD.SYS /MONTHLY
  269.  
  270.     This switch was added because of the requests from a few customers
  271.     for tournament use. Its use is not  recommended.  Players who lose
  272.     their entire  bankroll will quickly  lose interest in  the game if
  273.     they must wait until a new month starts to play again.
  274.  
  275.     SuperSlots!  is designed to give each player a $500,000  stake  to
  276.     begin the game.  At the beginning of the  selected time period the
  277.     score file will automatically be cleared and the last periods high
  278.     scorer will be determined.
  279.  
  280.     Each player is given a Sysop configurable number of turns to start
  281.     with and  will gain an extra turn  each time they win. If a player
  282.     does not complete all their turns, they may call back and play any
  283.     remaining turns later that day.
  284.  
  285.     If  the  Super Jackpot is won, it will be reset  to  $100,000,000.  
  286.     The  winning  players  name,  date and amount  they  won  will  be 
  287.     displayed on the menu screen.
  288.  
  289.     If you are using a high speed modem and have your com port LOCKED, 
  290.     the  program will not respond to keyboard input while  your  modem 
  291.     buffer is full.  This is normal.
  292.  
  293.     SuperSlots! may be played from the DOS prompt by typing: 
  294.  
  295.     SUPRSLOT SUPRSLOT.CFG LOCAL
  296.  
  297.     Note that the user name is hard coded as 'SysOp' and the bulletins 
  298.     will not be updated  (the score file will).  This mode is only for
  299.     testing. The file LOCAL.BAT is included for this purpose.
  300.  
  301.     To turn on screen writing, if it is off, press any key.
  302.  
  303.  
  304.     REGISTRATION
  305.     ------------
  306.  
  307.     Registration is required if you choose to continue using this DOOR 
  308.     program.   After 60 days of running the program unregistered,  the 
  309.     score  file  will  cease to be updated.  However,  the  game  will 
  310.     continue  to allow players to play. This should be long enough  to 
  311.     determine if the program meets your needs and is popular with your 
  312.     users.
  313.  
  314.     When  registered, the '[UNREGISTERED COPY]' line will be  replaced 
  315.     with a 'Registered To:' message.  This will show the Name and  BBS 
  316.     Name from the SUPRSLOT.CFG file.
  317.  
  318.     There are two ways to register.
  319.  
  320.                         * Mail order Registration *
  321.  
  322.     If the SUPRSLOT.REG form  was not previously created, run SS!SETUP
  323.     and have it  create SUPRSLOT.REG.  Check this  file to  insure the
  324.     information is correct. If it is not, re-run  SS!SETUP and correct
  325.     any errors.   Your Key Number is based on the information in  this
  326.     file  and must be correct for your  Key Number to work.  Make sure
  327.     that the Name and BBS Name are correct as printed! When done print
  328.     the form  to your printer.  Send the  completed  SUPRSLOT.REG form
  329.     along with your check, money order, VISA or MasterCard credit card
  330.     information for $15.00 (U.S.) to:
  331.  
  332.                               J & W Software
  333.                           9426 N. China Pink Way
  334.                       Crystal River, FL  34428-9500
  335.  
  336.     Your personalized Key Number will be sent to you promptly. When it
  337.     is received, run SS!SETUP  and enter your Key Number.  SuperSlots!
  338.     will then be registered. No other action is necessary.
  339.  
  340.  
  341.                      * Instant On-Line Registration *
  342.  
  343.     You may register SuperSlots! with  VISA or  MasterCard and receive
  344.     your personalized  Key Number  instantly by calling the Gulf Coast
  345.     BBS, 904-563-2547,  and entering REGISTER at the main menu prompt.
  346.     You will need the  Name and  BBS Name exactly as it is  entered on
  347.     lines 1 & 2 of SS!SETUP as well as your credit card information to
  348.     register. You might want to make note of this information to speed
  349.     your call. You will receive your Key Number on that call.
  350.  
  351.  
  352.     WARRANTY & DISCLAIMER
  353.     ---------------------
  354.  
  355.     There  are  no warranties, express or  implied,  for  unregistered 
  356.     copies of SuperSlots!.  The author will NOT be held liable for any 
  357.     direct,  indirect, incidental, or consequential  damage  resulting 
  358.     from  the  use  of  this  program.   Your  use  of  this   program 
  359.     constitutes your AGREEMENT to this disclaimer and your release  of 
  360.     the author from any form of liability.
  361.  
  362.     Registered  copies  of  SuperSlots! are warranted  to  perform  as 
  363.     described  in this documentation.  In the event  SuperSlots!  does 
  364.     not  perform  as described, then the author will elect  to  either 
  365.     rectify the problem or refund the amount of the registration paid,
  366.     provided notification is received within 30 days of registration.
  367.  
  368.  
  369.                                  - END -
  370.