home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / BBS / DOORS / BJFT201.ZIP / BJ.DOC < prev    next >
Encoding:
Text File  |  1991-12-23  |  16.4 KB  |  355 lines

  1.  
  2.  
  3.  
  4.                             Black Jack For Time 2.0
  5.                         Copyright 1990 by John M. Parlin
  6.                                All rights reserved
  7.                             Release Date: 12/25/1991
  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. Those who register this program within one year of its release by the author,
  36. will receive a registration key.  The key will be delivered either by personal
  37. upload, netmail or postal service.  Allow up to 6 weeks for delivery.
  38.  
  39. This program is not guaranteed to do anything except take up hard disk
  40. space.  This program is designed specifically for RemoteAccess BBS software
  41. and also includes support for QuickBBS 2.75 and ProBoard 1.20.
  42.  
  43. Comments, suggestions and bug reports are welcome.  If you have any, you
  44. should contact John Parlin at one of the Fidonet addresses listed below:
  45.  
  46. System Name         | Location          | Sysop Name    |Phone Number|Fido Node
  47. --------------------|-------------------|---------------|------------|---------
  48. O-Zone BBS          | New Hope, MN      | Jim Biggs     |612-591-7767|1:282/30
  49. Beg, Borrow or Steal| Eden Prairie, MN  | Paul Andre    |612-934-2982|1:282/37
  50. Odyssey BBS         | Edina, MN         | Stan Hirschman|612-832-5127|1:282/40
  51.  
  52.  
  53. If you're reporting a bug, please give as much detail as possible about the
  54. problem you are experiencing so that it can be duplicated and fixed.
  55.  
  56.  
  57. ╒═════════════════════════════════════════════════════════════════════════════╕
  58. │░░░░░░ INTRODUCTION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  59. ╘═════════════════════════════════════════════════════════════════════════════╛
  60.  
  61. Black Jack For Time is an online door program written specifically for
  62. RemoteAccess BBS software.  In addition, this program supports QuickBBS 2.64
  63. thru 2.75 and ProBoard 1.20.
  64.  
  65. The game challenges players to beat the dealer at the game of Twenty-One or
  66. "Black Jack".  Players gamble their online time in this fast-paced game.
  67. The program allows the System Operator to define settings such as maximum
  68. number of hands playable per day per player, and chip or "coin" value in
  69. minutes.
  70.  
  71. Black Jack For Time is "aware" of upcoming system events as defined in
  72. RemoteAccess or QuickBBS and will not allow players to over-run these system
  73. events.  If a player wins an amount of time that would over-run an upcoming
  74. system event, Black Jack For Time will automatically deposit the correct
  75. number of minutes into the player's time bank account if a time bank such as
  76. RATS (RemoteAccess TimeBank System) is being used.
  77.  
  78. Due to the graphic nature of the game, this version requires players to have
  79. ANSI graphics enabled.  Players are given a choice between color and "mono
  80. graphics".
  81.  
  82.  
  83. ╒═════════════════════════════════════════════════════════════════════════════╕
  84. │░░░░░░ INSTALLATION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  85. ╘═════════════════════════════════════════════════════════════════════════════╛
  86.  
  87. Black Jack For Time can be setup in minutes.  Just create a subdirectory for
  88. the program and unpack the distribution archive into this subdirectory.
  89. Next, edit the configuration file BJ.CFG.  This file is an ASCII text file.
  90. The first 7 lines are read from this file to gather the configuration
  91. information.  All other lines are ignored.  Here is a sample BJ.CFG file:
  92.  
  93. <Top of file>
  94. \RA\
  95. \RA\
  96. 1
  97. 2
  98. 15
  99. 50
  100. 120
  101. <End of file>
  102.  
  103. Here is an explaination of what each line of data is:
  104.  
  105. Line 1 : Path to DORINFO1.DEF/EXITINFO.BBS.  (i.e. \RA\)
  106. Line 2 : Path to RATS.EXE.  This is where the external time bank support
  107.          file will be appended/created.
  108. Line 3 : This is the 'node' or 'line' number in use.  BJ will always look
  109.          dor a DORINFO1.DEF dropfile in the path indicated by line number
  110.          1 above.  The number indicated here is reflected on the status
  111.          bar display.
  112. Line 4 : Coin Value.  This is how many minutes each coin/chip is worth.
  113. Line 5 : This is the maximum number of coins that can be bet on any one
  114.          hand.
  115. Line 6 : This is the maximum numbers of turns a player may have per day.
  116. Line 7 : Maximum winnings.  This is a value between 1 and 32000.  If not in
  117.          this range, the default of 500 will be used.  This is the maximum
  118.          number of minutes that a player can come back to the BBS with.
  119.          Anything over this amount will be automatically deposited in the
  120.          user's RATS bank account (or chopped off it RATS is not being used).
  121.          If you're not using RATS, set this value high if you want to avoid
  122.          chopping the user's time off.
  123.  
  124. You the Sysop can have control over how much a player can win.  By setting
  125. the maximum bet per hand and maximum number of turns a player may have per
  126. day, you can taylor Black Jack For Time so that users don't win "too much"
  127. time.  The setting shown in this configuration example would allow players
  128. to bet up to 15 coins (15 x CoinValue) per hand and play up to 50 hands
  129. per day.
  130.  
  131. Once this file is edited, Black Jack For Time should be executed using a type
  132. 7 menu entry.  There are no command line parameters required or accepted.
  133.  
  134. Here is a sample of a type 7 menu entry that might be used to execute
  135. Black Jack For Time:
  136.  
  137. Type 7 command line:
  138.  
  139.  *C /c \RA\BJACK.BAT
  140.  
  141. BJACK.BAT:
  142.  
  143.  CD \RA\BJACK
  144.  BJ.EXE BJ.CFG
  145.  CD \RA
  146.  
  147. Or, if you are running Black Jack For Time from the BBS system directory,
  148. no batch file is needed:
  149.  
  150. Type 7 command line:
  151.  
  152.  BJ.EXE BJ.CFG
  153.  
  154. That's all there is to installing Black Jack For Time.
  155.  
  156.  
  157. ╒═════════════════════════════════════════════════════════════════════════════╕
  158. │░░░░░░ SUPPORT FILES ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  159. ╘═════════════════════════════════════════════════════════════════════════════╛
  160.  
  161. The following is a list of files related to the operation of this program.
  162. It is noted whether or not the file is absolutely required in order for the
  163. program to run.
  164.  
  165.  Filename       Required   Description
  166.  ------------   --------   -------------------------------------------------
  167.  BJ.EXE           Yes      The main executable.
  168.  BJOPEN.ANS       Yes      Introduction graphic - color.
  169.  BJOPEN.ASC       Yes      Introdcution graphic - mono.
  170.  BJSCREEN.ANS     Yes      The graphic game board - color.
  171.  BJSCREEN.ASC     Yes      The graphic game board - mono.
  172.  YOUWON.ANS       Yes      Graphic displayed to winners - color.
  173.  YOUWON.ASC       Yes      Graphic displayed to winners - mono.
  174.  YOULOST.ANS      Yes      Graphic displayed to losers - color.
  175.  YOULOST.ASC      Yes      Graphic displayed to losers - mono.
  176.  BJ.CFG           Yes      The configuration file.
  177.  BJ.HLP           Yes      The online help file.
  178.  BJ.DOC           No       This documentation.
  179.  BJ.NEW           No       A text file describing new features.
  180.  BJ.TRN           No       A player turn file.  This is created by the main
  181.                            executable and is used to track player's daily
  182.                            turns.
  183.  BJ.DTE           No       Julian date file.  This is created by the main
  184.                            executable and is used to track date changes.
  185.  BJREG.DOC        No       The program registration form.
  186.  
  187.  
  188. ╒═════════════════════════════════════════════════════════════════════════════╕
  189. │░░░░░░ PLAYING THE GAME ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  190. ╘═════════════════════════════════════════════════════════════════════════════╛
  191.  
  192. Betting:
  193.  
  194. Before the deal begins, the player must place his bet in coins.  This is done
  195. by selecting <P>lace Bet.  The game will allow players to gamble up to a pre-
  196. determined number of coins (per hand) as defined by the System Operator.
  197.  
  198. Players may not, at anytime, gamble their last coin.  Coins have a value pre-
  199. determined by the System Operator.  For example, one coin may be worth 1 or
  200. more minutes as defined by the System Operator.  Once a bet is placed, the
  201. amount of the bet is subtracted from the player's pot.  The player's time
  202. remaining field is updated as well.
  203.  
  204. The Deal:
  205.  
  206. After the player's bet is down, the dealer removes the top card from the
  207. dealing box and lays it down, face-up on the player's table.  Next, the
  208. dealer deals one card, face-up on his own table.  He then deals a second
  209. face-up card on the player's table and one face-down card on his own table.
  210.  
  211. The Play:
  212.  
  213. If the dealer's face-up card is a 10 count, he must look at his hole (face-
  214. down) card.  If he has a natural 21 (a count of 21 with two cards), he must
  215. face it and announce "Twenty-One".
  216.  
  217. If the player also has Twenty-One, the dealer declares this to be a
  218. 'stand-off' or 'push'.  There is no action on this hand and no payoff is
  219. made.  The player's bet is returned and there is no winner or loser.
  220.  
  221. If the dealer's face-up card is an Ace, the player may buy insurance at an
  222. amount equal to half of the current bet.  If the dealer holds a natural
  223. twenty-one, the player wins the insurance bet and is paid 2 minutes for each
  224. minute wagered.  If the dealer does not hold a natural twenty-one, the player
  225. loses the insurance bet and plays the hand through to conclusion with the
  226. original amount bet riding on the hand.
  227.  
  228. When the dealer does not hold a Twenty-One, but the player does, the
  229. player wins the hand and is payed off at 3 to 1 odds.  The dealer does
  230. not take a turn and the hand is then ended.
  231.  
  232. If neither the dealer nor player have Twenty-One and the player's two
  233. cards total less than 21 the player may chose to Double Down.  If the player
  234. choses to Double Down, the amount bet is doubled and the dealer deals ONE
  235. FINAL card to the player's hand.  The dealer then takes his turn in sequence.
  236. If the player wins the hand, the Double Down is paid off at 2 to 1 odds.
  237.  
  238. If the player does not select to Double Down, he may:
  239.  
  240.         <S>tay  Either the player is satisfied with his count or he
  241.                 suspects that drawing another card may make his count
  242.                 go over 21.
  243.  
  244.         <H>it   To draw a card or cards.  When the player is not
  245.                 satisfied with his count, he may draw as many cards as
  246.                 he likes.  When he believes his count is as good as he
  247.                 can do, the player should elect to <S>tay.
  248.  
  249. If the player goes over a count of 21, the dealer announces a bust.  The
  250. player loses the hand and the hand is then ended.
  251.  
  252. If the player receives 5 cards and has a count of less than 21, the
  253. game will declare a "Five-Card Charlie".  The dealer then pays off at
  254. 3 to 1 odds.
  255.  
  256. If the player holds a count of 21, the dealer pays off at 3 to 1 odds.
  257.  
  258. The Dealer's Turn at Play:
  259.  
  260. If the player has busted, the hand is ended and the player is returned
  261. to the game menu.  If the player's hand is still active, the dealer
  262. plays his hand.
  263.  
  264.         - The dealer turns up his hole card so that all his cards are
  265.           exposed.
  266.  
  267.         - If his count is 17, 18, 19 or 20, the dealer must stay.
  268.  
  269.         - If his count is 16 or less, he must draw a card and
  270.           continue to draw until his count reaches 17 or more--at
  271.           which point he must stay.  If the dealer holds a 'soft' 17,
  272.           i.e., a 17 count which includes an ace, he must also stay.
  273.           This also applies to a soft 18, 19 or 20.
  274.  
  275. It is important to note here that the Black Jack dealer has no choice of
  276. whether to stay or draw.  His decisions are predetermined and known to
  277. the player.  Since all the dealer's cards are exposed at this turn of
  278. play, he has no opportunity for any departure from these rules.
  279.  
  280. The rule requiring the dealer to hit on 16 or less and stay on 17, 18,
  281. 19, 20 and 21 is standard today in all major casinos here and abroad.
  282.  
  283. If the dealer has played 5 cards and has a count of less than 21, the
  284. dealer announces a "Five-Card Charlie" and wins the hand.  Even if the
  285. player's count is 21, a "Five-Card Charlie" wins the hand in this BBS-
  286. Style game of Black Jack.
  287.  
  288. Final Settlement:
  289.  
  290. At the end of his play the dealer pays off the player if the player
  291. has a higher count than his.  If the player has a higher count, but does
  292. not have Twenty-One, the dealer pays off at 2 to 1 odds.  In other words,
  293. the player will get back the amount of coins bet, and the dealer will
  294. also match this amount.  So, if a player has bet 2 coins, the dealer will
  295. pay 4 coins if the player's count is greater than his.
  296.  
  297. The Double Down:
  298.  
  299. The player, after being dealt his first two cards (which may be any two
  300. cards) may elect to double his bet and draw one additional card only.
  301. This is known as double down or down for double.  Once the first two cards
  302. are dealt to the player, the player will be prompted whether he would like to
  303. go double down.  The program will not prompt the player if the player does
  304. not have enough coins remaining to double his bet and still leave one coin
  305. in his pot.
  306.  
  307. The player is then dealt a third and final card.  The dealer then takes
  308. his turn at play.  Once the dealer's play is ended, the player's hand
  309. is counted.
  310.  
  311.  
  312. ╒═════════════════════════════════════════════════════════════════════════════╕
  313. │░░░░░░ SYSTEM EVENTS AND AUTOMATIC TIME DEPOSITS ░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  314. ╘═════════════════════════════════════════════════════════════════════════════╛
  315.  
  316. When the player either reaches the maximum number of turns allowed per
  317. day (as defined by the System Operator), or selects to end the game, a
  318. brief statement is displayed which shows how the player did.
  319.  
  320. Most Bulletin Board Systems have a System Event schedule.  These
  321. events are run at predetermined times and are used to ensure that tasks
  322. such as maintenance and mail-hours are executed.
  323.  
  324. If a player wins an amount of time that would over-run an upcoming system
  325. event, Black Jack For Time will adjust the player's time remaining to avoid
  326. over-running the event and will deposit time that would otherwise be lost
  327. (taken back by the system), into the player's online time bank account.
  328.  
  329. If the System Operator is not running a time bank program such as RATS
  330. (RemoteAccess TimeBank System) the system will then trim the player's
  331. winnings down to avoid allowing the player to over-run a system event.
  332.  
  333.  
  334.  
  335. ╒═════════════════════════════════════════════════════════════════════════════╕
  336. │░░░░░░ NOTES FROM THE AUTHOR ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  337. ╘═════════════════════════════════════════════════════════════════════════════╛
  338.  
  339. Starting with release 2.0, Black Jack For Time provides automatic EXITINFO
  340. format detection for RemoteAccess 1.01 thru 1.10 and QuickBBS 2.64 thru 2.75
  341. and ProBoard 1.20.  Black Jack For Time uses the communications library
  342. JPDoor 3.01 SE from Motor City Software.
  343.  
  344. Starting with release 1.4, Black Jack For Time will automatically detect
  345. whether it is running under RemoteAccess 0.04, 1.00, 1.10 or QuickBBS 2.75
  346. Therefore, the conversion program CVT.EXE which was previously required
  347. for QuickBBS systems is no longer needed.
  348.  
  349. Also effective with release 1.4, the key structure has been changed.  If you
  350. were previously registered and would like to obtain a new registration key
  351. number, please contact me through one of the FidoNet bulletin board systems
  352. listed above in this document.  A registration number will be expedited to
  353. you.
  354.  
  355.