home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-386-Vol-2of3.iso / b / bjft12.zip / BJ.DOC < prev    next >
Text File  |  1991-05-04  |  15KB  |  330 lines
  1.  
  2.  
  3.  
  4.                             Black Jack For Time 1.2
  5.                         Copyright 1990 by John M. Parlin
  6.                                All rights reserved
  7.  
  8.  
  9.  
  10. ╒═════════════════════════════════════════════════════════════════════════════╕
  11. │░░░░░░ LICENSING INFORMATION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  12. ╘═════════════════════════════════════════════════════════════════════════════╛
  13.  
  14. This program is not Freeware.  This is SHAREWARE which means it is user-
  15. supported software.  If you use this program for more than 30 days, you are
  16. required to register or remove it from your system.  The registration fee is
  17. a mere $10.00 and is not a lot to ask.
  18.  
  19. The concept works only with your support.  If you find that you can use this
  20. program, then a registration fee of $10.00 U.S. funds will help defray the
  21. development cost and encourage the authorship of other programs that might be
  22. useful to you.  A  Registration Form for this purpose is included with the
  23. distribution archive and is called BJREG.DOC.
  24.  
  25. Black Jack For Time is Copyrighted 1991 by John M. Parlin and all rights are
  26. reserved.  You may copy this program and documentation for backup purposes.
  27. You also may copy and share UNMODIFIED copies of the program package,
  28. providing that the copyright notice is reproduced and included on all copies.
  29.  
  30. You may not sell the product for a fee and/or distribute the product
  31. along with other products without expressed written permission from John
  32. Parlin, nor may you modify or remove the Copyright Notice from the
  33. program or the documentation.
  34.  
  35. Comments, suggestions and bug reports are welcome.  If you have any, you
  36. should contact John Parlin at Fidonet address 1:282/12.0, City Terminal BBS
  37. (612)938-4301 (1200/2400 baud).
  38.  
  39. If you're reporting a bug, please give as much detail as possible about the
  40. problem you are experiencing so that it can be duplicated and fixed.
  41.  
  42.  
  43.  
  44. ╒═════════════════════════════════════════════════════════════════════════════╕
  45. │░░░░░░ INTRODUCTION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  46. ╘═════════════════════════════════════════════════════════════════════════════╛
  47.  
  48. Black Jack For Time is an online door program written specifically for
  49. RemoteAccess 1.0x.  The program REQUIRES the RemoteAccess 1.0x format
  50. EXITINFO.BBS file and a FOSSIL driver.
  51.  
  52. The game challenges players to beat the dealer at the game of Twenty-One or
  53. "Black Jack".  Players gamble their online time in this fast-paced game.
  54. The program allows the System Operator to define settings such as maximum
  55. number of hands playable per day per player, and chip or "coin" value in
  56. minutes.
  57.  
  58. Black Jack For Time is designed for RemoteAccess 1.0x systems.  Therefore,
  59. the game is "aware" of upcoming system events as defined in RemoteAccess and
  60. will not allow players to over-run these system events.  If a player wins an
  61. amount of time that would over-run an upcoming system event, Black Jack For
  62. Time will automatically deposit the correct number of minutes into the
  63. player's time bank account if a time bank such as RATS (RemoteAccess TimeBank
  64. System) is being used.
  65.  
  66. Due to the graphic nature of the game, this version requires players to have
  67. ANSI graphics enabled.
  68.  
  69.  
  70. ╒═════════════════════════════════════════════════════════════════════════════╕
  71. │░░░░░░ INSTALLATION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  72. ╘═════════════════════════════════════════════════════════════════════════════╛
  73.  
  74. Black Jack For Time can be setup in minutes.  Just create a subdirectory for
  75. the program and unpack the distribution archive into this subdirectory.
  76. Next, edit the configuration file BJ.CFG.  This file is an ASCII text file.
  77. The first 7 lines are read from this file to gather the configuration
  78. information.  All other lines are ignored.  Here is a sample BJ.CFG file:
  79.  
  80. <Top of file>
  81. \RA\
  82. \RA\
  83. 1
  84. 2
  85. 15
  86. 50
  87. 120
  88. <End of file>
  89.  
  90. Here is an explaination of what each line of data is:
  91.  
  92. Line 1 : Path to DORINFOx.DEF/EXITINFO.BBS.  (i.e. \RA\)
  93. Line 2 : Path to RATS.EXE.  This is where the external time bank support
  94.          file will be appended/created.
  95. Line 3 : This is the 'node' or 'line' number in use.  IMPORTANT: If this
  96.          is a '1' then BJ will look for DORINFO1.DEF.  If this is a '2'
  97.          then BJ will look for DORINFO2.DEF, etc..
  98. Line 4 : Coin Value.  This is how many minutes each coin/chip is worth.
  99. Line 5 : This is the maximum number of coins that can be bet on any one
  100.          hand.
  101. Line 6 : This is the maximum numbers of turns a player may have per day.
  102. Line 7 : Maximum winnings.  This is a value between 1 and 32000.  If not in
  103.          this range, the default of 500 will be used.  This is the maximum
  104.          number of minutes that a player can come back to the BBS with.
  105.          Anything over this amount will be automatically deposited in the
  106.          user's RATS bank account (or chopped off it RATS is not being used).
  107.          If you're not using RATS, set this value high if you want to avoid
  108.          chopping the user's time off.
  109.  
  110. You the Sysop can have control over how much a player can win.  By setting
  111. the maximum bet per hand and maximum number of turns a player may have per
  112. day, you can taylor Black Jack For Time so that users don't win "too much"
  113. time.  The setting shown in this configuration example would allow players
  114. to bet up to 15 coins (15 x CoinValue) per hand and play up to 50 hands
  115. per day.
  116.  
  117. Once this file is edited, Black Jack For Time should be executed using a type
  118. 7 menu entry.  There are no command line parameters required or accepted.
  119.  
  120. Here is a sample of a type 7 menu entry that might be used to execute
  121. Black Jack For Time:
  122.  
  123. Type 7 command line:
  124.  
  125.  *C /c \RA\BJACK.BAT
  126.  
  127. BJACK.BAT:
  128.  
  129.  CD \RA\BJACK
  130.  BJ.EXE BJ.CFG
  131.  CD \RA
  132.  
  133. Or, if you are running Black Jack For Time from the BBS system directory,
  134. no batch file is needed:
  135.  
  136. Type 7 command line:
  137.  
  138.  BJ.EXE BJ.CFG
  139.  
  140. That's all there is to installing Black Jack For Time.
  141.  
  142.  
  143.  
  144. ╒═════════════════════════════════════════════════════════════════════════════╕
  145. │░░░░░░ SUPPORT FILES ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  146. ╘═════════════════════════════════════════════════════════════════════════════╛
  147.  
  148. The following is a list of files related to the operation of this program.
  149. It is noted whether or not the file is absolutely required in order for the
  150. program to run.
  151.  
  152.  Filename       Required   Description
  153.  ------------   --------   -------------------------------------------------
  154.  BJ.EXE           Yes      The main executable.
  155.  JP.ANS           Yes      Introduction graphic - color.
  156.  JP.ASC           Yes      Introdcution graphic - mono.
  157.  BJSCREEN.ANS     Yes      The graphic game board - color.
  158.  BJSCREEN.ASC     Yes      The graphic game board - mono.
  159.  YOUWON.ANS       Yes      Graphic displayed to winners - color.
  160.  YOUWON.ASC       Yes      Graphic displayed to winners - mono.
  161.  YOULOST.ANS      Yes      Graphic displayed to losers - color.
  162.  YOULOST.ASC      Yes      Graphic displayed to losers - mono.
  163.  BJ.CFG           Yes      The configuration file.
  164.  BJ.HLP           Yes      The online help file.
  165.  BJ.DOC           No       This documentation.
  166.  BJ.NEW           No       A text file describing new features.
  167.  BJ.TRN           No       A player turn file.  This is created by the main
  168.                            executable and is used to track player's daily
  169.                            turns.
  170.  BJ.DTE           No       Julian date file.  This is created by the main
  171.                            executable and is used to track date changes.
  172.  BJREG.DOC        No       The program registration form.
  173.  
  174. ╒═════════════════════════════════════════════════════════════════════════════╕
  175. │░░░░░░ PLAYING THE GAME ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  176. ╘═════════════════════════════════════════════════════════════════════════════╛
  177.  
  178. Betting:
  179.  
  180. Before the deal begins, the player must place his bet in coins.  This is done
  181. by selecting <P>lace Bet.  The game will allow players to gamble up to a pre-
  182. determined number of coins (per hand) as defined by the System Operator.
  183. Players may not, at anytime, gamble their last coin.  Coins have a value pre-
  184. determined by the System Operator.  For example, one coin may be worth 1 or
  185. more minutes as defined by the System Operator.  Once a bet is placed, the
  186. amount of the bet is subtracted from the player's pot.  The player's time
  187. remaining field is updated as well.
  188.  
  189. The Deal:
  190.  
  191. After the player's bet is down, the dealer removes the top card from the
  192. dealing box and lays it down, face-up on the player's table.  Next, the
  193. dealer deals one card, face-up on his own table.  He then deals a second
  194. face-up card on the player's table and one face-down card on his own table.
  195.  
  196. The Play:
  197.  
  198. If the dealer's face-up card is a 10 count or an ace, he must look at his
  199. hole (face-down) card.  If he has a natural 21 (a count of 21 with two
  200. cards), he must face it and announce "Twenty-One".
  201.  
  202. If the player also has Twenty-One, the dealer declares this to be a
  203. 'stand-off' or 'push'.  There is no action on this hand and no payoff is
  204. made.  The player's bet is returned and there is no winner or loser.
  205.  
  206. If the player does not also have Twenty-One, the dealer wins and the
  207. hand is ended.
  208.  
  209. When the dealer does not hold a Twenty-One, but the player does, the
  210. player wins the hand and is payed off at 3 to 1 odds.  The dealer does
  211. not take a turn and the hand is then ended.
  212.  
  213. If neither the dealer nor player have Twenty-One and the player's two
  214. cards total less than 21 the player may:
  215.  
  216.         <S>tay  Either the player is satisfied with his count or he
  217.                 fears that another card may make his count go over
  218.                 21.
  219.  
  220.         <H>it   To draw a card or cards.  When the player is not
  221.                 satisfied with is count, he may draw as many cards as
  222.                 he likes.  When he believes his count is as good as he
  223.                 can do, the player should elect to <S>tay.
  224.  
  225. If the player goes over a count of 21, the dealer announces a bust.  The
  226. player loses the hand and the hand is then ended.
  227.  
  228. If the player receives 5 cards and has a count of less than 21, the
  229. game will declare a "Five-Card Charlie".  The dealer then pays off at
  230. 3 to 1 odds.
  231.  
  232. If the player holds a count of 21, the dealer pays off at 3 to 1 odds.
  233.  
  234. The Dealer's Turn at Play:
  235.  
  236. If the player has busted, the hand is ended and the player is returned
  237. to the game menu.  If the player's hand is still active, the dealer
  238. plays his hand.
  239.  
  240.         - The dealer turns up his hole card so that all his cards are
  241.           exposed.
  242.  
  243.         - If his count is 17, 18, 19 or 20, the dealer must stay.
  244.  
  245.         - If his count is 16 or less, he must draw a card and
  246.           continue to draw until his count reaches 17 or more--at
  247.           which point he must stay.  If the dealer holds a 'soft' 17,
  248.           i.e., a 17 count which includes an ace, he must also stay.
  249.           This also applies to a soft 18, 19 or 20.
  250.  
  251. It is important to note here that the Black Jack dealer has no choice of
  252. whether to stay or draw.  his decisions are predetermined and known to
  253. the player.  Since all the dealer's cards are exposed at this turn of
  254. play, he has no opportunity for any departure from these rules.
  255.  
  256. The rule requiring the dealer to hit on 16 or less and stay on 17, 18,
  257. 19, 20 and 21 is standard today in all major casinos here and abroad.
  258.  
  259. If the dealer has played 5 cards and has a count of less than 21, the
  260. dealer announces a "Five-Card Charlie" and wins the hand.  Even if the
  261. player's count is 21, a "Five-Card Charlie" wins the hand in this BBS-
  262. Style game of Black Jack.
  263.  
  264. Final Settlement:
  265.  
  266. At the end of his play the dealer pays off the player if the player
  267. has a higher count than his.  If the player has a higher count, but does
  268. not have Twenty-One, the dealer pays off at 2 to 1 odds.  In other words,
  269. the player will get back the amount of coins bet, and the dealer will
  270. also match this amount.  So, if a player has bet 2 coins, the dealer will
  271. pay 4 coins if the player's count is greater than his.
  272.  
  273. The Double Down:
  274.  
  275. The player, after being dealt his first two cards (which may be any two
  276. cards totalling a count of 11) may elect to double his bet and draw one
  277. additional card only.  This is known as double down or down for double.
  278. If the dealer deals a count of 11 in the player's first two cards, the
  279. player will be prompted whether he would like to go double down or not.
  280. The program will not prompt the player if the player does not have enough
  281. coins remaining to double his bet and still leave one coin in his pot.
  282.  
  283. The player is then dealt a third and final card.  The dealer then takes
  284. his turn at play.  Once the dealer's play is ended, the player's hand
  285. is counted.
  286.  
  287.  
  288. ╒═════════════════════════════════════════════════════════════════════════════╕
  289. │░░░░░░ SYSTEM EVENTS AND AUTOMATIC TIME DEPOSITS ░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  290. ╘═════════════════════════════════════════════════════════════════════════════╛
  291.  
  292. When the player either reaches the maximum number of turns allowed per
  293. day (as defined by the System Operator), or selects to end the game, a
  294. brief statement is displayed which shows how the player did.
  295.  
  296. Most Bulletin Board Systems have a System Event schedule.  These
  297. events are run at predetermined times and are used to ensure that tasks
  298. such as maintenance and mail-hours are executed.  In fact, to ensure proper
  299. operation, it is recommended that you define at least one system event in
  300. RemoteAccess.
  301.  
  302. If a player wins an amount of time that would overrun an upcoming system
  303. event, Black Jack For Time will adjust the player's time remaining to avoid
  304. overrunning the event and will deposit time that would otherwise be
  305. lost (taken back by the system), into the player's online time bank account.
  306. If the System Operator is not running a time bank program such as RATS
  307. (RemoteAccess TimeBank System) or QuickBank (copyright David Kuhn) the
  308. system will then trim the player's winnings down to avoid allowing the
  309. player to overrun a system event.
  310.  
  311.  
  312. ╒═════════════════════════════════════════════════════════════════════════════╕
  313. │░░░░░░ NOTES FROM THE AUTHOR ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  314. ╘═════════════════════════════════════════════════════════════════════════════╛
  315.  
  316. I have only one thing to add and that is running Black Jack For Time on
  317. QuickBBS 2.75, QuickBBS 2.64 or SuperBBS.
  318.  
  319. If you are running one of these BBS's, you will need to run the CVT.EXE
  320. utility prior to running Black Jack For Time.  CVT.EXE accepts no command
  321. line parameters.  Just execute it in the same directory where EXITINFO.BBS
  322. exists.  CVT.EXE will automatically detect which format is being used and
  323. will convert it to RA 1.00 format.
  324.  
  325. Once Black Jack For Time is exited, run CVT.EXE a second time and it will
  326. convert the EXITINFO.BBS file back to the proper format.  If you have any
  327. problems with this utility, please contact the author.
  328.  
  329.  
  330.