home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Java / Java.zip / bjtutor.zip / doc.txt < prev    next >
Text File  |  1997-03-27  |  12KB  |  283 lines
  1. Documentation File for BJTutor
  2. ------------------------------
  3.  
  4. INTRODUCTION
  5. ------------
  6.  
  7. BJTutor is a shareware implementation of the popular casino game BlackJack.
  8. The unregistered version is mostly functional (see exceptions below), but 
  9. will include a delay between hands that will be removed by registering the 
  10. game. 
  11.  
  12. Registration is important as it will ensure bug-fixes and other titles by 
  13. the author. This implementation is written as a stand-alone program using
  14. the Java language so it should be usable on any platform supporting a JVM.
  15.  
  16. This program requires version 1.0.2 or higher JVM.
  17.  
  18. BJTutor will teach you basic strategy, which the single most important 
  19. thing you may do to increase your chances of winning against the casino.
  20.  
  21. I have taken much time and effort in making it both entertaining and useful 
  22. for the beginner and advanced player alike, offering these features:
  23.     * Insurance if the dealer shows an Ace
  24.     * Splitting
  25.     * Doubling
  26.     * Played like in the casinos - no extra cards wasted if unnecessary,
  27.         play each hand one at a time after splitting, no more
  28.         than one card to a split ace, etc.
  29.     * The flexibility to choose options under which the game is 
  30.       played, including:
  31.         * Number of decks in the shoe (One, Two, Four, Six, or Eight)
  32.         * The deck penetration before reshuffling (set anywhere from
  33.             0% to 90%)
  34.         * Double on any two cards vs. double on 10, 11 only
  35.         * Double allowed after splitting vs. not allowed
  36.         * Dealer hits soft 17 vs. stands on all 17s
  37.         * Splitting limit: unlimited, up to 2, 3, or 4 hands
  38.         * Re-split aces vs. no re-split allowed
  39.         * No surrender, late surrender, early surrender
  40.         
  41. BJTutor also includes a powerful integrated advisor/tutor to teach you basic 
  42. strategy. At any time in the game, you may ask for advise from the tutor.
  43. The tutor will tell you what the correct play is according to basic
  44. strategy and the game options that you chose to play. Optionally, the 
  45. tutor can let you know if you make a mistake in your play. This feature is 
  46. important to help you memorize basic strategy.
  47.  
  48. For more information on casino BlackJack or any of the options listed above,
  49. check out the rec.gambling.blackjack frequently asked questions list. 
  50. You can find it in many places, including
  51. http://www.cis.ohio-state.edu/hypertext/faq/usenet/gambling-faq/blackjack/faq.html
  52.  
  53. BENEFITS OF REGISTERING
  54. -----------------------
  55.  
  56. Registering this product is important and carries many benefits, including: 
  57.  
  58.     * Support for the author in continuing to bring you this and similar 
  59.         software. 
  60.     * Avoiding the registration notice. 
  61.     * The bet dialog will default to the amount of your last bet instead
  62.         of $5 every time, even if your last bet was in a different
  63.         session with the BJTutor.
  64.     * The registered version will remember the options you chose for the 
  65.         next time you wish to use the BJTutor.
  66.     * The registered version will check if you can double, split, or
  67.         surrender before offering it to you as advice.
  68.  
  69. LICENSE
  70. -------
  71.  
  72. You must read and agree to all terms and conditions set forth in the file
  73. LICENSE.TXT that is distributed with this program.  Use of the program 
  74. denotes agreement to the terms and conditions stated in that file.
  75.  
  76. INSTALLATION
  77. ------------
  78.  
  79. BJTutor is a standalone application written in Java.  Therefore, you
  80. must have a Java interpreter to run the program.
  81.  
  82. To install the program follow these steps:
  83.     1. Copy the BJTutor.zip or BJTutor.tar.gz file to a 
  84.         permanent location and de-archive it.
  85.     2. Do not de-archive the BJTutor file that is created. This violates
  86.         the license you have been granted.
  87.     3. You may delete the BJTutor.zip or the BJTutor.tar archive.
  88.  
  89. RUNNING THE PROGRAM
  90. ------- --- -------
  91.     
  92. To invoke the program, go to the directory where you installed the BJTutor,
  93. make sure that the java interpreter is in your path and type:
  94.     java -classpath <path to java classes><path separator><path to BJTutor> BJTutor
  95. where
  96.     <path to java classes> is a path to your java classes, i.e.:
  97.         ~/jdk/lib/classes.zip (for UNIX)
  98.         c:\java\lib\classes.zip (for PCs)
  99.     <path separator> is the path separator for your system, it is a
  100.         colon on UNIX systems and a semicolon on other systems.
  101.     <path to BJTutor> is a path to the BJTutor file distributed with
  102.       the archive.  The path MUST end with the BJTutor file, i.e.:
  103.         c:\java\BJTutor
  104.  
  105. The command line for the example above (on a PC) would be:
  106.     java -classpath c:\java\lib\classes.zip;c:\java\BJTutor BJTutor
  107.  
  108. The program should now run.
  109.  
  110. INTERACTING WITH THE PROGRAM
  111. ----------- ---- --- -------
  112.  
  113. When you first run the program, it will put up two dialog boxes.  One will 
  114. let you know that it is initializing the card images. The other will allow
  115. you to choose the options under which to play (The options are described 
  116. in the introduction section of this file) and enter your name and starting
  117. bankroll. Choose the options you want to play under and hit the Done button, 
  118. the 'd' key, or the enter key to continue. You may hit the Quit button, the
  119. escape key, or the 'q' key to exit the game.
  120.  
  121. After you select the options to play under, you will be prompted by the 
  122. "Enter Bet" dialog.  This dialog asks you to enter the amount of your initial
  123. bet. You may edit the text area for the bet using the mouse and keyboard, or
  124. use the number keys, decimal key, and backspace key to enter a bet. When you
  125. are finished, press the Done button or the enter key to continue.
  126. You may hit the Quit button or the Escape key to exit the game.
  127.  
  128. After you have settled on a bet, you will see the BlackJack layout showing
  129. the dealer's upcard and you cards. If the dealer has an ace showing, you will
  130. be asked if you want to take insurance. Whatever your answer, it will be
  131. resolved immediately.
  132.  
  133. If the hand continues beyond insurance, you may hit one of the buttons at 
  134. the bottom of the screen to perform an action, or use one of the
  135. following keyboard equivalents (Note: The lettering in the button has a
  136. capitalized letter to denote the equivalent key):
  137.  
  138.     Action        Equivalent Key
  139.     ------        --------------
  140.     Hit        'h' or '+'
  141.     Stand        Enter or 's'
  142.     Double        'd'
  143.     Split        'p'
  144.     Surrender    'r'
  145.     Advice        'a' or '?'  
  146.  
  147. After the hand is over, you will be prompted by the "Enter bet" dialog to 
  148. place your next bet.
  149.  
  150. PLAYING BLACKJACK
  151. ------- ---------
  152.  
  153. I am assuming that most people know how to play BlackJack (It is sometimes 
  154. called "21"). But, it does not hurt to offer an explanation of the mechanics 
  155. of BlackJack in case someone is not familiar with it or needs a refresher.
  156.  
  157. The normal play:
  158.     1. You place a bet.
  159.     2. The dealer will give you two cards and will take two for
  160.         himself, but will show you only one of his cards.
  161.         Cards values:
  162.             Ace                1 or 11 points
  163.             Ten, Jack, Queen, King        10 points
  164.             All others            Face value
  165.     3. Object: To have a hand closer to 21 than the    dealer's hand, but
  166.         if you go over, you lose (This is called busting).
  167.     4. You start by looking at your cards (and usually at the dealer's
  168.         "up" card for information) and decide if you would like 
  169.         to take additional cards one at a time (This is hitting). 
  170.         You may stay with your current hand at any time (This is
  171.         standing).
  172.     5. After you stand, the dealer plays. The dealer must take a hit
  173.         until his hand's value is between 17 and 21, inclusive, or 
  174.         busted. NOTE: The dealer is forced to act in this manner and
  175.         is not allowed to deviate from it, regardless of your hand's
  176.         value.
  177.     6. If you bust or the dealer's hand is closer to 21 than yours, you
  178.         lose your bet.
  179.     7. If you did not bust and your hand is closer to 21 than the 
  180.         dealer's hand, the dealer will match your bet and you may 
  181.         walk away richer or play another hand.
  182.     8. If you tie (called a Push), the delaer will leave your bet on the
  183.         table. You may pick it up an leave no better or worse off or
  184.         play another hand.
  185.  
  186. Doubling:
  187.     If you have two cards (sometimes the casino will stipulate that the
  188. total value of those two cards is 10 or 11), you may double your bet. But,
  189. to take advantage of this option, the dealer will give you one more card and 
  190. you are not allowed to take additional cards.
  191.  
  192. Splitting:
  193.     If your hand has only two cards they have the same value, 
  194. you may split the hand into two hands. You will have to place an additional
  195. bet equal to your original bet so that both hand will have the same bet.
  196. Both hands will begin with one of the two paired cards. After you split, 
  197. you play each hand in turn as if they were independent hands.  These hands 
  198. are playing against the dealer only and not between themselves 
  199. (In other words, both can win or lose independent of the other).
  200.     ** If you receive a pair of aces and you split them, you will only
  201. receive one card to each split ace and will not be able to do anything else
  202. unless you receive another ace and you are allowed to re-split aces.
  203.  
  204. Blackjack:
  205.     The BlackJack is the most coveted hand in the game. If you get one 
  206. and the dealer does not have one, you will receive 1.5 times your bet instead
  207. of the usual equal match if you win.
  208.     BlackJack is when you have a hand value of 21 dealt to you with
  209. your first two cards (Note: splitting a hand and then getting 21 with two 
  210. cards does NOT cout as BlackJack).  In order to make a value of 21 with
  211. two cards, one must be an Ace and the other must be a Ten, Jack, Queen, 
  212. or King.
  213.  
  214. Insurance:
  215.     If the dealer's "up" card is an ace, he will ask you if you would
  216. like to take insurance.  If you do, you have to place an additional 1/2 of
  217. your bet on the table. After you choose whether or not to take insurance,
  218. the dealer will check if he has a BlackJack (but he will not show you his
  219. hidden card until later).
  220.     If you do not take insurance and the dealer has a BlackJack, he will
  221. expose his cards and immediately take your bet (even if you have a 
  222. BlackJack yourself). If you do not take insurance and the dealer does not 
  223. have BlackJack, the hand will continue as normal.
  224.     If you take insurance and the dealer has a BlackJack, he will
  225. expose his card, pay two times the insurance bet, and take your original bet.
  226. The net effect of this will be that you will be at the same place you were
  227. before you played the hand. If you take insurance and the dealer does not
  228. have BlackJack, he will take your insurance money and the hand will continue
  229. as normal.
  230.  
  231. Surrender:
  232.     If the casino offers surrender, you may be able to get out of a bad 
  233. hand and lose only half your bet (instead of losing the whole thing). You
  234. may surrender only with your original two cards.  If the casino offers early
  235. surrender (I don't know any casinos that do), you will be able to get half
  236. your bet back no matter what the dealer holds.  If the casino offers late
  237. surrender, you will be able to get half your bet back only if the dealer does
  238. not have blackjack.
  239.  
  240. NOTES
  241. -----
  242.  
  243. It is possible that the deck will run out of cards before the end of a hand.
  244. In this case, the dealer will choose cards at random from an infinitely
  245. large shoe. When the hand is over the dealer will shuffle. Although this is
  246. not what the casinos do, it is a very rare circumstance and should not
  247. affect your play.
  248.  
  249. If you receive a pair of aces and decide to split them, the program will 
  250. automatically split any subsequent pairs of aces you receive if you are
  251. allowed to re-split aces. This saves you the effort of hitting the buttons.
  252.  
  253. DISTRIBUTION
  254. ------------
  255.  
  256. You may distribute the UNREGISTERED version of BJTutor freely as long as
  257. all files from the original distribution are included and no modifications
  258. are made.
  259.  
  260. You may not distribute the REGISTERED version of BJTutor in any way.
  261.  
  262. DISCLAIMER
  263. ----------
  264.  
  265. This software is distributed for entertainment only and should be viewed as
  266. such. The author is not responsible for any other use of the software and is
  267. not responsible for monetary or other losses from the use of this software. 
  268. This software does not promote gambling in any way and does not imply
  269. that it should be used for such.
  270.  
  271. CONTACTING THE AUTHOR
  272. ---------- --- ------
  273.  
  274. You may contact the author via email or postal mail.
  275. The email address is:
  276.     neil27@juno.com
  277. The U.S. Postal address is:
  278.     Neil Aggarwal
  279.     13 Hackamore Court
  280.     Tinton Falls, NJ 07753
  281.     USA
  282.  
  283.