home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ftp.wwiv.com
/
ftp.wwiv.com.zip
/
ftp.wwiv.com
/
pub
/
DOOR
/
BJ323.ZIP
/
BJ.DOC
< prev
next >
Wrap
Text File
|
1994-07-24
|
28KB
|
683 lines
LOPAKA'S
██████ ██ ███████ ███████ ██ ██ ██ ███████ ██████ ██ ██
██ █ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██
███████ ██ ███████ ██ ████ ██ ███████ ██ ████
██ █ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██
██████ ██████ ██ ██ ███████ ██ ██ ████████ ██ ██ ██████ ██ ██
████████ ██
██ ██
████████ ██
██ ██
████████ ██
BBS Game Software
(C)Copyright 1992-1994 Robert Fortune
All Rights Reserved.
NOTE: Archive filename is BJ323.ZIP
A PCBOARD 14-15.x and DOOR.SYS file, Wildcat 3.90M (using DOOR.SYS)
and DORINFO#.DEF compatible BBS Game Door.
=================================================================
NOTE: If you are unsure whether you have the latest version of
this BlackJack BBS game door you can call either of the following
boards and to check and see if you have the latest version:
1) The Greek Isles - Node 1 (718) 699-0056 Genuine Intel 14400
Node 2 (718) 699-0832 USR Dual Standard 16800
24 Hours 7 days
SysOp: Tony Kolokithias
Location: New York City, USA.
2) The SHAMEnville BBS - (405) 390-1123 2400 - 14400
24 Hours 7 Days
SysOp: Lynne Schlumpf
Location: Oklahoma, USA.
The most recent version of this door can be Freqed (FidoNet)
from the #2 BBS (SHAMEnville BBS) at Fidonet 1:147/111 using
a Magic name of BLACK
NOTE: The current version of Lopaka's BlackJack door is available
for downloading on the above boards on your first call.
PAGE 1
=================================================================
When you do a file search use BJ*.ZIP as all future versions will
use BJ as the first 2 characters of the BlackJack archive.
Disclaimer:
Lopaka's / Lopaka's Nuioka Productions, Robert Fortune or anyone
shall NOT be held responsible for any damages, loss of data or any other
loss as a result of using this software. The user by using this
software takes FULL responsibility and liability for use of and any
damages, losses etc... as a result of this software. Every effort
has been made to ensure that this software is free from defects.
and has been thoroughly tested before release to the general
public.
BBS operators (SysOps) may distribute this program provided it is
in its original archive condition and contains all of the files
included in the official release as listed below. For those
distributing software for a service fee, the amount of this fee
may not exceed $6.00 for shipping/handling/packaging charges. This
program may not be distributed as part of another package without
the express written permission of the author. It may not be distributed
in any modified form.
Credits:
Lopaka's BlackJack BBS Door 3.23 Copyright (C) 1992-94 Robert Fortune.
All Rights Reserved.
DoorPro 1.0 Copyright (C) 1994 Robert Fortune. All Rights Reserved.
BASIC Professional Development System 7.1 Copyright (C) Microsoft Corp.
PDQ 3.11 Copyright (C) 1989-1993 Ethan Winer and Crescent Software.
PDQComm 2.62 Copyright (C) 1990-1993 Dave Cleary, Ethan Winer and
Crescent Software.
PCBoard BBS software Copyright (C) Clark Development Company, Inc.
Wildcat BBS software Copyright (C) Mustang Software, Inc.
Assistants:
----------
The Greek Isles BBS: (718) 424-1696 - New York, USA.
SysOp: Tony Kolokithias (718) 639-5703 - New York, USA.
For all that unzipping, installing, beta testing and pointing out
my misspelled words during a serious case of Spell Check Fever!
Without Tony's help this door could never have been done.
PAGE 2
Joe Negron for the good suggestions and technical support.
Aura Almanzar for beta testing and pointing out many of my
typos and grammatical errors.
The SHAMEnville BBS: (405) 390-1123
Fidonet: 1:147/111
SysOp: Lynne Schlumpf
For Distibution assistance and testing the DORINFO#.DEF drop file.
Many thanks to all! Robert Fortune
Registration Information:
------------------------
This software is shareware. What that means is that
you the SysOp can try it out to see if it meets your needs.
After a 30 day evaluation period you are asked to
send the author (that's me!) $10.00. That's right! Only $10.00!
Send your $10.00 (U.S. funds) registration to:
Robert Fortune
48 West 17th Street #B303
New York, N.Y. 10011
U.S.A.
* What's New? Unlike previous versions which used Door Source 4.0B this
version uses Crescent Software's PDQ 3.10 and PDQComm 2.62. Some
of the new features are bps rate support to 115,200 - non-standard
Addrs and IRQs (1-15), built-in fossil support (works with or without a
fossil driver automatically) making the LOCKED parameter in earlier
versions of this door no longer necessary and much more.
Users of previous versions do not have to make any changes to
their .bat files. Just unzip this version over the older version
and let PKUNZIP overwrite all the older files. (Don't just delete your
older files or you'll lose your users' scores!). Just say yes when
PKUNZIP asks if it should overwrite. Be sure you allow PKUNZIP to
overwrite each of the BJ files. There have been changes made to several
of the files and when using this version of the door you must be
using all the files from this version of the door.
* NOTE: If you were using an earlier version of this door and had problems
with the high scores, then delete your BLJACK.DAT file. All players will
start over. The door will re-create a BLJACK.DAT file automatically.
Summary:
-------
PAGE 3
This is a BBS game door of the classic card game, BlackJack. In order to
use it you will need to be running BBS software capable of generating
a PCBOARD.SYS , DOOR.SYS or Bulletin Board System interface file.
Boards supported include PCBoard, DORINFO#.DEF and DOOR.SYS drop files.
This door supports Fossil Drivers with locked com ports up 115,200.
This door monitors the carrier so that if a user hangs up while inside
the door, the door will close all of its files and clean up after
itself and then return control back to the BBS system software.
There is also keyboard timeouts. The timeout will vary depending on
what part of the door is executing. For example, the opening screen
times out after 1 minute of keyboard inactivity while the instructions
screen times out after 2 minutes of keyboard inactivity. Be aware that
if a player allows the keyboard to timeout, he/she loses any money they
may have won during that session. Hopefully this will motivate players
not to allow the keyboard to timeout!
This door is not limited in any way! What you have is the complete
fully functioning door. I do not like programs that are limited
and I'm sure many others feel the same way. But that does not mean
you should not register this door. If you like it and want to continue
using it after the 30 day trial period you are asked to send in your
$10.00 registration fee. This will help to ensure that future quality
door(s) are developed.
Payoffs are 1 for 1. That is, if you bet 100 dollars and you win,
then you win 100. "Natural" blackjacks are paid off at 3:2. That
is if you bet $100 and get a "Natural" blackjack on your first 2 cards
you win $150 and of course you get back your $100 bet.
Double down doubles your bet and thus if you win, you win the
amount of your doubled down bet. That is if you bet 100 dollars
and double down and then win, you win 200. If you lose the doubled
down bet you lose 200. You cannot double down if you've been dealt
more than 2 cards or if you do not have the funds in your bank to
double your current bet. Double down is only permitted if you have
been dealt only 2 cards. Your bet is doubled and you are dealt a 3rd
and final card.
Splitting your hand is permitted when your first 2 cards are
identical in value. That is 2 seven's or 2 queens etc... or even
a ten and a King or a Jack and a 10 or a Queen and a Jack. As long
as the cards are equal in value they may be split. You cannot
split your hand if you do not have the funds to put your initial
bet onto both split hands. Due to screen space limits you can only
split your initial 2 cards. That is you cannot split your hand and
then get 2 cards of equal value in one of your split hands and split
once again. Only a single level of split hands is available due to
screen space limitations. You cannot get a "Natural" in a hand that -
is part of a split hand as per the official rules of the game. Also
you cannot get a Five card Charlie in a hand that is a result of
you splitting your initial 2 cards dealt you. This is my own
decision and may change in a future version. When you split a pair
of aces you are only dealt a single 2nd card on each ace as per the
rules of the game. That is when you split a pair of aces, you can only
PAGE 4
get 1 hit on each of the 2 split aces. Them's the rules.
The Five card Charlie rule is reportedly most popular in the
Northeastern United States. Basically it stipulates that if the
player draws 5 cards and his hand is 21 or under 21, he automatically
wins the hand. The dealer cannot win via a 5 Card Charlie.
It should also be noted that this game only allows the dealer to
draw 6 cards per hand. This is for technical reasons and may be changed
in a future version of this door.
This blackjack game loosely follows John Scarne's rules for playing
a game of "Casino" Blackjack. This game plays a decent game of blackjack
and I sincerly hope you enjoy it as much as I do. Keep in mind that
registering this game can have an impact on if and how this game door
is updated. All that said, Enjoy!
* Scarne On Cards By John Scarne. ISBN 0-451-16765-1. U.S. $5.99
---------------
All that said let's move along here.
BlackJack Version 3.23 Installation and usage instructions:
----------------------------------------------------------
NOTE: This Door requires user systems to have ANSI capability. If they
do not have ANSI.SYS and try to open the door they will be told
they must have ANSI capability and be returned to the host software.
INSTALLATION INSTRUCTIONS:
-------------------------
You will need to put the files in this package into your BBS doors
file directory. These are the files you should have after unzipping
this Blackjack game door archive.
1) INSTALLB.EXE (Run this program to create the required .CFG file)
2) BJ.DOC (this .DOC file you're reading!)
3) REGISTER.DOC (Registration form)
4) FILE_ID.DIZ (description file for BBS systems)
5) DESC.SDI (description file for BBS systems)
6) BJ.EXE (Main BlackJack game door program)
7) BJACKG (ANSI color opening screen)
8) BJINSTG (ANSI instructions screen)
9) DECKCARD (Deck of ANSI playing cards)
10) BJMAINT.EXE (Reset all player's scores to zero)
After you have sucessfully installed this BlackJack door you
can safely delete the top 5 files (provided you have saved the
BlackJack archive file for backup purposes!). This will return
PAGE 5
some disk space should you need it.
* STEP #1
-------
In addition to the above files you will need to create 2 additional
files. The first is a simple .BAT file that will bring the BlackJack
door up when a user selects it from your door menu. It should look
something like this: (provided this .BAT file is in the same DIR as
the BBS door programs.) Otherwise include the complete path to the
BJ.xxx file(s).
Sample .BAT file(s) (i.e. BJACK.BAT ) to run BlackJack door:
* Example #1- (intended for PCBoard)
ECHO OFF
C:
CD \PCB\DOORS\BJ
BJ BJ.CFG
COPY C:\PCB\DOOR.TXT C:\PCB\PCBSTUFF.KBD
CD \PCB
BOARD
* Example #2- (intended for DORINFO1.DEF BBS dropfile users)
ECHO OFF
BJ BJ.CFG
BOARD
* Example #3-
ECHO OFF
BJ BJ.CFG ADDR&H02E8 IRQ12
BOARD
Example #3 shows how one specifies non-standard com port address and
non-standard IRQ. When ADDR&Hnnnn is used, IRQn must be used and vice
versa. When IRQn is needed IT MUST BE THE LAST THING ON THE COMMAND
LINE!
* Example #3 - (intended for a multinode Wildcat 3.90 BBS)
CD \WC351\DOORS\BJACK
BJ BJ%WCNODEID%.CFG
CD \WC351
PAGE 6
EXIT
In example #3 above the first line changes the directory to the
door(s)-BlackJack door directory. The second line runs the door.
The third line changes back to the main Wildcat directory. Note
the use of the WildCat environment variable %WCNODEID% which you
should use if you are running a multinode WC board.
(The BBS software that this door supports is PCBOARD, DOOR.SYS,
and Wildcat 3.xx (using DOOR.SYS) and DORINFO#.DEF drop file(s).
DORINFO#.DEF SysOps should not be alarmed when the status line
shows the the Baud and Locked rates to be the same. The DORINFO#.DEF
file does not provide the baud rate, only the BPS rate. I will look
into this situation.
The fourth line will bring the BBS software back up after a user exits
the BlackJack door. See your BBS software manuals for specific info on
how to bring up your particular BBS software after a door is exited.
MULTINODE SUPPORT: You may need to create a BJACK.BAT and a BJ.CFG
for each node you have this door installed on. File-locking is auto-
detected by detecting the presence of DOS's SHARE.EXE program which
allows sharing of files by different nodes. If SHARE is detected the
door assumes you are running a multinode BBS and locks/unlocks its
files as needed. There may be a brief delay if 2 or more nodes are
running the door.
This program depends on SHARE.EXE being loaded and active on your
system. If for some reason you have SHARE.EXE loaded and are not running
a multinode BBS this door may give you problems. Is this should happen
contact me via the BBS number at the end of this file.
COMMAND LINE OPTIONS:
--------------------
BJ BJ.CFG standard command line
LOCAL Runs the door locally. Good for trying out
before installing the door on your board to
see if the door meets your specs.
EXAMPLE: BJ BJ.CFG LOCAL
NON-STANDARD ADDRESSES AND IRQs:
-------------------------------
ADDR&Hnnnn Lets you specify the address used for the
COM port. If you use ADDR&Hnnnn you must
also use IRQn and IRQn MUST be the last
thing on the command line.
Example: BJ BJ.CFG ADDR&H03E8 IRQ10
IRQn Lets you specify the IRQ used for the COM
port where n is the irq number to use.
ADDR&Hnnnn and IRQn must be used togther.
If you use one, you must use the other!
PAGE 7
And IRQn MUST BE THE LAST THING ON THE
COMMAND LINE!
EXAMPLE Command Line: BJ BJ.CFG ADDR&H02F8 IRQ3
This door WILL NOT allow you to open two ports on the same IRQ. Some
buses allow different boards to share the same IRQ as do some special
boards. This door does not allow the same IRQ to be shared.
Helpful Com port addresses and standard IRQs:
COM PORT ADDRESS IRQ
-------- ------- ---
COM 1 &H03F8 4
COM 2 &H02F8 3
------------------------------------------------------
IBM PS/2 Com 3 and Com 4:
COM PORT ADDRESS IRQ
-------- ------- ---
COM 3 &H0C94 3
COM 4 &H0C9C 3
------------------------------------------------------
Non-PS/2 systems's Com 3 and Com 4:
COM PORT ADDRESS IRQ
-------- ------- ---
COM 3 &H03E8 4
COM 4 &H02E8 3
-------------------------------------------------------
-------------------------------------------------------
Standard "AT Class and above" IRQs:
IRQ Device
--- ------
8 Realtime clock
9 software redirect to 2
10 open
11 open
12 open
13 math co-processor
14 fixed disk controller
15 open
-------------------------------------------------------
-------------------------------------------------------
If you are using COM 1-4 with the default IRQ you should not need to put
the ADDR&Hnnnn and IRQn on the command line. The door will default to
PAGE 8
the standard Addr and IRQ. If you are using a non-standard port
Address and/or IRQ you must use the Addr and IRQ. If you are having
problems installing this door, try using the command line ADDR&Hnnnn
and IRQn parameters and see if that helps. When using ADDR&Hnnnn IRQn
IRQn MUST be the last thing on the command line.
If by chance you are using a multiport card and the door doesn't
seem to work try using the ADDR&Hnnnn and IRQ parameters and see if
that helps.
If you find you must use the Addr and IRQ be sure you know what you
are doing. Using an IRQ used by another device can cause both this
program and the other device to NOT work properly if at all!
* STEP #2:
-------
The second file is also very easy to create. This file should be
called BJ.CFG Here are sample(s) of what it might look like:
Example #1 BJ.CFG file for a multinode Wildcat 3.90m BBS
----------------------------------------
C:\WC351\WCWORK\NODE1\DOOR.SYS
Hawkeye's BBS
JOHN
SMITH
20
YES
Example #2 BJ.CFG file for PCBOARD.SYS
--------------------------------------
C:\PCB\PCBOARD.SYS
The Best BBS
Joe
Jones
25
YES
Example #3 BJ.CFG for DORINFO#.DEF (note: # MUST BE 1 or 2 or 3 etc..)
----------------------------------
C:\TRIBBS\DORINFO1.DEF
The Lion's Den
Jack
Zimmerman
59
YES
To create this file run the INSTALLB.EXE program by typing
INSTALLB [Press ENTER key]
1) Enter in your BBS interface/drop file name (PCBOARD.SYS, DOOR.SYS or
DORINFO1.DEF). Include the full drive:\path\Dropfile.Ext if the drop
file is not in the current file directory.
2) Then the name of your BBS.
PAGE 9
3) Then your first name.
4) Then your last name.
5) Then the amount of time you want to allow users to be able to play
the game per day (a time of 15 minutes is suggested). The maximum time
you may use is 59 minutes playing time per day.
6) Then whether you want the 5 Card Charlie Rule to be in effect.
A simple YES or NO to this question is required.
That's it! The resulting file should have PCBOARD.SYS , DOOR.SYS
as the first line of the BJ.CFG file. Include the full path to the
BBS interface file (i.e. PCBOARD.SYS, DOOR.SYS or DORINFO1.DEF) if the
BBS interface file is not in the same directory as the BlackJack files.
Next the name of your BBS. Then your first name. Then your last name.
Then the time limit that will control how long each day a user can play
the game. Again, 15 minutes is suggested. Then whether the 5 card
Charlie rule should be in effect.
Keep in mind that any user may open the door as many times a day as
they like. The door will give users time to play based on the amount
of time you specified in the BJ.CFG file or the amount of time they
have left for the day. If you specified say 15 mins playing time per
day and say they only have 10 mins left for the day according to your
BBS setup, the player will only get the amount of time the BBS reports
them having left for that day.
The first time you run this door it will create 2 additional files.
The first is called BLJACK.DAT This file keeps track of the
players, their current score and when they last played the game.
The second is called TOPDOG.DAT and holds the all-time winner info.
All this info is displayed on the high scores screen. That's it.
PAGE 10
To test this door or to run it locally just use this command line
BJ BJ.CFG LOCAL
This will run the door locally so you can try it out before installing
it. Be sure all the files in this archive are in the current directory
when you invoke this command and that you have created the .CFG file.
Periodically you may wish to zero out the Player's High Score file.
To do this simply run the BJMAINT.EXE file. All players who open
the door from that point on will begin anew with a stake of $1500.00.
It is unknown at this time whether any player can win more than
2.15 billion dollars playing this game. Should a player's winnings
exceed approx. 2.15 billion, it would cause the door to close
prematurely. If this should happen simply run the BJMAINT.EXE file
and all players will begin anew with a 1500 dollar stake. In any
case you should periodically run the BJMAINT.EXE file to give latecomers
to the game a fair chance of competing with players who have been
playing for a much longer time. One more small file is created. It
is called TOPDOG.DAT and holds the ALL-TIME WINNER'S name and high
score. It's up to you whether you want to delete this file periodically
when you run the BJMAINT.EXE program. If you do the all-time winner
and his score is lost and a new all-time winner file will be created
when the door is next played. It is important to note that a player's
high score is recorded when they exit the game. So a player could
have winnings of say 1,000,000.00 during play but he may only have
10.00 when he exits the door. The score he has when he exits the door
is the one that counts, NOT his highest score during play.
PAGE 11
You will also find BJMAINT.EXE which can be used to reset all the
Blackjack player's scores to zero.
NOTE: All of the host's game keys will work when a user/caller is playing
so if for some reason you need to assist a caller on how to
play the game you can play until they understand how to play.
Course your ESC key also will work while a player is online
and should the need arise you can press ESC at the bet screen
taking the caller out of the door. Not a nice thing to do,
but it may prove useful in some situations.
All that said, I hope you enjoy this door and support future developments
by registering your copy. Remember registration is only $10.00! Yes
I know it's expensive to run a BBS which is one of the main reasons the
registration is so reasonably priced.
Please send your $10.00 registration fee ( U.S. Funds) to:
Robert Fortune
48 West 17th Street #B303
New York, N.Y. 10011
U.S.A.
Should there be any updates to this door you qualify for free updates
for your $10.00 registration fee. All you will have to do is download
the updated file and install it. I hope to add support for other
BBS interface file formats soon as well as more features. Later...
- Robert Fortune September 1992 - June 1994
* 12/15/93 (BJ321.ZIP)
Bugfix: Corrected SHARE file access error(s) when run on a multinode BBS.
* 02/19/94 (BJ321C.ZIP)
Bugfix: Corrected false EOF markers that were corrupting BLJACK.DAT file.
If you were using a version of Lopaka's BBS Blackjack door prior
to this version (BJ321C) and had problems with the high scores,
then delete the BLJACK.DAT file and unzip this version 3.21C
over the older version you had been running.
* 03/03/94 (BJ322.ZIP)
Bugfix: Corrected problem with non-standard IRQs greater than 9.
PAGE 12
* 06/25/94 (BJ323.ZIP)
Added support for the DORINFO#.DEF drop file(s).
Note: Should you encounter any problems or have a question or
suggestion regarding this program you may leave mail for
ROBERT FORTUNE on The Greek Isles BBS here in New York City
at (718) 424-1696 or (718) 639-5703. BE SURE TO ADDRESS YOUR
MESSAGE TO ROBERT FORTUNE.
-----------------------------------------------------------------------
* * * END OF BLACKJACK Version 3.23 Documentation * * *