home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / bbsdoor / fowl110.zip / FOWLPLAY.DOC < prev    next >
Text File  |  1993-07-20  |  14KB  |  317 lines
  1.  ╓──────────────────────────────╥───────────────────────────────────────────╖
  2.  ║ ╦══╔═╗╗ ╗╗    ═╦═╗╗  ╔═╗╗ ╔  ║  HysteriaWare Product - by Brian Tardiff  ║
  3.  ║ ╠═ ║ ║║ ║║     ║ ║║  ╠═╣║ ║  ║ The MASS Hysteria BBS - FidoNet 1:324/174 ║
  4.  ║ ║  ║ ║║║║║     ╠═╝║  ║ ║╚╦╝  ║   Line #1: (508)465-3198 - 300/9600 HST   ║
  5.  ║ ╩  ╚═╝╚╩╝╚═╝   ╝  ╚═╝╝ ╝ ╩   ║                                           ║
  6.  ╙──────────────────────────────╨───────────────────────────────────────────╜
  7.     ╓───────────────────────────────────────────────────────────────────╖
  8.     ║ Version 1.10 : Released on July 22, 1993 by HysteriaWare Software ║
  9.     ╙───────────────────────────────────────────────────────────────────╜
  10.  
  11. ═══════════════════════════════════════════════════════════════════════════════
  12.  
  13.  
  14. ╓───────────────────────────╖
  15. ║ Introduction to Fowl Play ║
  16. ╙───────────────────────────╜
  17.  
  18.       Thank you for your interest in The Fowl Play Door.  Fowl Play was
  19.       designed to bring some extra excitement to the typical RemoteAccess
  20.       Bulletin Board System.
  21.  
  22.       Fowl Play works off the concept of the duck pond games that are
  23.       seen at fairs and amusement parks.  A person pays some money
  24.       (usually $1.00) for a chance to grab one of the plastic ducks
  25.       from the water.  The duck has a number written under it and
  26.       the person wins the prize that corresponds with that number.
  27.  
  28.       So, with that in mind, here is what Fowl Play does.  A user
  29.       pays a certain amount of system time for a chance to grab
  30.       a duck.  Then the door matches the number on that duck with
  31.       the prize board and the user will receive that prize.  The
  32.       prizes are System Time, Upload Credit and Message Post Credit.
  33.  
  34.       Now that you have the main idea of this game, here are some
  35.       specifics on the Fowl Play Package:
  36.  
  37.              ■ Great ANSI Graphics!  Users without Ansi Graphics ON
  38.                are returned to the system.  (Sorry, no Avatar Support)
  39.  
  40.              ■ 100 Fully Configurable Ducks
  41.  
  42.              ■ Fowl Play comes with FPCONFIG, a prize configuration
  43.                and registration program.  The program allows you to
  44.                edit all 100 ducks.
  45.  
  46.              ■ Each user is allowed one play per day
  47.  
  48.              ■ Last 5 Winners Function
  49.  
  50.              ■ Throw Out/Force Duck # to Win Functions (See SysOp Commands)
  51.  
  52.              ■ Not allowing 'certain users' to play the game (See NOPLAY.CTL)
  53.  
  54.              ■ Non-Ansi users are sent back to the system
  55.  
  56.              ■ Complete Fossil Driver Communication Support
  57.  
  58.              ■ Carrier Detect and Keyboard Time-Out Protection
  59.  
  60.  
  61. ╓─────────────────────────╖
  62. ║ Fowl Play Archive Files ║
  63. ╙─────────────────────────╜
  64.  
  65.       The following files should be found in the FOWL100.ZIP file:
  66.  
  67.              FOWLPLAY.EXE  ..................  Actual Door Program
  68.              FPCONFIG.EXE  ..................  Prize Config/Reg Program
  69.              FOWLPLAY.DOC  ..................  Fowl Play Documentation
  70.              FOWLPLAY.CFG  ..................  Door setup Config File
  71.              FPSINGLE.BAT  ..................  Example Single Node .BAT File
  72.              FPMULTI.BAT   ..................  Example Multi Node .BAT File
  73.  
  74.       The following files will be created by the Fowl Play Programs:
  75.  
  76.              FOWLPLAY.PRI  ..................  Prize Configuration File
  77.              FOWLPLAY.WIN  ..................  Last 5 Winners Data
  78.              FOWLPLAY.DAT  ..................  Once Per Day Play Data
  79.  
  80.  
  81. ╓──────────────────────╖
  82. ║ Installing Fowl Play ║
  83. ╙──────────────────────╜
  84.  
  85.       There are THREE parts to setting up this door.  Two parts are
  86.       essential to door operation and the third will probably determine
  87.       how much your users like this door.  The installation part
  88.       of this documentation has been broken up into four headings.
  89.       The first two involve the actual door setup (for Single and
  90.       Multi-Node Systems) and the second two deal with configuring
  91.       the door to suit your desires.
  92.  
  93.  
  94. ╓────────────────────────────────────╖
  95. ║ Installing to a Single-Node System ║
  96. ╙────────────────────────────────────╜
  97.  
  98.       You have two options of setup with a Single-Node System.
  99.  
  100.           Option #1 - Install to Main BBS Directory:
  101.  
  102.                1) Copy all Fowl Play files into your main BBS directory.
  103.                   (ie: C:\RA)
  104.                2) Simply run FOWLPLAY.EXE (with NO parameters) using a
  105.                   Type 7 exit from RemoteAccess.
  106.  
  107.           Option #2 - Install to another directory:
  108.  
  109.                1) Copy all Fowl Play files into a separate directory
  110.                   (ie: C:\DOORS\FOWL)
  111.                2) Using a Type 7 Exit from RemoteAccess execute a
  112.                   batch file such as the included FPSINGLE.BAT.  You
  113.                   must tell Fowl Play where it can find files such as
  114.                   DORINFO1.DEF and EXITINFO.BBS.  The syntax is:
  115.  
  116.                          syntax: FOWLPLAY.EXE [Path to Files]
  117.                              ie: FOWLPLAY.EXE C:\RA
  118.  
  119.                   See FPSINGLE.BAT for example of changing directories
  120.                   and running the Fowl Play Program.
  121.  
  122.  
  123. ╓───────────────────────────────────╖
  124. ║ Installing to a Multi-Node System ║
  125. ╙───────────────────────────────────╜
  126.  
  127.       Setting Fowl Play up for a Multi-Node System is easy if you
  128.       follow these directions.  To run Fowl Play in Multi-Node mode
  129.       you must install SHARE.EXE that comes with your MS-DOS
  130.       package.  For more information on SHARE, see your DOS manual.
  131.  
  132.       So that there is no confusion, these directions will be as
  133.       detailed as possible.  Please follow these step by step.
  134.  
  135.                1) Create a seperate directory on your system and
  136.                   copy all the Fowl Play files into that directory.
  137.                   (ie: C:\DOORS\FOWL)
  138.  
  139.       Now for the actual system installation.  The example batch file
  140.       FPMULTI.BAT will be the file referred to in these steps.  You
  141.       may rename this batch file to suit your needs.
  142.  
  143.                2) Create a Type 7 menu entry with the following info:
  144.  
  145.                   ───────────────────────────────────────────────────
  146.  
  147.                   1         2         3         4         5         6
  148.                   123456789012345678901234567890123456789012345678901
  149.                   [^F^] Fowl Play
  150.  
  151.                   COMMAND.COM /C FPMULTI.BAT *N
  152.  
  153.                   ───────────────────────────────────────────────────
  154.  
  155.                   The optional data is what is important here.  The
  156.                   COMMAND.COM /C FPMULTI.BAT simply calls the batch
  157.                   file.  Make sure the batch file that runs Fowl Play
  158.                   is placed in a pathed directory so RA can easily
  159.                   locate it.  The *N tells FPMULTI.BAT which node
  160.                   number the program is being executed for.  The
  161.                   number passed by *N becomes the %1 in the batch
  162.                   file.
  163.  
  164.                3) Modify the batch file to suit your needs.  In this
  165.                   setup, Fowl Play needs to know where to find files
  166.                   such as DORINFO1.DEF and EXITINFO.BBS.  The syntax is:
  167.  
  168.                           syntax: FOWLPLAY.EXE [Path to Files]
  169.                               ie: FOWLPLAY.EXE C:\RA\LINE%1
  170.  
  171.                   The %1 represents the node number passed by the *N
  172.                   from RemoteAccess.  In this example, if the nodenumber
  173.                   was 1, Fowl Play would look for the files in the
  174.                   directory C:\RA\LINE1.
  175.  
  176.                   For more help on this, see the example batch file
  177.                   FPMULTI.BAT.
  178.  
  179.  
  180. ╓──────────────╖
  181. ║ FOWLPLAY.CFG ║
  182. ╙──────────────╜
  183.  
  184.       This file contains half the setup of Fowl Play.  You must edit this
  185.       file with a text editor.  The format is as follows:
  186.  
  187.                                                     Example:
  188.                                                     ════════════════════
  189.              Line 1: Name of your Bulletin Board    The MASS Hysteria BBS
  190.              Line 2: Cost of a Duck (In Minutes)    15
  191.              Line 3: Value of Uploads (In K-Bytes)  20
  192.  
  193.           ■ The Cost of a Duck (Line 2) is the amount of System Time that
  194.             will be deducted from a user's account when he/she decides
  195.             to grab a duck for a prize.
  196.  
  197.           ■ The Value of Uploads (Line 3) is the amount of K-Bytes each
  198.             upload a user wins will be worth.  For example, if a user
  199.             wins a duck worth 5 uploads, and this option is set to 20,
  200.             the user will receive the 5 uploads and 100 K-Bytes Upload
  201.             Credit (5 Ups * 20 K-Bytes = 100 K-Bytes).
  202.  
  203.       That is all for the text configuration.  Now configure the prizes,
  204.       (next section) and you are ready to use Fowl Play.
  205.  
  206.  
  207. ╓────────────────────────────────╖
  208. ║ FPCONFIG - Prize Configuration ║
  209. ╙────────────────────────────────╜
  210.  
  211.       The FPCONFIG.EXE is the program that configures all 100 of the
  212.       ducks used by Fowl Play.  When the program is first executed, it
  213.       creates a default prize configuration file.  The default prize
  214.       board that is created is EXTREMELY BORING.  *YOU* are the person
  215.       that must make this game exciting.  Go through the ducks and
  216.       edit them with variety.  No user wants to play a game that has
  217.       33 System Time Prizes (all set at 15 Minutes), 33 Upload Credit
  218.       Prizes (all set at 3 Uploads), and 34 Message Post Prizes (all
  219.       set at 5 Posts).
  220.  
  221.       Editing the ducks has been made as simple as possible.  When
  222.       you select "E" from the menu, you will be prompted to enter the
  223.       number of duck you wish to edit.  Then, you may change the type
  224.       of prize or raise/decrease the value with a few simple keystrokes.
  225.  
  226.       Again, I cannot stress the importance of variety.  If you are
  227.       unclear about the prizes, run the FPCONFIG program and keep
  228.       the default settings.  Then, play the actual game to get a feel
  229.       for the objective of the game.  By then, creativity should smack
  230.       you right in the face.
  231.  
  232.  
  233. ╓────────────────╖
  234. ║ SysOp Commands ║
  235. ╙────────────────╜
  236.  
  237.       There are two commands available to the SysOp while a user is
  238.       playing Fowl Play.  They are:
  239.  
  240.              ■ F6 Key: Throw Out User - Returns the user to the system.
  241.  
  242.              ■ F7 Key: Force Duck Num - This option allows you to pick
  243.                                         the number of duck the user will
  244.                                         win.  The option is available
  245.                                         any time BEFORE the ducks actually
  246.                                         start to rotate.
  247.  
  248.  
  249. ╓────────────╖
  250. ║ NOPLAY.CTL ║
  251. ╙────────────╜
  252.  
  253.       For whatever reason, certain users may be shut off from playing
  254.       Fowl Play.  Simply create a text file called NOPLAY.CTL and
  255.       add the user's name to that file.  If Fowl Play matches the
  256.       current user with a name in the file, the following will occur:
  257.  
  258.              ■ The user's name will appear in RED (instead of yellow)
  259.                on the bottom status bar.
  260.  
  261.              ■ The user will be allowed to use all game functions
  262.                except for the "Pick a Duck" feature.
  263.  
  264.       Note: All names must be matched exactly.  The first letter of the
  265.             first and last names must be capatilized and the reset lower
  266.             case.
  267.                     ie: "JOHN USER" would be allowed to play the game
  268.  
  269.                         "John User" would NOT be allowed to play the game
  270.  
  271.  
  272. ╓───────────────────────╖
  273. ║ Registering Fowl Play ║
  274. ╙───────────────────────╜
  275.  
  276.       This program is in NO way 'Cripple Ware' and the only thing that
  277.       is different about your version is the subtle notice that states
  278.       that the door is un-registered.  It irritates me when authors of
  279.       slightly significant programs literally DEMAND outrageously high
  280.       registration fees.  Personally, I think you should do what you
  281.       feel is right.  If you feel I deserve a registration check from
  282.       you, then I would appreciate it if you would register the door.
  283.       There are many registration options to obtain a Fowl Play KEY,
  284.       starting with the very fair price of $6.00.
  285.  
  286.       For your convenience, FPCONFIG will handle all of your questions
  287.       about registering.  Using the answers you give, the program will
  288.       output a registration form to a text file OR your printer.  All
  289.       you have to do is mail it along with your check.  It couldn't be
  290.       simpler!
  291.  
  292.       Finally, if you are the author of a program that requires users
  293.       to register, send me netmail.  We can probably work out a trade.
  294.       This benefits both of us!
  295.  
  296.  
  297. ╓────────────╖
  298. ║ DISCLAIMER ║
  299. ╙────────────╜
  300.  
  301.       Since no one really cares, but I have to do it, this section has
  302.       been placed at the END of this document.
  303.  
  304.       Fowl Play may be distributed freely as long as no changes are made
  305.       to the executables or documentaion and no fee is charged for the
  306.       distribution of it.
  307.  
  308.       The MASS Hysteria BBS or myself will not be responsible in any way
  309.       for any damage or aggravation this program could potentially cause.
  310.       The door has been beta tested for over one month on RemoteAccess
  311.       v2.00g1+ without any problems. However, if problems do occur, I will
  312.       gladly help you fix them but not take responsibility.
  313.  
  314.  
  315.  
  316.    ==========================[ End of File ]===============================
  317.