home *** CD-ROM | disk | FTP | other *** search
-
-
-
- Black Jack For Time 2.0
- Copyright 1990 by John M. Parlin
- All rights reserved
- Release Date: 12/25/1991
-
-
- ╒═════════════════════════════════════════════════════════════════════════════╕
- │░░░░░░ LICENSING INFORMATION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
- ╘═════════════════════════════════════════════════════════════════════════════╛
-
- This program is not Freeware. This is SHAREWARE which means it is user-
- supported software. If you use this program for more than 30 days, you are
- required to register or remove it from your system. The registration fee is
- a mere $10.00 and is not a lot to ask.
-
- The concept works only with your support. If you find that you can use this
- program, then a registration fee of $10.00 U.S. funds will help defray the
- development cost and encourage the authorship of other programs that might be
- useful to you. A Registration Form for this purpose is included with the
- distribution archive and is called BJREG.DOC.
-
- Black Jack For Time is Copyrighted 1991 by John M. Parlin and all rights are
- reserved. You may copy this program and documentation for backup purposes.
- You also may copy and share UNMODIFIED copies of the program package,
- providing that the copyright notice is reproduced and included on all copies.
-
- You may not sell the product for a fee and/or distribute the product
- along with other products without expressed written permission from John
- Parlin, nor may you modify or remove the Copyright Notice from the
- program or the documentation.
-
- Those who register this program within one year of its release by the author,
- will receive a registration key. The key will be delivered either by personal
- upload, netmail or postal service. Allow up to 6 weeks for delivery.
-
- This program is not guaranteed to do anything except take up hard disk
- space. This program is designed specifically for RemoteAccess BBS software
- and also includes support for QuickBBS 2.75 and ProBoard 1.20.
-
- Comments, suggestions and bug reports are welcome. If you have any, you
- should contact John Parlin at one of the Fidonet addresses listed below:
-
- System Name | Location | Sysop Name |Phone Number|Fido Node
- --------------------|-------------------|---------------|------------|---------
- O-Zone BBS | New Hope, MN | Jim Biggs |612-591-7767|1:282/30
- Beg, Borrow or Steal| Eden Prairie, MN | Paul Andre |612-934-2982|1:282/37
- Odyssey BBS | Edina, MN | Stan Hirschman|612-832-5127|1:282/40
-
-
- If you're reporting a bug, please give as much detail as possible about the
- problem you are experiencing so that it can be duplicated and fixed.
-
-
- ╒═════════════════════════════════════════════════════════════════════════════╕
- │░░░░░░ INTRODUCTION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
- ╘═════════════════════════════════════════════════════════════════════════════╛
-
- Black Jack For Time is an online door program written specifically for
- RemoteAccess BBS software. In addition, this program supports QuickBBS 2.64
- thru 2.75 and ProBoard 1.20.
-
- The game challenges players to beat the dealer at the game of Twenty-One or
- "Black Jack". Players gamble their online time in this fast-paced game.
- The program allows the System Operator to define settings such as maximum
- number of hands playable per day per player, and chip or "coin" value in
- minutes.
-
- Black Jack For Time is "aware" of upcoming system events as defined in
- RemoteAccess or QuickBBS and will not allow players to over-run these system
- events. If a player wins an amount of time that would over-run an upcoming
- system event, Black Jack For Time will automatically deposit the correct
- number of minutes into the player's time bank account if a time bank such as
- RATS (RemoteAccess TimeBank System) is being used.
-
- Due to the graphic nature of the game, this version requires players to have
- ANSI graphics enabled. Players are given a choice between color and "mono
- graphics".
-
-
- ╒═════════════════════════════════════════════════════════════════════════════╕
- │░░░░░░ INSTALLATION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
- ╘═════════════════════════════════════════════════════════════════════════════╛
-
- Black Jack For Time can be setup in minutes. Just create a subdirectory for
- the program and unpack the distribution archive into this subdirectory.
- Next, edit the configuration file BJ.CFG. This file is an ASCII text file.
- The first 7 lines are read from this file to gather the configuration
- information. All other lines are ignored. Here is a sample BJ.CFG file:
-
- <Top of file>
- \RA\
- \RA\
- 1
- 2
- 15
- 50
- 120
- <End of file>
-
- Here is an explaination of what each line of data is:
-
- Line 1 : Path to DORINFO1.DEF/EXITINFO.BBS. (i.e. \RA\)
- Line 2 : Path to RATS.EXE. This is where the external time bank support
- file will be appended/created.
- Line 3 : This is the 'node' or 'line' number in use. BJ will always look
- dor a DORINFO1.DEF dropfile in the path indicated by line number
- 1 above. The number indicated here is reflected on the status
- bar display.
- Line 4 : Coin Value. This is how many minutes each coin/chip is worth.
- Line 5 : This is the maximum number of coins that can be bet on any one
- hand.
- Line 6 : This is the maximum numbers of turns a player may have per day.
- Line 7 : Maximum winnings. This is a value between 1 and 32000. If not in
- this range, the default of 500 will be used. This is the maximum
- number of minutes that a player can come back to the BBS with.
- Anything over this amount will be automatically deposited in the
- user's RATS bank account (or chopped off it RATS is not being used).
- If you're not using RATS, set this value high if you want to avoid
- chopping the user's time off.
-
- You the Sysop can have control over how much a player can win. By setting
- the maximum bet per hand and maximum number of turns a player may have per
- day, you can taylor Black Jack For Time so that users don't win "too much"
- time. The setting shown in this configuration example would allow players
- to bet up to 15 coins (15 x CoinValue) per hand and play up to 50 hands
- per day.
-
- Once this file is edited, Black Jack For Time should be executed using a type
- 7 menu entry. There are no command line parameters required or accepted.
-
- Here is a sample of a type 7 menu entry that might be used to execute
- Black Jack For Time:
-
- Type 7 command line:
-
- *C /c \RA\BJACK.BAT
-
- BJACK.BAT:
-
- CD \RA\BJACK
- BJ.EXE BJ.CFG
- CD \RA
-
- Or, if you are running Black Jack For Time from the BBS system directory,
- no batch file is needed:
-
- Type 7 command line:
-
- BJ.EXE BJ.CFG
-
- That's all there is to installing Black Jack For Time.
-
-
- ╒═════════════════════════════════════════════════════════════════════════════╕
- │░░░░░░ SUPPORT FILES ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
- ╘═════════════════════════════════════════════════════════════════════════════╛
-
- The following is a list of files related to the operation of this program.
- It is noted whether or not the file is absolutely required in order for the
- program to run.
-
- Filename Required Description
- ------------ -------- -------------------------------------------------
- BJ.EXE Yes The main executable.
- BJOPEN.ANS Yes Introduction graphic - color.
- BJOPEN.ASC Yes Introdcution graphic - mono.
- BJSCREEN.ANS Yes The graphic game board - color.
- BJSCREEN.ASC Yes The graphic game board - mono.
- YOUWON.ANS Yes Graphic displayed to winners - color.
- YOUWON.ASC Yes Graphic displayed to winners - mono.
- YOULOST.ANS Yes Graphic displayed to losers - color.
- YOULOST.ASC Yes Graphic displayed to losers - mono.
- BJ.CFG Yes The configuration file.
- BJ.HLP Yes The online help file.
- BJ.DOC No This documentation.
- BJ.NEW No A text file describing new features.
- BJ.TRN No A player turn file. This is created by the main
- executable and is used to track player's daily
- turns.
- BJ.DTE No Julian date file. This is created by the main
- executable and is used to track date changes.
- BJREG.DOC No The program registration form.
-
-
- ╒═════════════════════════════════════════════════════════════════════════════╕
- │░░░░░░ PLAYING THE GAME ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
- ╘═════════════════════════════════════════════════════════════════════════════╛
-
- Betting:
-
- Before the deal begins, the player must place his bet in coins. This is done
- by selecting <P>lace Bet. The game will allow players to gamble up to a pre-
- determined number of coins (per hand) as defined by the System Operator.
-
- Players may not, at anytime, gamble their last coin. Coins have a value pre-
- determined by the System Operator. For example, one coin may be worth 1 or
- more minutes as defined by the System Operator. Once a bet is placed, the
- amount of the bet is subtracted from the player's pot. The player's time
- remaining field is updated as well.
-
- The Deal:
-
- After the player's bet is down, the dealer removes the top card from the
- dealing box and lays it down, face-up on the player's table. Next, the
- dealer deals one card, face-up on his own table. He then deals a second
- face-up card on the player's table and one face-down card on his own table.
-
- The Play:
-
- If the dealer's face-up card is a 10 count, he must look at his hole (face-
- down) card. If he has a natural 21 (a count of 21 with two cards), he must
- face it and announce "Twenty-One".
-
- If the player also has Twenty-One, the dealer declares this to be a
- 'stand-off' or 'push'. There is no action on this hand and no payoff is
- made. The player's bet is returned and there is no winner or loser.
-
- If the dealer's face-up card is an Ace, the player may buy insurance at an
- amount equal to half of the current bet. If the dealer holds a natural
- twenty-one, the player wins the insurance bet and is paid 2 minutes for each
- minute wagered. If the dealer does not hold a natural twenty-one, the player
- loses the insurance bet and plays the hand through to conclusion with the
- original amount bet riding on the hand.
-
- When the dealer does not hold a Twenty-One, but the player does, the
- player wins the hand and is payed off at 3 to 1 odds. The dealer does
- not take a turn and the hand is then ended.
-
- If neither the dealer nor player have Twenty-One and the player's two
- cards total less than 21 the player may chose to Double Down. If the player
- choses to Double Down, the amount bet is doubled and the dealer deals ONE
- FINAL card to the player's hand. The dealer then takes his turn in sequence.
- If the player wins the hand, the Double Down is paid off at 2 to 1 odds.
-
- If the player does not select to Double Down, he may:
-
- <S>tay Either the player is satisfied with his count or he
- suspects that drawing another card may make his count
- go over 21.
-
- <H>it To draw a card or cards. When the player is not
- satisfied with his count, he may draw as many cards as
- he likes. When he believes his count is as good as he
- can do, the player should elect to <S>tay.
-
- If the player goes over a count of 21, the dealer announces a bust. The
- player loses the hand and the hand is then ended.
-
- If the player receives 5 cards and has a count of less than 21, the
- game will declare a "Five-Card Charlie". The dealer then pays off at
- 3 to 1 odds.
-
- If the player holds a count of 21, the dealer pays off at 3 to 1 odds.
-
- The Dealer's Turn at Play:
-
- If the player has busted, the hand is ended and the player is returned
- to the game menu. If the player's hand is still active, the dealer
- plays his hand.
-
- - The dealer turns up his hole card so that all his cards are
- exposed.
-
- - If his count is 17, 18, 19 or 20, the dealer must stay.
-
- - If his count is 16 or less, he must draw a card and
- continue to draw until his count reaches 17 or more--at
- which point he must stay. If the dealer holds a 'soft' 17,
- i.e., a 17 count which includes an ace, he must also stay.
- This also applies to a soft 18, 19 or 20.
-
- It is important to note here that the Black Jack dealer has no choice of
- whether to stay or draw. His decisions are predetermined and known to
- the player. Since all the dealer's cards are exposed at this turn of
- play, he has no opportunity for any departure from these rules.
-
- The rule requiring the dealer to hit on 16 or less and stay on 17, 18,
- 19, 20 and 21 is standard today in all major casinos here and abroad.
-
- If the dealer has played 5 cards and has a count of less than 21, the
- dealer announces a "Five-Card Charlie" and wins the hand. Even if the
- player's count is 21, a "Five-Card Charlie" wins the hand in this BBS-
- Style game of Black Jack.
-
- Final Settlement:
-
- At the end of his play the dealer pays off the player if the player
- has a higher count than his. If the player has a higher count, but does
- not have Twenty-One, the dealer pays off at 2 to 1 odds. In other words,
- the player will get back the amount of coins bet, and the dealer will
- also match this amount. So, if a player has bet 2 coins, the dealer will
- pay 4 coins if the player's count is greater than his.
-
- The Double Down:
-
- The player, after being dealt his first two cards (which may be any two
- cards) may elect to double his bet and draw one additional card only.
- This is known as double down or down for double. Once the first two cards
- are dealt to the player, the player will be prompted whether he would like to
- go double down. The program will not prompt the player if the player does
- not have enough coins remaining to double his bet and still leave one coin
- in his pot.
-
- The player is then dealt a third and final card. The dealer then takes
- his turn at play. Once the dealer's play is ended, the player's hand
- is counted.
-
-
- ╒═════════════════════════════════════════════════════════════════════════════╕
- │░░░░░░ SYSTEM EVENTS AND AUTOMATIC TIME DEPOSITS ░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
- ╘═════════════════════════════════════════════════════════════════════════════╛
-
- When the player either reaches the maximum number of turns allowed per
- day (as defined by the System Operator), or selects to end the game, a
- brief statement is displayed which shows how the player did.
-
- Most Bulletin Board Systems have a System Event schedule. These
- events are run at predetermined times and are used to ensure that tasks
- such as maintenance and mail-hours are executed.
-
- If a player wins an amount of time that would over-run an upcoming system
- event, Black Jack For Time will adjust the player's time remaining to avoid
- over-running the event and will deposit time that would otherwise be lost
- (taken back by the system), into the player's online time bank account.
-
- If the System Operator is not running a time bank program such as RATS
- (RemoteAccess TimeBank System) the system will then trim the player's
- winnings down to avoid allowing the player to over-run a system event.
-
-
-
- ╒═════════════════════════════════════════════════════════════════════════════╕
- │░░░░░░ NOTES FROM THE AUTHOR ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
- ╘═════════════════════════════════════════════════════════════════════════════╛
-
- Starting with release 2.0, Black Jack For Time provides automatic EXITINFO
- format detection for RemoteAccess 1.01 thru 1.10 and QuickBBS 2.64 thru 2.75
- and ProBoard 1.20. Black Jack For Time uses the communications library
- JPDoor 3.01 SE from Motor City Software.
-
- Starting with release 1.4, Black Jack For Time will automatically detect
- whether it is running under RemoteAccess 0.04, 1.00, 1.10 or QuickBBS 2.75
- Therefore, the conversion program CVT.EXE which was previously required
- for QuickBBS systems is no longer needed.
-
- Also effective with release 1.4, the key structure has been changed. If you
- were previously registered and would like to obtain a new registration key
- number, please contact me through one of the FidoNet bulletin board systems
- listed above in this document. A registration number will be expedited to
- you.
-
-