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