home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-386-Vol-2of3.iso / b / bj278c.zip / BJ.DOC next >
Text File  |  1993-01-17  |  18KB  |  436 lines
  1. RE: Archive filename is BJ278C.ZIP
  2.  
  3.         BlackJack Version 2.78c Documentation
  4.         (C) Copyright 1992-1993 Robert Fortune.  All Rights Reserved.                             
  5.         A PCBOARD 14.x and 31 line DOOR.SYS file compatible BBS Game Door         
  6.  
  7.         =================================================================
  8.         NOTE: If you are unsure whether you have the latest version of
  9.         this BlackJack BBS game door you call the following board and check 
  10.         to see if you have the latest version:
  11.  
  12.      1) The Greek Isles (718)424-1696
  13.         24 Hours - Genuine Intel 14400
  14.         SysOp: Tony Kolokithias
  15.         Location: New York City, USA.
  16.         =================================================================
  17.  
  18.         When you do a file search use BJ*.ZIP as all future versions will
  19.         use BJ as the first 2 characters of the BlackJack archive.
  20.  
  21.  
  22.                                                          January 16, 1993
  23.  
  24.         Disclaimer & Credits: 
  25.         
  26.         Neither Lopaka's / Lopaka's Nuioka Productions nor Robert Fortune 
  27.         shall be held responsible for any damages, loss of data or any other 
  28.         loss as a result of using this software.  The user by using this 
  29.         software takes FULL responsibility and liability for use of and any
  30.         damages, losses etc... as a result of this software. Every effort
  31.         has been made to ensure that this software is free from defects
  32.         and has been thoroughly tested before release to the general
  33.         public. 
  34.         
  35.         BlackJack BBS Game Door 2.78c Copyright (C) 1992 Robert Fortune. 
  36.         All Rights Reserved.
  37.         BASIC Professional Development System 7.1 (C) Copyright Microsoft Corp.
  38.         Door Source Copyright (C) Todd Miller/Computer City USA 1989-1992
  39.         PCBOARD (C) Clark Development Company, Inc.
  40.         Wildcat (C) Mustang Software, Inc.
  41.  
  42.  **************************************************************************
  43.  *     THIS DOOR WORKS WITH THE X00 FOSSIL DRIVER(s) AND LOCKED COM PORTS *
  44.  **************************************************************************
  45.  
  46.         Credits:  
  47.         -------
  48.  
  49.         Todd Miller: For his QBX LIB -- DS40BPDS.LIB (Doorsource 4.0B).
  50.         PC Technologies BBS (919) 294-1770 - Todd Miller SysOp
  51.  
  52.         James "The GARF" Davis for his ANSI card deck and that ESC tip!
  53.  
  54.         Tony Kolokithias (The Greek Isles BBS: (718) 424-1696 - New York).
  55.         For all that unzipping, installing and beta testing! 
  56.  
  57.         D. Quezada for suggesting this door be written. 
  58.  
  59.    *    BEWARE OF IMITATIONS: There is another door out there which looks
  60.         a lot like this BlackJack door. It is NOT the same program. That
  61.         door has disabled features whereas this door does not. Feel free
  62.         to use the one you like best. If you use this door remember to
  63.         register it. I think you'll notice that this door gives you the 
  64.         most bang for the buck!
  65.         
  66.         Joe Negron for the good suggestions and technical support.
  67.  
  68.         Many thanks to all!   Robert Fortune
  69.  
  70.  
  71.         Registration Information:
  72.         ------------------------
  73.         This software is shareware. What that means is that
  74.  
  75.         you the SysOp can try it out to see if it meets your needs.
  76.  
  77.         After a 30 day evaluation period you are asked to 
  78.  
  79.         send the author (that's me!) $10.00. That's right! Only $10.00!
  80.  
  81.         BBS operators (SysOps) may distribute this program provided it is
  82.  
  83.         in its original archive condition and contains all of the files
  84.  
  85.         included in the official release as listed below. For those 
  86.  
  87.         distributing software for a service fee, the amount of this fee
  88.  
  89.         may not exceed $6.00 for shipping/handling/packaging charges. This
  90.  
  91.         program may not be distributed as part of another package without
  92.  
  93.         the express written permission of the author. It may not be distributed
  94.  
  95.         in any modified form. 
  96.  
  97.         Under NO circumstances are you permitted to de-compile, reverse-
  98.  
  99.         engineer or otherwise tamper with this program. (if you have so much 
  100.         
  101.         energy why not write your own programs? )
  102.  
  103.         Do not try to modify any of the enclosed ANSI screen files. Although
  104.  
  105.         this may be tempting to some, these files have been custom created
  106.  
  107.         and if you modify them in any way it will likely screw up the proper
  108.  
  109.         operation of the door. So leave them alone.
  110.  
  111.     Summary:
  112.     -------
  113.  
  114.     This is a BBS game door of the classic card game, BlackJack. In order to
  115.     use it you will need to be running BBS software capable of generating
  116.     a PCBOARD.SYS , 31 line DOOR.SYS or Bulletin Board System interface file.
  117.     This door supports the x00nnn Fossil Driver with locked com ports.
  118.     This door monitors the carrier so that if a user hangs up while inside 
  119.     the door, the door will close all of its files and clean up after 
  120.     itself and then return control back to the BBS system software.  
  121.     This door is not limited in any way! What you have is the complete 
  122.     fully functioning door.  I do not like programs that are limited 
  123.     and I'm sure many others feel the same way. But that does not mean
  124.     you should not register this door. If you like it and want to continue
  125.     using it after the 30 day trial period you are asked to send in your
  126.     $10.00 registration fee. This will help to ensure that future quality
  127.     door(s) are developed. 
  128.         Payoffs are 1 for 1. That is, if you bet 100 dollars and you win,
  129.     then you win 100. "Natural" blackjacks are payed off at 2 for 1. That
  130.     is if you bet 100 and get a "Natural" blackjack on your first 2 cards
  131.     you win 200. Double down doubles your bet and thus if you win, you
  132.     win the amount of your doubled down bet. That is if you bet 100 dollars
  133.     and double down and then win, you win 200. If you lose the doubled
  134.     down bet you lose 200. You cannot double down if you've been dealt
  135.     more than 2 cards or if you do not have the funds in your bank to
  136.     double your current bet. Double down is only permitted if you have
  137.     been dealt only 2 cards. Your bet is doubled and you are dealt a 3rd
  138.     and final card.
  139.        The Five card Charlie rule is reportedly most popular in the
  140.     Northeastern United States. Basically it stipulates that if the
  141.     player draws 5 cards and his hand is 21 or under 21, he automatically
  142.     wins the hand. The dealer cannot win via a 5 Card Charlie. 
  143.     It should also be noted that this game only allows the 
  144.     dealer or player to draw 6 cards per hand. This is for technical 
  145.     reasons and may be improved upon in a future version of this door.
  146.        This blackjack game loosely follows John Scarne's rules for playing
  147.     a "private" game of blackjack.  As of this version (2.78c) there is no 
  148.     option to split a hand.  I may add this option in a future version.  
  149.     That consideration aside, this game plays a decent game of blackjack 
  150.     and I sincerly hope you enjoy it as much as I do.  Keep in mind that 
  151.     registering this game can have an impact on if and how this game door 
  152.     is updated. All that said, Enjoy!
  153.  
  154. *   Scarne On Cards By John Scarne. ISBN 0-451-16765-1. U.S. $5.99
  155.     ---------------
  156.  
  157.     All that said let's move along here.
  158.  
  159.         BlackJack Version 2.78c Installation and usage instructions:
  160.         -------------------------------------------------------
  161.  
  162.     NOTE: This Door requires user systems to have ANSI capability. If they
  163.           do not have ANSI.SYS and try to open the door they will be told
  164.           they must have ANSI capability and be returned to the host software.
  165.  
  166.    Installation Instructions: 
  167.    ------------------
  168.  
  169.        You will need to put the files in this package into your BBS doors
  170.  
  171.     file directory. These are the files you should have after unzipping
  172.  
  173.     this Blackjack game door archive.
  174.  
  175.  1)   INSTALLB.EXE     (Run this program to create the required .CFG file)
  176.  2)   BJ.DOC           (this .DOC file you're reading!)
  177.  3)   FILE_ID.DIZ      (description file for PCB systems)
  178.  4)   BJ.EXE           (Main BlackJack game door program)
  179.  5)   BJACKG           (ANSI color opening screen)
  180.  6)   BJINSTG          (ANSI instructions screen)
  181.  7)   CARDDECK         (ANSI Deck Of Cards)
  182.  
  183.     After you have sucessfully installed this BlackJack door you
  184.     can safely delete the top 3 files (provided you have saved the
  185.     BlackJack archive file for backup purposes!). This will return
  186.     some disk space should you need it.
  187.  
  188.  * STEP #1
  189.    -------
  190.  
  191.     In addition to the above files you will need to create 2 additional
  192.  
  193.     files. The first is a simple .BAT file that will bring the BlackJack
  194.  
  195.     door up when a user selects it from your door menu. It should look
  196.  
  197.     something like this:  (provided this .BAT file is in the same DIR as
  198.     
  199.     the BBS door programs.) Otherwise include the complete path to the
  200.  
  201.     BJ.xxx file(s).
  202.  
  203.     Sample .BAT file(s) (i.e. BJACK.BAT ) to run BlackJack door:
  204.  
  205. *   Example #1-
  206.  
  207.     ECHO OFF
  208.     BJ BJ.CFG PCBOARD.SYS LOCKED:19200
  209.     BOARD
  210.  
  211.     Only use the LOCKED:XXXXX option if you have your com port locked.
  212.  
  213.     Example #2-
  214.  
  215.     ECHO OFF
  216.     BJ BJ.CFG DOORSYS
  217.     BOARD
  218.  
  219.  
  220.     The 2nd line in this .BAT file will start up the BlackJack game door.
  221.  
  222.     (The BBS software that this door supports is PCBOARD or DOOR.SYS. I hope
  223.  
  224.     in the future (near?) to add support for other BBS interface file formats
  225.  
  226.     as well.) Nowadays there are also programs such as DoorMaster (C) that 
  227.     
  228.     may allow you to run PCBoard (C) doors on a non-PCBoard boards so that
  229.  
  230.     may be an option worth checking out if you're running something other
  231.  
  232.     than PCBoard or your BBS system software cannot create a 31 line
  233.  
  234.     DOOR.SYS file.
  235.  
  236.     The third line will bring the BBS software back up after a user exits
  237.  
  238.     the BlackJack door. See your BBS software manuals for specific info on
  239.  
  240.     how to bring up your particular BBS software after a door is exited.
  241.  
  242.  
  243. COMMAND LINE OPTIONS:
  244. --------------------
  245.  
  246.     BJ BJ.CFG PCB121       - for PCBOARD 11.8/12.x  with COM 
  247.                                        port 1 active
  248.     BJ BJ.CFG PCB122       - for PCBOARD 11.8/12.x with COM
  249.                                        port 2 active
  250.     BJ BJ.CFG PCB14        - for PCBOARD 14.x (this is the
  251.                                        default)
  252.  
  253.     BJ BJ.CFG DOORSYS      - for BBS software that generates the
  254.                                        31 line DOOR.SYS file format
  255.  
  256.     BJ BJ.CFG WILDCAT      - for Wildcat 2.0
  257.  
  258.  
  259.     Other command line options include:
  260.  
  261.     LOCKED:xxxxx               Locks the modem at the speed specified
  262.                                in xxxxx. 
  263.                                Example -
  264.  
  265.                                LOCKED:19200
  266.  
  267.     IRQ=n                      Lets you change the IRQ used for the COM
  268.                                port specified in the BBS interface file.
  269.  
  270.     ADDR=&Hnnnn                Lets you change the address used for the
  271.                                COM port specified in the BBS interface file.
  272.  
  273.     PS2                        Forces the PS/2 IRQs and addresses, if a PS/2
  274.                                isn't detected (normally it is, but you can't
  275.                                always tell).
  276.  
  277.     LOCAL                      Runs the door locally. Good for trying out
  278.                                before installing the door on your board to
  279.                                see if the door meets your specs.
  280.  
  281.  * STEP #2:
  282.    -------
  283.  
  284.         The second file is also very easy to create. This file should be
  285.  
  286.     called BJ.CFG  Here is a sample of what it might look like:
  287.  
  288.  
  289.     PCBOARD.SYS
  290.     The Best BBS
  291.     Joe
  292.     Jones
  293.     25
  294.     YES
  295.  
  296.     To create this file run the INSTALLB.EXE program by typing 
  297.  
  298.     INSTALLB    [Press ENTER key]
  299.  
  300. 1)    Enter in your BBS interface file name (PCBOARD.SYS or DOOR.SYS).
  301.     
  302. 2)    Then the name of your BBS. 
  303.  
  304. 3)    Then your first name.
  305.  
  306. 4)    Then your last name. 
  307.     
  308. 5)    Then the amount of time you want to allow users to be able to play 
  309.       the game per day (a time of 15 minutes is suggested). The maximum time 
  310.       you may use is 59 minutes playing time per day.
  311.  
  312. 6)    Then whether you want the 5 Card Charlie Rule to be in effect.
  313.       A simple YES or NO to this question is required.
  314.  
  315.     That's it! The resulting file should have PCBOARD.SYS , DOOR.SYS 
  316.     
  317.     as the first line of the BJ.CFG file.  (Include the full path to the 
  318.  
  319.     BBS interface file (i.e. PCBOARD.SYS, DOOR.SYS, etc...). if the 
  320.  
  321.     BBS interface file is not in the same directory as the BlackJack files.
  322.  
  323.     Next the name of your BBS. Then your first name. Then your last name. 
  324.     
  325.     Then the time limit that will control how long eachday a user can play 
  326.     
  327.     the game. Again, 15 minutes is suggested. Then whether the 5 card
  328.  
  329.     Charlie rule should be in effect.
  330.  
  331.     Keep in mind that any user may open the door as many times a day as 
  332.     
  333.     they like. The door will give users time to play based on the amount 
  334.     
  335.     of time you specified in the BJ.CFG file or the amount of time they 
  336.     
  337.     have left for the day. If you specified say 15 mins playing time per 
  338.     
  339.     day and say they only have 10 mins left for the day according to your 
  340.     
  341.     BBS setup, the player will only get the amount of time the BBS reports 
  342.     
  343.     them having left for that day.
  344.  
  345.     The first time you run this door it will create 1 additional file 
  346.     
  347.     called  BLJACK.DAT  This file keeps track of the players, their 
  348.     
  349.     current score and when they last played the game. All this info 
  350.     
  351.     is displayed on the high scores screen.  That's it. 
  352.  
  353.     To test this door or to run it locally just use this command line
  354.  
  355.     BJ BJ.CFG LOCAL
  356.  
  357.     This will run the door locally so you can try it out before installing
  358.  
  359.     it. Be sure all the files in this archive are in the current directory
  360.  
  361.     when you invoke this command and that you have created the .CFG file.
  362.  
  363.     Periodically you may wish to zero out the Player's High Score file.
  364.  
  365.     To do this simply delete the BLJACK.DAT file.  All players who open
  366.  
  367.     the door from that point on will begin anew with a stake of $1500.00.
  368.  
  369.     It is unknown at this time whether any player can win more than
  370.  
  371.     2.15 billion dollars playing this game.  Should a player's winnings
  372.  
  373.     exceed approx. 2.15 billion, it would cause the door to close
  374.  
  375.     prematurely.  If this should happen simply delete the BLJACK.DAT file
  376.  
  377.     and all players will begin anew with a 1500 dollar stake.  In any
  378.  
  379.     case you should periodically delete the BLJACK.DAT file to give latecomers
  380.  
  381.     to the game a fair chance of competing with players who have been
  382.  
  383.     playing for a much longer time.
  384.  
  385.     NOTE: All of the host's game keys will work when a user/caller is playing
  386.           so if for some reason you need to assist a caller on how to
  387.           play the game you can play until they understand how to play.
  388.           Course your ESC key also will work while a player is online
  389.           and should the need arise you can press ESC at the bet screen
  390.           taking the caller out of the door. Not a nice thing to do,
  391.           but it may prove useful in some situations.
  392.  
  393.     All that said, I hope you enjoy this door and support future developments
  394.  
  395.     by registering your copy.  Remember registration is only $10.00!  Yes
  396.  
  397.     I know it's expensive to run a BBS which is one of the main reasons the
  398.  
  399.     registration is so reasonably priced.  
  400.     
  401.     Please send your $10.00 registration fee to:
  402.  
  403.             Robert Fortune
  404.             48 West 17th Street
  405.             New York, N.Y. 10011
  406.             U.S.A.
  407.  
  408.     Should there be any updates to this door you will recieve 2 free updates
  409.  
  410.     for your $10.00 registration fee.  All you will have to do is download
  411.  
  412.     the updated file and install it. I hope to add support for other 
  413.  
  414.     BBS interface file formats soon as well as more features.  Later...
  415.  
  416.     Note: Should any of your users have problems with Telix 3.15 and
  417.     this door and if you have a high speed modem (9600+) and they do
  418.     not ask them to download MDMCFG22.ZIP and TXMDM208.ZIP and run
  419.     the .EXE in them. This corrects a problem with Telix when used
  420.     with a 2400 baud modem trying to work with a high speed modem.
  421.     These files are from the author of Telix and can be found on the
  422.     Telix support BBS as well as local quality boards. Telix works
  423.     fine with this door once the above procedure is completed.
  424.  
  425.  
  426.                                   Robert Fortune  July-September/1992
  427.  
  428.     Note: Should you encounter any problems or have a question or
  429.           suggestion regarding this program you may leave mail for
  430.           ROBERT FORTUNE on The Greek Isles BBS here in New York City
  431.           at (718) 424-1696. Be sure to address your message to
  432.           ROBERT FORTUNE.                   Robert Fortune
  433.     -----------------------------------------------------------------------
  434.     *     *     *    END OF BLACKJACK Version 2.78c Documentation   *    *    *
  435.  
  436.