                                 AF-DOWNS
                               by Gary Crunk

NOTICE!!! Please Read ALL of this... I know, most people don't like to read
          instructions... But if you do read it, it will help you to get
          the game running on your BBS faster and without any hassles.

-=[ Software ]=------------------------------------------------------------

    This game was written in Turbo Pascal 7 for DOS.  This game must be run
    as a DOS Door.  As well, it does require the player to play in ANSI
    Color. And lastly, it requires it be run as DOOR.SYS Drop File usage!

    So if your BBS can run DOS Doors, then this program "Should" work.

    This game will also work on a Multi-Node BBS.  The game is usually
    called using NetFoss (Especially if it's a Telnet BBS).  See the
    example command line for Mystic BBS as an example.

-=[ Operating System ]=----------------------------------------------------

    This program will run under DOSBOX or if on Windows XP, you can run
    CMD.EXE, change to the directory and run afdowns /L.

    When installing this on Windows XP BBS Door, it will run under NetFoss.

-=[ Legal Disclaimer ]=----------------------------------------------------

   I have taken precautions to insure that no harm or damage will
occur on the computer systems operating this door.  However, I
will NOT be held liable for whatever may happen on your computer
system or to any computer systems which connects to your own as a result of
operating this door.  The user assumes full responsibility for the correct
operation of this software package, whether harm or damage results from
software error, hardware malfunction, or operator error.  NO warranties are
offered, expressly stated or implied, including without limitation or
restriction any warranties of operation for a particular purpose and/or
merchant ability.  If you do not agree with this then do NOT use this
program.  In other words, if it doesnt work or messes up things, do not
blame me...

-=[ About the Game ]=------------------------------------------------------

    This is a Horse Racing Game.  You place Bets on 5 horses to either
    Win, Place or Show.  You start off with $200.  If you fall below
    $20, the program will give you another $200 so you really Can't Lose!

    Play is simple.  Press B to place your Bets.  Select a Horse #
    then how much you wager.  Select Horse/Wager for all 3 horses and
    the order in which you are betting that they come in past the finish
    line.
    Once done, Press R to run the race and get the results... Simple.

-=[ Installation ]=--------------------------------------------------------

    Please follow these Instructions so you can get this running properly
    on your BBS.

    1) Make a directory on your system that is reachable by your BBS
    such as in Mystic   c:\mystic\doors\afdowns

    2) Extract the contents of this .ZIP file to that directory you
    just created!

    So you should have something like this:

      C:\MYSTIC\DOORS\AFDOWNS\

    3) There are 2 files there called ADOOR0.CFG and ADOOR1.CFG...
    Edit these files and update them for your system...

Here is an Example of one of my ADOOR1.CFG Files
============================================
DOORSYS
E:\mystic\Temp1
Another F-ing BBS
Gary Crunk
TELNET
E:\Mystic\Doors\afdowns\
0
0
0
0
============================================

THIS DOOR WILL ONLY WORK USING DOOR.SYS!

    Line 1 is the type of Drop-File used.  DOOR.SYS is Required so
           use DOORSYS here.
    Line 2 is the full path to the dropfile for this node. Do NOT
           specify dropfile name on this line.
    Line 3 is the system name.
    Line 4 is the name of the system operator.
    Line 5 is the locked baud rate if applicable or TELNET if using
           a telnet connection.
    Line 6 is the full path to the directory where the door is located.
           Do NOT specify the door name, only the directory path.
    Lines 7-10 are reserved for future use, but must be present.

    This file must be present for the program to launch. You may specify the
    configuration file name and path with command line switch /C.
    Example: afdowns.exe /H%1 /Cc:\bbs\doors\adoor%2.cfg

    You must have a seperate configuration file for each node on your system!
    For example, if you run a system with 8 Nodes, you will need
    ADOOR0.CFG, ADOOR1.CFG, ADOOR2.CFG .... ADOOR8.CFG
    Making sure that in each .CFG, the proper pointer to Drop File Location
    is at.  In Mystic BBS, this is C:\Mystic\TEMP0 .... C:\Mystic\TEMP8

    You MUST Create an ADOOR#.CFG for EACH Node you run.  If you run 100 Nodes,
    then you will need 100 ADOOR#.CFG edited to point to where that Node's
    DropFile will reside...

    You should also have ADOOR0.CFG if you are logging onto your BBS Locally,
    this will handle the Local aspect...

