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