-=[ Setting up your BBS to Run the Door Game ]=------------------------------

                            COMMAND LINE OPTIONS
                            ____________________

    The following command line switches may be used:
        /H  Handle or ComPort to use. (Required!)
        /C  Configuration File (Required!)
        /T  Telnet Mode (I dont use this for Mystic, you may need to..)
        /L  Local Mode (Use this to play at the DOS Prompt Locally)
        /N  Node Number (Required!)
        /G  Game Module (IGM) (Not Used)
        /S  Security Level (Not Used)
        /W  Wildcat5/Winserver Switch (Not Used)
        /M  Maintenance Mode (Not Used)
        /Z  Time Left in Minutes. (Useful for limiting time in door) (Not Used)
        /?  Shows available switches

    EleBBS Example: c:\elebbs\doors\afdowns\AFDowns.EXE /H*W /Cc:\bbs\doors\adoor*N.cfg

    Mystic BBS Example:
      (D3) Exec DOOR32 Program
      Data: c:\mystic\netfoss\nf.bat /N%3 /H%0 c:\mystic\doors\afdowns\start.bat %0 %3

    Note: For Linux users, I do not know how to use DOS Doors on Linux/PI...
          If you can run DosEmu or QEMU, you will have to figure out
          how to run the Door with the appropriate required switches such as /H and /N

    For my BBS, I have a batch file inside c:\mystic\doors\afdowns  called
    start.bat.  Here is the contents:
==============================================
Echo Off
c:
cd c:\mystic\doors\afdowns
afdowns.exe /H%1 /Ce:\doorsrv\doors\afdowns\adoor%2.cfg
REM This now creates the Players Scores to a file called stscores.txt
REM You can then copy that (or not) to your Scores or Bulletins...
playered scores
copy scores.txt c:\doorsrv\text\bullet10.asc
==============================================

    The /H parameter must be specified when not operating in local mode.
    If no command line switches are used, the program defaults to local mode.

    4. NOW that you've done all of that... <Whew>... Log onto your BBS
    either Locally or via Telnet... And Run the Door Menu you've created..
    That should be it.

    IF you run into a problem or an error when you run
    the door, it probably means that the PLAYER.DAT file has not been created
    properly... Here is how to fix the problem...
      a) Go to your DOS Prompt and CD to the AFDowns Directory.
      b) Rename PLAYER.DAT to PLAYER.BAK
      c) Run PLAYERED.EXE
      d) This will create a New PLAYER.DAT file with 1 record...
      e) KEEP Record Number 0 there and Empty...
      f: ADD a New Record.  Say Not-Empty
         Add your BBS Login Handle (Exactly as you have it on your BBS)
         Fill in other fields, or leave them blank until done...
      g: Exit the program, and then Reload your BBS and Log On and try
         play again.

    5. If you want to Generate the Scores in your nightly maintenance
    program, simply tell it to run PLAYERED SCORES.

    6. I am leaving the "Feedback" function in this release so you can
    get feedback from your players/users.. and if you want, you can pass
    that info to me... It helps to fix any glitches/mistakes in the game.

-=[ Modification of the Game ]=--------------------------------------------

  There are Other Programs I am including with this.  I used them to create
  and manage the .DAT files used by the program during/for game play.  IF
  you use them, please Backup all .DAT files to another location just in
  case you make a mistake or damage them.

PLAYERED.EXE.  You can use this program, though it's simplistic, you can
use it to Edit Players. It is also used with the SCORES parameter to
generate a scores.txt file.

NOTE:  RECORD ZERO(0) must Always be there!
  Leave Record Zero(0) alone and leave it as it is...  Leave the "Empty"
  field set to One (1).

If you wanted to Delete a User, Edit their record and place a Zero (0)
in the "Empty" field.  This way, the next time a new player plays, their
info will be placed in that record #.  Sure, the player you deleted can
still log on and play, it will just create a new player record...

You cannot actually "Delete" a record, merely render it "Empty"
so when a new player plays it, they will "Take-Over" that record numer
you marked as Empty (0).  You can also use the program to "Cheat" and
give a user more money or inventory items.

-=[ Conclusion ]=--------------------------------------------------------

I think thats about it... Please contact me at garycrunk@amtimes.com or
at my BBS (Telnet)  anotherbbs.bbsindex.com.

If you Really like the program, and feel generous, you can always send
a donation of any amount you want on Paypal to garycrunk@amtimes.com. If
you send a donation, also Email me.  If you send more than $10.00, and
if you want, Email me directly at garycrunk@amtimes.com with your BBS
Name and Your Name and BBS Address and your donation amount...

I will Personalize a copy of AFDowns.exe for you so when users play,
it will have that information displayed... A personalize copy of the game
just for you... and Email the program to you, so make sure it's a good
Email address that can accept attachments.

Many thanks and your Feedback is Welcome.

Gary Crunk
Another F-ing BBS (anotherbbs.bbsindex.com) Port 23
Big Box of Raspberry PI (bigboxofpi.bbsindex.com) Port 2323
Quazar BBS Door Server (quazarbbs.dtdns.net Port 992)
http://www.anotherbbs.bbsindex.com
http://www.garycrunk.com
http://www.amtimes.com
