home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
The World of Computer Software
/
World_Of_Computer_Software-02-385-Vol-1of3.iso
/
c
/
cas-301.zip
/
CAS-DOC.ZIP
/
CASSYSOP.DOC
< prev
next >
Wrap
Text File
|
1992-08-28
|
107KB
|
2,472 lines
T H E M Y C R O F T C A S I N O
Version 3.01 - Aug. 28, 1992
SysOp Documentation
Mycroft Systems, P.O. Box 7672, San Jose, CA. 95150 BBS: (408)927-0105
Casino SysOps Documentation - Version 3.01 Page i
----------------------------------------------------------------------------
TABLE OF CONTENTS
1.0 Introduction. . . . . . . . . . . . . . . . . . . . . . . . . 1
2.0 System Requirements . . . . . . . . . . . . . . . . . . . . . 2
3.0 Version History . . . . . . . . . . . . . . . . . . . . . . . 3
4.0 Installation & Setup. . . . . . . . . . . . . . . . . . . . . 4
4.1 The Configurations File . . . . . . . . . . . . . . . . . 4
LANG: Default Language. . . . . . . . . . . . . . . . . 4
DOCS: Documentation File. . . . . . . . . . . . . . . . 5
BULL1B: Top 10 Gamblers Bulletin (B/W). . . . . . . . . . 5
BULL1C: Top 10 Gamblers Bulletin (Color). . . . . . . . . 5
BULL2B: High Game Scores Bulletin (B/W) . . . . . . . . . 6
BULL2C: High Game Scores Bulletin (Color) . . . . . . . . 6
EDIT1: Editor User 1 . . . . . . . . . . . . . . . . . . 6
EDIT2: Editor User 2 . . . . . . . . . . . . . . . . . . 6
EDIT3: Editor User 3 . . . . . . . . . . . . . . . . . . 7
PASWD: Editor Password . . . . . . . . . . . . . . . . . 7
SNOOP: Snoop Toggle. . . . . . . . . . . . . . . . . . . 7
PROTO: External Protocol Name. . . . . . . . . . . . . . 8
BATCH: External Transfer Batch Filename . . . . . . . . 8
PURGE: Old Player Purge. . . . . . . . . . . . . . . . . 8
4.2 The Batch File. . . . . . . . . . . . . . . . . . . . . . 9
4.3 Node & Port Files . . . . . . . . . . . . . . . . . . . . 10
NODES.BBS - The Node ID File. . . . . . . . . . . . . . . 10
PORTS.BBS - The Port ID File. . . . . . . . . . . . . . . 10
4.4 BBS Support Files . . . . . . . . . . . . . . . . . . . . 11
RBBS Support Files. . . . . . . . . . . . . . . . . . . . 11
Quick BBS Support Files . . . . . . . . . . . . . . . . . 12
Wildcat Support Files . . . . . . . . . . . . . . . . . . 12
PC-Board Support Files. . . . . . . . . . . . . . . . . . 12
GAP Support Files . . . . . . . . . . . . . . . . . . . . 13
WWIV Support Files. . . . . . . . . . . . . . . . . . . . 13
Spitfire Support Files. . . . . . . . . . . . . . . . . . 14
G-Mon Support Files . . . . . . . . . . . . . . . . . . . 14
4.5 Timegen Utility . . . . . . . . . . . . . . . . . . . . . 15
SYSOP - SysOp Paging Hours. . . . . . . . . . . . . . . . 15
LEVEL - Security Level Definitions. . . . . . . . . . . . 15
DAYT - Daily Time Limits. . . . . . . . . . . . . . . . . 16
DAYG - Daily Game Entry Limits. . . . . . . . . . . . . . 16
WAIT - Wait Times Between Game Entries. . . . . . . . . . 16
TIME - Max Entry Time Definitions . . . . . . . . . . . . 16
5.0 Maintenance Options . . . . . . . . . . . . . . . . . . . . . 18
5.1 Automatic Maintenance . . . . . . . . . . . . . . . . . . 18
5.2 Manual Maintenance. . . . . . . . . . . . . . . . . . . . 18
5.3 Restarting the Game . . . . . . . . . . . . . . . . . . . 18
----------------------------------------------------------------------------
Mycroft Systems, P.O. Box 7672, San Jose, CA. 95150 BBS: (408)927-0105
Casino SysOps Documentation - Version 3.01 Page ii
----------------------------------------------------------------------------
TABLE OF CONTENTS (cont)
6.0 Editors . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
6.1 Player Editor. . . . . . . . . . . . . . . . . . . . . . 19
6.2 Top 10 Editor. . . . . . . . . . . . . . . . . . . . . . 19
6.3 High Scores Editor . . . . . . . . . . . . . . . . . . . 19
6.4 Reviewing the Error Log. . . . . . . . . . . . . . . . . 19
6.5 Exiting the Editors. . . . . . . . . . . . . . . . . . . 20
7.0 Player Editor . . . . . . . . . . . . . . . . . . . . . . . . 21
7.1 Selecting Players. . . . . . . . . . . . . . . . . . . . 21
7.2 Player Status. . . . . . . . . . . . . . . . . . . . . . 21
7.3 Player Name. . . . . . . . . . . . . . . . . . . . . . . 21
7.4 Player Alias . . . . . . . . . . . . . . . . . . . . . . 21
7.5 Player Password. . . . . . . . . . . . . . . . . . . . . 22
7.6 Last Date Played . . . . . . . . . . . . . . . . . . . . 22
7.7 Current Cash . . . . . . . . . . . . . . . . . . . . . . 22
7.8 Language Setting . . . . . . . . . . . . . . . . . . . . 22
7.9 Graphics Setting . . . . . . . . . . . . . . . . . . . . 23
7.10 Message Delay Setting. . . . . . . . . . . . . . . . . . 23
7.11 Edit High Scores . . . . . . . . . . . . . . . . . . . . 23
7.12 Save Player. . . . . . . . . . . . . . . . . . . . . . . 23
7.13 Exit Player Editor . . . . . . . . . . . . . . . . . . . 23
8.0 Top 10 Editor . . . . . . . . . . . . . . . . . . . . . . . . 24
8.1 Editing Top Players. . . . . . . . . . . . . . . . . . . 24
8.2 Saving Top Players . . . . . . . . . . . . . . . . . . . 24
8.3 Exiting Top 10 editor. . . . . . . . . . . . . . . . . . 24
9.0 High Scores Editor. . . . . . . . . . . . . . . . . . . . . . 25
9.1 Editing High Score Records . . . . . . . . . . . . . . . 25
9.2 Saving High Scores . . . . . . . . . . . . . . . . . . . 25
9.3 Exiting High Scores Editor . . . . . . . . . . . . . . . 26
10.0 Notes from the Author . . . . . . . . . . . . . . . . . . . . 27
----------------------------------------------------------------------------
Mycroft Systems, P.O. Box 7672, San Jose, CA. 95150 BBS: (408)927-0105
Casino SysOps Documentation - Version 3.01 Page iii
----------------------------------------------------------------------------
TABLE OF CONTENTS (cont)
APPENDICES
A.0 Registration Information. . . . . . . . . . . . . . . . . . . A1
B.0 List of Files . . . . . . . . . . . . . . . . . . . . . . . . B1
B.1 Documentation Files . . . . . . . . . . . . . . . . . . . B1
B.2 Message Files . . . . . . . . . . . . . . . . . . . . . . B2
B.3 Program Files . . . . . . . . . . . . . . . . . . . . . . B3
B.4 Data Files. . . . . . . . . . . . . . . . . . . . . . . . B5
C.0 SysOp Function Keys . . . . . . . . . . . . . . . . . . . . . C1
D.0 Command Line Parameters . . . . . . . . . . . . . . . . . . . D1
E.0 Multi-Lingual Support . . . . . . . . . . . . . . . . . . . . E1
----------------------------------------------------------------------------
Mycroft Systems, P.O. Box 7672, San Jose, CA. 95150 BBS: (408)927-0105
Casino SysOps Documentation - Version 3.01 Page 1
----------------------------------------------------------------------------
1.0 Introduction
================
Welcome SysOp to Casino. Casino is a series of games of skill, stra-
tegy, and yes, a ton of luck. It is designed to run as a "door" under
most popular BBS packages, but can just as easily be run stand-alone or
in a multi-user network environment.
If you are using the shareware/unregistered release, you, and your
users, will find several features disabled. This is done, of course,
as an incentive for you to register the software. We feel that enough
of the game is operational for you and your users to evaluate it. The
following is a list of differences between the shareware and registered
versions:
* No access to editors by the SysOp
* No access to Craps or Roulettes games
* Unregistered version banner at login and
in bulletins.
* Occasional unregistered version messages
We feel that once you and your users have had time to "play around"
with the shareware version, you will want to register the software.
The registered version offers two major advantages. The first is the
the addition of the Craps and Roulette games. These games are quite
complex and will add to your users enjoyment. The second is the SysOp
access to the game editors. This is handy in being able to delete
players or visiting sysops who just wondered in once for a look around.
It may also allow you to help some players out of a 'jam', or (God
forbid) get a player out of a position he is stuck in due to a bug in
the software.
For more information on registration please refer to appendix A and the
files REGISTER.TXT, DOORS.TXT, ORDER.TXT, UPDATE.TXT, and DISTRIB.TXT.
NOTICE: CASINO IS THE PROPERTY OF MYCROFT SYSTEMS, SAN JOSE, CA. YOU
MAY USE THE SHAREWARE VERSION OF THE GAME FOR A PERIOD OF NO MORE
THAN 45 DAYS. AFTER THAT EVALUATION PERIOD YOU MUST EITHER REGISTER
THE SOFTWARE OR REMOVE IT FROM YOUR SYSTEM. FAILURE TO DO SO IS A
VIOLATION OF THE SHAREWARE LICENSE AND IS IN EFFECT THEFT FROM THE
AUTHOR.
FOR THOSE SYSTEMS WHICH REGISTER THE PROGRAM, IT IS AGAINST YOUR
LICENSE AGREEMENT TO DISTRIBUTE THE REGISTRATION FILES IN ANY FORMAT
TO ANY OTHER PARTY WITHOUT THE EXPRESSED WRITTEN PERMISSION OF MYCROFT
SYSTEMS OR THE AUTHOR.
MYCROFT SYSTEMS ASSUMES NO LIABILITY FOR ANY DAMAGE TO YOUR EQUIPMENT
OR YOUR DATA IN ANY FORM DUE TO YOUR USE OF THIS PROGRAM. NO WARRANTY
EXPRESSED OR IMPLIED IS PROVIDED WITH THIS SOFTWARE PACKAGE AND YOUR
USE OF THIS SOFTWARE IS ENTIRELY AT YOUR OWN RISK.
----------------------------------------------------------------------------
Mycroft Systems, P.O. Box 7672, San Jose, CA. 95150 BBS: (408)927-0105
Casino SysOps Documentation - Version 3.01 Page 2
----------------------------------------------------------------------------
2.0 System Requirements
=======================
To run Casino, you will need an IBM or compatible PC computer, at
least 512K of RAM (game will run in much less), a BBS software package
compatible with the packages supported by Casino (or any other BBS
package combined with the use of a door conversion program), a modem,
and of course a phone line.
The following BBS packages are directly supported by Casino:
* Auntie
* GAP
* PC-Board
* Quick BBS
* RBBS 16.x and RBBS 17.x
* RBBS and G-Mon
* Remote Access
* Spitfire
* Tag
* Wildcat
* WWIV
As stated above, other software packages are either indirectly
supported, since they produce a door file compatible with one of the
above, or can be indirectly supported by using an external door
conversion program.
Support for the game and installation is available by calling or
writting to:
Mycroft Systems BBS
P.O. Box 7672
San Jose, CA. 95150
BBS: (408)927-0105
----------------------------------------------------------------------------
Mycroft Systems, P.O. Box 7672, San Jose, CA. 95150 BBS: (408)927-0105
Casino SysOps Documentation - Version 3.01 Page 3
----------------------------------------------------------------------------
3.0 Program History
===================
The following is a brief history of Casino along with version dates,
and software changes:
VERSION DATE DESCRIPTION
------- -------- -------------------------------------------------
1.00 01/01/89 Original version. Included were the games of
High/Low, Baccarat, Draw Poker, Keno, and
Blackjack. Taken from Stellar Quest code.
1.01 02/10/89 This version was a small number of changes. 1st
of all, a bug was fixed in the PC-Board interface.
Also all references to credits were replaced with
'$'.
1.10 03/05/89 This version saw the first cut of the Horse Racing
game. It was also the first version to include a
player editor.
1.30 10/01/89 Support for Spitfire added. Also enhancements to
some of the color screens. Local play under most
BBS directly supported.
2.00A 12/10/89 Experimental release with new interrupt driven
i/o routines.
2.00 01/01/90 Official 2.00 release.
2.10 02/08/90 Bug fixes to interrupt driven i/o. Also many
enhancements to color screens and more player
feedback in play screens.
2.12 09/15/90 Minor bug fixes.
2.13 02/04/91 Bug fixes.
2.14 01/15/92 Enhancement to i/o system to allow the use of
interrupt IRQs 8 through 15.
2.15 02/01/92 Added switch to allow disabling the hook of the
timer interrupt.
3.00 06/15/92 Externalized messages with multi-lingual support.
Documentation downloadable from inside of door.
Addition of new Craps and Roulette games as well as
rewrite of Baccarat to be casino compatible version.
Complete rewrite of documentation with greater
detail about game rules. Full online help system.
Extra bulletin for high sessions of each game.
3.01 08/28/92 Minor bug fixes. Also fixed mixed up results in
poker.
----------------------------------------------------------------------------
Mycroft Systems, P.O. Box 7672, San Jose, CA. 95150 BBS: (408)927-0105
Casino SysOps Documentation - Version 3.01 Page 4
----------------------------------------------------------------------------
4.0 Installation & Setup
========================
Casino is supplied with it's own custom INSTALL.EXE program. It is
also fully compatible with the Standard Mycroft Command line. It is
recommended that you install the program using the install utility, but
in the event that you cannot locate a copy, or would prefer to install
it manually, the following section will explain in detail all the in-
formation required to setup and install the door.
The first thing to do is to create a directory that Casino will be
run out of. This could be something like CASINO, GAMBLE, or anything
else you desire. Next create a subdirectory off of the Casino direc-
tory named DOCS. Copy or unzip all of the files in the ZIP file
CAS-DOC.ZIP into the DOCS subdirectory. Next, create a subdirectory
named MSGS and unzip all of the files in CAS-MSG.ZIP into the MSGS
directory. Then unzip all of the files in the ZIP file CAS-BIN.ZIP
into the main Casino directory. You will then need to edit/create
the files described below.
4.1 The Configurations File
---------------------------
The file CASINO.CFG is the configuration file needed to control
the program. The file is a standard ASCII text file that may be
created or edited using any standard text editor. Do not use a
word processor to edit the program unless the word processor has
a non-document mode. The configuartion file is made up of con-
figuration commands. Each configuration command occupies a sin-
gle line and has a fixed format. Blank lines in the configura-
tion file are ignored. Comments may be imbedded in the configu-
ration file by starting the comment line with the ';' character
or by using the ';' to start a comment on a configuration line.
Configuration commands are optional and all of the values have a
default value. Configuration commands may be in any order within
the file. The configuration commands are described below:
LANG: Default Language
----------------------
The LANG command is used to specify the games default language.
The default language is used for all bulletin support, all
shared text, and at all points where the players selected
language is not yet known. The default language will also be
used for all errors written to the CASINO.ERR file.
The LANG command has a single parameter. This parameter is the
language tag and corresponds to the language based files file
extention. The following language tags are defined, however
not all of the languages are yet "coded".
ENG - English code page 437 UKG - English code page 850
FRN - French code page 437 FRC - French code page 863
SPN - Spanish code page 437 SPS - Spanish code page 850
GRM - German code page 437 GMN - German code page 850
----------------------------------------------------------------------------
Mycroft Systems, P.O. Box 7672, San Jose, CA. 95150 BBS: (408)927-0105
Casino SysOps Documentation - Version 3.01 Page 5
----------------------------------------------------------------------------
ITL - Italian code page 437 ITN - Italian code page 850
PTG - Portugese code page 437 PTU - Portugese code page 860
Note that at this writting, only code page 437 (United States)
is supported. Others may be added in the future.
Example: LANG: SPN
Default: LANG: ENG
DOCS: Documentation Dir
-----------------------
The DOCS command is used to specify where the documentation
files exist. This should be the full drive and pathname, but
relative paths are allowed. Please be careful when using
relative paths.
This command takes a single parameter. The parameter is the
complete drive and pathname to the documentation files
location. If you are using 2 or more of the documentation
extentions (see below), then make sure that all required files
are in the correct directory.
Example: DOCS: C:\CASINO\DOCS
Default: DOCS: DOCS
BULL1B: Top 10 Gamblers Bulletin (B/W)
--------------------------------------
The BULL1B command is used to control where the Top 10 Rated
Players Bulletin (ASCII) will be created. This bulletin will
shows the users, the top ten rated players. The players rating
is the amount of cash he currently has.
The BULL1B command has a single parameter which is the complete
drive, path, and filename of the bulletin to be created. Note
that relative pathnames are allowed are are relative to the
main Casino directory.
Example: BULL1B: C:\BBS\BULLETIN\BULLET10.TXT
Default: BULL1B: CASBUL.BBS
BULL1C: Top 10 Gamblers Bulletin (Color)
----------------------------------------
The BULL1C command is used to control where the Top 10 Rated
Players Bulletin (ANSI) will be created. This bulletin is the
same as the one described in the BULL1B command except that
ANSI color sequences & IBM extended graphics characters are
used.
Example: BULL1C: C:\BBS\BULLETIN\BULLET11.TXT
Default: BULL1C: CASBUL.CLR
----------------------------------------------------------------------------
Mycroft Systems, P.O. Box 7672, San Jose, CA. 95150 BBS: (408)927-0105
Casino SysOps Documentation - Version 3.01 Page 6
----------------------------------------------------------------------------
BULL2B: Game High Scores Bulletin (B/W)
---------------------------------------
The BULL2B command is used to control where the Game High
Scores Bulletin (ASCII) will be created. This bulletin will
show users, the top scores acheived for each individual
gambling game as well as a top overall score.
The BULL2B command has a single parameter which is the com-
plete drive, path, and filename of the bulletin to be created.
Relative paths are permitted, and will be relative to the
main Casino directory.
Example: BULL2B: C:\BBS\BULLETIN\BULLET12.TXT
Default: BULL2B: CASBUL2.BBS
BULL2C: Game High Scores Bulletin (Color)
-----------------------------------------
The BULL2C command is used to control where the Game High
Scores Bulletin (ANSI) will be created. This bulletin is the
same bulletin as the BULL2B defined above, but ANSI color
sequences and IBM extended graphics characters are used.
Example: BULL2C: C:\BBS\BULLETIN\BULLET12.TXT
Default: BULL2C: CASBUL2.CLR
EDIT1: Editor User 1
--------------------
The EDIT1 command is used to specify a users login name who has
access to the game editors when running remotely. When the
door is run locally then whoever runs the program will have
automatic access to the editors (provided they know the editor
access password).
Please note that the editors may also be entered by using a
specific command line.
The EDIT1 command has a single parameter. This parameter is
the user login name of the user who is being granted access to
the program editors. This parameter is NOT case sensative.
Example: EDIT1: MIKE BAYLEY
Default: EDIT1: SYSOP
EDIT2: Editor User 2
--------------------
The EDIT2 command is also used to specify a users login name
who has access to the game editors when running remotely. When
the door is run locally then whoever runs the program will have
automatic access to the editors.
The EDIT2 command has a single parameter. This parameter is
the user login name of the user who is being granted access to
the program editors.
----------------------------------------------------------------------------
Mycroft Systems, P.O. Box 7672, San Jose, CA. 95150 BBS: (408)927-0105
Casino SysOps Documentation - Version 3.01 Page 7
----------------------------------------------------------------------------
Example: EDIT2: MIKE BAYLEY
Default: EDIT2:
EDIT3: Editor User 3
--------------------
The EDIT3 command is also used to specify a users login name
who has access to the game editors when running remotely. When
the door is run locally then whoever runs the program will have
automatic access to the editors.
The EDIT3 command has a single parameter. This parameter is
the user login name of the user who is being granted access to
the program editors.
Example: EDIT3: MIKE BAYLEY
Default: EDIT3:
PASWD: Editor Password
----------------------
The PASWD command is also used to specify a password that will
be required to gain access to the game editors when running
remotely. When the door is run locally then whoever runs the
program will not be required to enter a password.
Please note that to access the editors, that a seperate command
line format is used. Also note that the editors are not
available in the shareware copy of the program.
The PASWD command has a single parameter. This parameter is
the password required to gain access to the editors. The
password may be 0 or more words up to a total of 40 characters.
The password IS case sensative. If no password is specified,
then no password will be required to enter the editors when
running remotely. It is recommended as a matter of security
that a password be specified.
Example: PASWD: Casino Password
Default: PASWD: CasEdit
SNOOP: Snoop Toggle
-------------------
The SNOOP command is used to set the default setting of the
SysOp Snoop Toggle. If the toggle is set off, then no
information will be sent to the local display. If the toggle
is set to on, then the local display will show the same
information the user sees, plus a banner line at the bottom of
the screen showing the user name and current version number.
The snoop toggle may be changed at any point a user is online
and playing Casino by using the SysOp Keys (see the appendix
on SysOp Keys for more information).
----------------------------------------------------------------------------
Mycroft Systems, P.O. Box 7672, San Jose, CA. 95150 BBS: (408)927-0105
Casino SysOps Documentation - Version 3.01 Page 8
----------------------------------------------------------------------------
It is recommended that the snoop toggle be set to off when
running in a multi-tasking environment such as Windows or
Desqview. By setting it to off, there will be no screen
display and it will then make the program run faster.
The SNOOP command has a single parameter. The parameter must
be set to either ON or OFF.
Example: SNOOP: OFF
Default: SNOOP: ON
PROTO: External Protocol Name
-----------------------------
The PROTO command is used to describe which external file
transfer protocol to use when the user selects the download
documentation feature. The protocol is defined in simple
english and does not necessarily reflect the program name used
to execute transfers. The value of this setting will be
displayed to the user in the download documentation menu.
The PROTO command has a single parameter. The parameter is
a single word used to describe the transfer protocol you
are supplying.
Example: PROTO: XModem
Default: PROTO: (No protocol downloads supported)
BATCH: External Transfer Batch Filename
---------------------------------------
The BATCH command is used to specify the .BAT file to be
executed whenever the user employs the download documentation
feature.
The batch file is passed to the comm port as parameter 1 (%1),
and the filename to transfer as parameter 2 (%2). The batch
file MUST also return to the Casino main directory before
returning back to the program.
The BATCH command takes a single parameter. The parameter
is the complete drive, path, and filename (including the
extention .BAT) of the file to invoke when the players
selects the download documentation option.
Example: BATCH: CASXFER.BAT
Default: BATCH: (No protocol downloads supported)
PURGE: Old User Ratings Purge
-----------------------------
The PURGE command is used to control the deletion of user
records from the game files. The command is provided a
single numeric parameter which is the number of days a user
can be out of the game without having his records deleted.
----------------------------------------------------------------------------
Mycroft Systems, P.O. Box 7672, San Jose, CA. 95150 BBS: (408)927-0105
Casino SysOps Documentation - Version 3.01 Page 9
----------------------------------------------------------------------------
A value of 0 will disable the automatic user purge feature.
The single parameter provided can be any value between 0 and
32000.
Example: PURGE: 120
Default: PURGE: 90
4.2 The Batch File
------------------
The batch file is used to execute the game from your BBS. The
batch file, depending on your BBS software, will either be a stand
alone batch file or simply a set of commands included in your BBS
master batch file. The batch file should change directory to the
Casino main directory, then execute the door using the Standard
Mycroft command line, then change directory back to the BBS, and
finally run the BBS if that is required by your BBS software.
Here is a sample batch file for Spitfire BBS:
ECHO OFF
ECHO ------------
ECHO CASINO
ECHO ------------
CD \DOORS\CASINO
CASINO 1 C:\SF SPITFIRE
CD \SF
The Standard Mycroft Command Line has the following format:
DOORNAME NODE_ID BBS_PATH BBS_TAG
where the DOORNAME is the name of the .EXE file to run the door,
the NODE_ID is the numeric ID number of the BBS node executing the
program (this will always be 1 on single node systems), BBS_PATH is
the full drive and pathname to your BBS directory, and BBS_TAG is
the tag identifying which BBS environment you are operating under.
The following is a list of currently valid BBS tags:
RBBS RBBS 16.x and RBBS 17.x
QBBS Quick BBS or any other BBS generating a
DORINFOx.DEF file.
WILDCAT Wildcat BBS or any other BBS generating a
CALLINFO.BBS file.
PCBOARD PC-Board 12.1 or any BBS generating a
compatible PCBOARD.SYS file
PCBOARD14 PC-Board 14.x or any BBS generating a
compatible PCBOARD.SYS file.
----------------------------------------------------------------------------
Mycroft Systems, P.O. Box 7672, San Jose, CA. 95150 BBS: (408)927-0105
Casino SysOps Documentation - Version 3.01 Page 10
----------------------------------------------------------------------------
GAP GAP BBS or any other BBS generating a
compatible DOOR.SYS file.
WWIV WWIV BBS or any other BBS generating a
compatible CHAIN.TXT file.
SPITFIRE Spitfire BBS or any other BBS generating a
compatible SFDOORS.DAT file.
SPITFIREK Spitfire BBS Main Menu command option.
SPITFIREM Spitfire BBS Message Menu command option.
SPITFIREF Spitfire BBS File Menu command option.
The BBS support file(s), the NODES.BBS file, and optionally the
PORTS.BBS file are expected to be in the directory pointed to by
the BBS_PATH parameter of the command line. See the BBS Support
files below for exact support filenames.
4.3 Node & Port Files
---------------------
The two files NODES.BBS and PORTS.BBS are support files used by all
Mycroft Doorware. Under normal circumstances, these files must be
located in your BBS directory. When running under G-Mon, these
files will need to be located in the same directory as the door
files.
NODES.BBS - Node ID File
------------------------
The NODES.BBS file is used to associate a serial communications
port with each of your BBS nodes. The file may be from 1 to n
lines long. It is a standard ASCII file containing the names
of the comm ports used by each node. Each line represents the
comm port associated with the node associated with that line
in the file (ie. line 1 is for node 1, line 2 is for node 2,
etc.).
The value COM0 is used to identify a local only node.
Otherwize legal values range from COM1 to COM8. If you are
using anything beyond COM4 you will need to describe the
hardware to the program using the facilities in PORTS.BBS. A
sample NODES.BBS file is shown below:
COM2
COM1
COM0
COM0
PORTS.BBS - Port ID File
------------------------
The PORTS.BBS file is used to describe and control the hardware
----------------------------------------------------------------------------
Mycroft Systems, P.O. Box 7672, San Jose, CA. 95150 BBS: (408)927-0105
Casino SysOps Documentation - Version 3.01 Page 11
----------------------------------------------------------------------------
environment that the door program is to run under. This file
is optional and if not present the IBM defined default hardware
settings will be used along with an interrupt driven interface.
The PORTS.BBS file consists of 1 or more non-comment lines used
to define each hardware comm port. The format for each of
these lines is:
PORT ADDR IRQ# INTE HAND PASS
where PORT is the port identifyer and may range from COM1 to
COM8; ADDR is the ports physical base address in hex; IRQ# is
the hardware IRQ number assigned to that port and may range
from IRQ0 to IRQ15; INTE is the interrupt flag and is set to
BIOS for Fossil driver support, PORT for direct access,
and INTR for interrupt driven; HAND is the handshaking flag
which may be set to NONE for no handshaking, SOFT for XON/XOFF
handshaking, and BOTH for both types of handshaking; and
finally PASS is the passthru flag which is set to NO to prevent
IRQ passthru, and YES to allow IRQ passthru.
If not provided, then the following defaults are used:
; PORT ADDR IRQ# INTE HAND PASS
; ---------------------------------------
COM1 03F8 IRQ4 INTR HARD NO
COM2 02F8 IRQ3 INTR HARD NO
COM3 03E8 IRQ4 INTR HARD NO
COM4 02E8 IRQ3 INTR HARD NO
It is recommended that you use the default values unless you
have problems or are using COM5 through COM8. The passthru
should be set to YES if you have more than one device sharing
the IRQ in question.
4.4 BBS Support Files
---------------------
The following section describes the support files required by each
BBS type. The files should be in the BBS directory as pointed to
in the BBS_PATH parameter of the command line.
RBBS Support Files
------------------
The following files are required or expected under the RBBS
environment:
DORINFOx.DEF This file contains all of the users
settings such as graphics, parity, baud
rate, etc.
NODES.BBS This file contains a list of which DOS
device is used for each BBS node.
----------------------------------------------------------------------------
Mycroft Systems, P.O. Box 7672, San Jose, CA. 95150 BBS: (408)927-0105
Casino SysOps Documentation - Version 3.01 Page 12
----------------------------------------------------------------------------
PORTS.BBS This file contains a list of the hardware
environment the program is executed in.
This file is optional and the IBM standard
values will be used if this file is not
found.
Quick BBS Support Files
-----------------------
The following files are required or expected under the Quick
BBS environment:
DORINFOx.DEF This file contains all of the users
settings such as graphics, parity, baud
rate, etc.
NODES.BBS This file contains a list of which DOS
device is used for each BBS node.
PORTS.BBS This file contains a list of the hardware
environment the program is executed in.
This file is optional and the IBM standard
values will be used if this file is not
found.
Wildcat Support Files
---------------------
The following files are required or expected under the Wildcat
BBS environment:
CALLINFO.BBS This file contains all of the users
settings such as graphics, parity, baud
rate, etc.
NODES.BBS This file contains a list of which DOS
device is used for each BBS node.
PORTS.BBS This file contains a list of the hardware
environment the program is executed in.
This file is optional and the IBM standard
values will be used if this file is not
found.
PC-Board Support Files
----------------------
The following files are required or expected under the PC-Board
environment:
----------------------------------------------------------------------------
Mycroft Systems, P.O. Box 7672, San Jose, CA. 95150 BBS: (408)927-0105
Casino SysOps Documentation - Version 3.01 Page 13
----------------------------------------------------------------------------
PCBOARD.SYS This file contains all of the users
settings such as graphics, parity, baud
rate, etc.
NODES.BBS This file contains a list of which DOS
device is used for each BBS node.
PORTS.BBS This file contains a list of the hardware
environment the program is executed in.
This file is optional and the IBM standard
values will be used if this file is not
found.
GAP Support Files
-----------------
The following files are required or expected under the GAP BBS
environment:
DOOR.SYS This file contains all of the users
settings such as graphics, parity, baud
rate, etc.
NODES.BBS This file contains a list of which DOS
device is used for each BBS node.
PORTS.BBS This file contains a list of the hardware
environment the program is executed in.
This file is optional and the IBM standard
values will be used if this file is not
found.
WWIV Support Files
------------------
The following files are required or expected under the WWIV BBS
environment:
CHAIN.TXT This file contains all of the users
settings such as graphics, parity, baud
rate, etc.
NODES.BBS This file contains a list of which DOS
device is used for each BBS node.
PORTS.BBS This file contains a list of the hardware
environment the program is executed in.
This file is optional and the IBM standard
values will be used if this file is not
found.
----------------------------------------------------------------------------
Mycroft Systems, P.O. Box 7672, San Jose, CA. 95150 BBS: (408)927-0105
Casino SysOps Documentation - Version 3.01 Page 14
----------------------------------------------------------------------------
Spitfire Support Files
----------------------
The following files are required or expected under the
Spitfire environment:
SFDOORS.DAT These files contains all of the users
or settings such as graphics, parity, baud
SFMAIN.DAT rate, etc.
or
SFMESS.DAT
or
SFFILE.DAT
NODES.BBS This file contains a list of which DOS
device is used for each BBS node.
PORTS.BBS This file contains a list of the hardware
environment the program is executed in.
This file is optional and the IBM standard
values will be used if this file is not
found.
G-Mon Support Files
-------------------
G-Mon is the exception to the rule. The support files when
running under G-Mon must be in the directory with the door
files. The following files are required under G-Mon:
TIMEOFFx.DOR This file contains all the directory of the
monitor and the time controls for the game
in progress.
NODES.BBS This file contains a list of which DOS
device is used for each BBS node.
The following files are required in the directory specified as
the monitor directory (in TIMEOFFx.DOR):
USERS.DOR This file contains all of the users
settings such as graphics, parity, baud
rate, etc, as well as info pertaining to
the node.
The following files will be created in the directory specified
as the monitor directory (in TIMEOFFx.DOR) at the time the
door exits:
POINTSx.DOR This file contains all of the amount of
time the user spent in Casino. It
also returns the amount of Door Monitor
----------------------------------------------------------------------------
Mycroft Systems, P.O. Box 7672, San Jose, CA. 95150 BBS: (408)927-0105
Casino SysOps Documentation - Version 3.01 Page 15
----------------------------------------------------------------------------
points awarded for running the door (this
is always 0).
4.5 Timegen Utility
-------------------
Timegen is an optional utility to allow you to add additional time
controls to the program. Timegen allows you to restrict use of the
program by security level, time of day, total program entries per
day, total time per day, and will also allow you to impose a
minimum time between program entries.
Timegen will compile a standard ASCII text file into a time control
file for use by the program. The command to execute Timegen is:
TIMEGEN INFILE OUTFILE
where INFILE is the ASCII text source file and OUTFILE is the time
control file for use by the door program.
The source file may not include blank lines nor any comment lines.
Each line may however end in a comment starting with a ';'
character. The source file must contain, in the specified order,
the following lines: SYSOP, LEVEL, DAYT, DAYG, WAIT, and 1 to 8
TIME lines. The format of each line is described below:
SYSOP - SysOp Paging Hours
--------------------------
The SYSOP command is used to specify the paging hours available
to users when in the program. The first parameter is the start
time and the second parameter is the stop time. Each parameter
is in 24 hour HHMM format and may range between 0000 and 2359.
If the start and stop times are identical then paging is
disabled.
Example: SYSOP 1000 2130
LEVEL - Security Level Definitions
----------------------------------
The LEVEL command is used to define security level groups for
use with the other Timegen functions. There must be 8 security
groups defined. Each entry defines the base of the security
group with the cap of the security group being 1 less than the
next entry on the line. Users with a security level less than
the first security group base will be denied access to the
program.
EXAMPLE: LEVEL 010 020 030 050 070 100 200 500
----------------------------------------------------------------------------
Mycroft Systems, P.O. Box 7672, San Jose, CA. 95150 BBS: (408)927-0105
Casino SysOps Documentation - Version 3.01 Page 16
----------------------------------------------------------------------------
DAYT - Daily Time Limits
------------------------
The DAYT command defines the maximum daily time limit for each
of the corresponding security level groups. This command must
have 8 timelimits each associated to the corresponding security
group. A value of 0 indicates no time restrictions and any
other value is the daily limit expressed in minutes.
Example: DAYT 030 045 060 060 060 090 090 000
DAYG - Daily Game Entry Limits
------------------------------
The DAYG command defines the maximum daily entry limit for each
of the corresponding security level groups. This command must
have 8 gamelimits each associated to the corresponding security
group. A value of 0 indicates no maximum game entries and any
other value is the daily limit expressed in number of entries.
Example: DAYG 002 005 005 010 010 010 010 000
WAIT - Wait Times Between Game Entries
--------------------------------------
The WAIT command defines the number of minutes users of each
of the corresponding security level groups must wait between
entries. 8 wait times, each associated to the corresponding
security group, must be specified in the command. A value of
0 indicates no wait, any other value is the daily wait time
expressed in minutes.
Example: WAIT 030 030 015 015 015 000 000 000
TIME - Max Entry Time Definitions
---------------------------------
The TIME command defines the maximum time limit per program
entry for each of the corresponding security level groups.
Each TIME command line (from 1 to 8) represents a period during
the day. The first parameter represents to start of the time
period. The period is expressed in 24 hour HHMM format and
runs from the time specified to 1 minute less than the next
entry. TIME command lines must be listed in time ascending
order. The last TIME command line is assumed to have an ending
time of midnight.
Following the time period base 8 time limits, each associated
to the corresponding security group, must be supplied. A value
of 0 indicates that access is denied during that time period,
and any other value is the entry limit expressed in minutes.
----------------------------------------------------------------------------
Mycroft Systems, P.O. Box 7672, San Jose, CA. 95150 BBS: (408)927-0105
Casino SysOps Documentation - Version 3.01 Page 17
----------------------------------------------------------------------------
Example: TIME 0000 060 060 090 090 090 090 090 999
TIME 0630 030 030 045 045 045 045 045 999
TIME 1000 020 020 030 030 030 030 030 999
TIME 1630 000 000 000 000 030 030 030 999
TIME 2330 060 060 090 090 090 090 090 999
Note that when Timegen is used, the user receives the minimum
amount of time based on: 1) Time remaining on BBS, 2) Time
restrictions set by the program, 3) Time restrictions set by
Timegen.
----------------------------------------------------------------------------
Mycroft Systems, P.O. Box 7672, San Jose, CA. 95150 BBS: (408)927-0105
Casino SysOps Documentation - Version 3.01 Page 18
----------------------------------------------------------------------------
5.0 Maintenance Options
=======================
Maintenance NEED NOT be run everyday. Bulletins are automatically
updated, when needed, as each player exits the door. The maintenance
operations are exclusively for deleteing old players. The configura-
tion option PURGE: controls the number of days of inactivity before
deleting a player.
5.1 Automatic Maintenance
-------------------------
Maintenance will automatically be run the first time a player
enters The Mycroft Casino on any given day. Maintenance is
extremely fast and the player will hardly notice that it even
occured.
5.2 Manual Maintenance
----------------------
For those perfectionists who insist that their maintenance be
run during a BBS scheduled event, maintenance may be executed
using the following command line:
CASINO MAINTENANCE
Note that if maintenance has already run due to a player entering
the door before the scheduled event, then this command will be
ignored and control will return to the event handler.
5.3 Restarting the Game
-----------------------
The Mycroft Casino may be completely restarted at any time by
executing the following command from within the Casino directoty:
CSINIT
This command will overwrite the users and information files and
cause the game to restart from scratch. The bulletins will be
rebuilt the first time a player enters and exits the door.
----------------------------------------------------------------------------
Mycroft Systems, P.O. Box 7672, San Jose, CA. 95150 BBS: (408)927-0105
Casino SysOps Documentation - Version 3.01 Page 19
----------------------------------------------------------------------------
NOTE: THESE CHAPTERS ONLY APPLY TO THE REGISTERED VERSION OF CASINO!
6.0 Game Editors
================
The game editors serve a combination of needs. The major of these is
for ongoing test and debug of the software. Because of this, many of
the editors will allow you to modify almost all of the fields and
controls. Doing this is not recommended as it could change game
balance or even cause the game to crash due to invalid conditions.
Please be careful when using the editors.
The editors are entered by any of up to 3 players who are defined as
having 'editor access'. This is controlled through the 3 configura-
tion file variables 'EDIT1:' through 'EDIT3:'. When a player has
editor access, he is notified at login time. The main menu prompt
display will also display a message indicating that the player may
enter the editor. Lastly, an '*' will show in the door status line
at the bottom of the screen. A SysOp control key is also included
to provide an online user temporary access to the editors. For
more information, see the appendices on SysOp Keys.
Four main editor functions are provided in The Mycroft Casino. These
are:
* Examine and modify player information
* Examine and modify Top 10 Gamblers list.
* Examine and modify game top players list.
* Review and purge the error log.
6.1 Player Editor
-----------------
The player editor allows the user to view and modify almost all
of the players settings, status, high scores, etc. Very little
is not available from this editor.
6.2 Top 10 Editor
-----------------
The Top 10 Editor provides access to the top 10 player scores.
Although these normally need not be changed, it may become
desirable to delet a player from the list who is no longer active
in the door.
6.3 High Scores Editor
----------------------
The High Scores Ediotr provides access to the high session score
as well as the individual high session scores for each game. As
above, there is rarely a reason to modify this information unless,
as above, it is to delete a players score who has been inactive for
a long period of time.
6.4 Reviewing the Error Log
---------------------------
Under normal operations, The Mycroft Casino SHOULD NEVER encoun-
ter errors. The log should normally reflect solely the access to
----------------------------------------------------------------------------
Mycroft Systems, P.O. Box 7672, San Jose, CA. 95150 BBS: (408)927-0105
Casino SysOps Documentation - Version 3.01 Page 20
----------------------------------------------------------------------------
the editors.
If the log has errors, there are three possible causes for this
to happen. The first is that your system is experiencing inter-
mittent disk i/o errors. If this is the case, you will most like-
ly see evidence of this in other programs as well. It will be
reflected here in file seek, read, and write errors.
The second condition would be if the program executable file has
become corrupted. This is normally evident as the program will
fail to run. If these type of errors occur, please contact
Mycroft Systems.
The last type of error, and the normally only likely one, is that
a program bug has been discovered. In the event this happens,
please contact the user that encountered the bug (player login,
time and date stamp are recorded with each error message) and get
details as to what the player was doing when the error occured.
Then please contact Mycroft Systems so that we may cure the pro-
blem as soon as possible..
After you have reviewed the error log, you will be given the
option to delete the log.
6.5 Exiting the Editors
-----------------------
This command will simply return you to The Mycroft Casino main
menu.
----------------------------------------------------------------------------
Mycroft Systems, P.O. Box 7672, San Jose, CA. 95150 BBS: (408)927-0105
Casino SysOps Documentation - Version 3.01 Page 21
----------------------------------------------------------------------------
NOTE: THESE CHAPTERS ONLY APPLY TO THE REGISTERED VERSION OF CASINO!
7.0 Player Editor
=================
The player editor is designed to allow you to examine and modify almost
all of the player's game settings, characteristics, high scores, etc..
Please be careful when and if you modify anything as you may cause a
record to be corrupt.
This editor is primarily used for debug, but you may find it handy to
set a player's last date played field to the previous date if you wish
to give him/her additional time in the Casino.
7.1 Selecting Players
---------------------
When you first enter the player editor, you will automatically
read in player #1's record. You may advance through the players
by pressing the [PgDn] key. When you hit the end of the file
you will be notified by an appropriate message. You may move
backwards through the file by pressing the [PgUp] key. You will
move from each player to the previous player until you reach the
beginning of the file at which point an appropriate error message
will be displayed.
Note that if you attempt to change player records after having
modified one of the fields you will be prompted to see if you real-
ly wish to abandon your changes. To avoid this problem, just re-
member to 'save' the player information before changing records.
7.2 Player Status
-----------------
The Player Status represents the state of the current player re-
cord. It will contain a '0' value if the record has been deleted,
or will contain the record number if the player is still active.
This field may contain an integer value '0' or greater.
7.3 Player Name
---------------
This field contains the players BBS login name. Changing this
field will have the effect of disconnecting him/her from all pre-
vious and any ongoing games and ratings. This is not advisable
with the exception of if you are going to allow a user to change
his BBS login and he still wants to continue playing Casino where
he/she left off.
This field may contain from 1 to 31 characters.
7.4 Player Alias
----------------
This field contains the alias the player has chosen to use in the
game. This field will be used in building bulletins. There is
no danger in changing this field.
----------------------------------------------------------------------------
Mycroft Systems, P.O. Box 7672, San Jose, CA. 95150 BBS: (408)927-0105
Casino SysOps Documentation - Version 3.01 Page 22
----------------------------------------------------------------------------
The field may be 1 to 31 characters in length.
7.5 Player Password
-------------------
The player password field contains the players local game access
password. Changing this field will obviously lock the player out
of the game when the game is played locally. Under normal cir-
cumstances, you will only modify this field at the players re-
quest. For players who initially enter the door via a BBS package,
this field will be set to "Password".
This field is 1 to 31 characters long. It IS case sensative
and may be more than one word. It is only used when the players
enter locally.
7.6 Last Date Played
--------------------
This field shows the last date on which the player in question
entered the game. The field is an 11 character alpha numeric
field and is expressed as MMM DD YYYY. The MMM portion is a 3
character alpha abreviation for the month. The DD portion is the
date of the month with a leading blank or 0 as required. The YYYY
field is the actual Gregorian year. The field may be changed as
desired. Setting it to an old date will cause a player to be de-
leted if that player does not call in before maintenance is run.
This field is updated every time the player enters the game upon
his exit of the program.
7.7 Current Cash
----------------
This field contains a long integer reflecting the current amount
of money the player has in the game. The field may be set to any
value 0 or greater. Modification of this field will have the ob-
vious effects.
7.8 Language Setting
--------------------
This field shows the player in question's language choice. The
field is a 3 character alpha-numeric field which represents the
file extention of the message files used in the game. This field
may be set to any alpha numeric string that matches one of the
language file extentions supported by the program. The language
extentions will depend on which languages are available and which
language extentions you have aquired.
The field is set either automatically or by player choice when
he first enters the game. It may be changed by the player, if the
multi-lingual option is enabled, anytime the player is in the game.
Setting this field to an extention that you don't have will cause
an error when the player enters the game and will thus prevent
him/her from playing.
----------------------------------------------------------------------------
Mycroft Systems, P.O. Box 7672, San Jose, CA. 95150 BBS: (408)927-0105
Casino SysOps Documentation - Version 3.01 Page 23
----------------------------------------------------------------------------
7.9 Graphics Setting
--------------------
This field shows the player in questions graphics setting. The
field is set to either ASCII, IBM, or COLOR to represent the gra-
phics setting the player has selected. This field may be toggled
to any of these three values. This field is originally set by the
player when he first enters the game. It may be changed by the
player anytime the player is in the game and selects the appro-
priate command.
7.10 Message Delay Setting
--------------------------
This field shows the player in question's message delay factor.
The field is set automatically to MODERATE upon a players original
entry into the game. The player may then update the field when-
ever he/she is in the game. The field may be toggled to any of
its settings (VERY FAST, FAST, MODERATE, SLOW, VERY SLOW, WAIT).
7.11 Edit High Scores
---------------------
This command will switch to the player's high score editor. From
this editor you can change all of the player's individual high
session scores for each game as well as the player's overall high
session.
7.12 Save Player
----------------
This menu entry will write the current player record back to the
player file and thus make the changes permanent. As a safety
guard, you will be prompted if you attempt to change player re-
cord or exit the player editor without first writing the record
back to the player file.
7.13 Exit Player Editor
-----------------------
This menu entry will exit the player editor and return back to the
main editor menu. As mentioned above, you will be prompted if you
attempt to exit the editor and have not saved your changes to the
current player record.
----------------------------------------------------------------------------
Mycroft Systems, P.O. Box 7672, San Jose, CA. 95150 BBS: (408)927-0105
Casino SysOps Documentation - Version 3.01 Page 24
----------------------------------------------------------------------------
8.0 Top 10 Editor
=================
The Top 10 Gamblers editor will allow you to examine and modify the
information on the door's top 10 players. The player rating is based
strictly on his/her current amount of cash. This list is updated and
the bulletin is generated from this information, every time a player
exits the door.
8.1 Editing Top Players
-----------------------
The first 10 lines of the display show the information on each of
the top 10 players. When you press the command key to modify a
record, you will be modifying each of the following sub-fields:
Players Name/Alias
------------------
This field will show the player's name or alias (depending
if he/she selected an alias when first entering the door).
Changing this field will not effect the game itself, but
will change the results in the Top 10 Gamblers bulletins.
This field may contain from 0 to 31 characters.
Players Score
-------------
This field shows the player's current amount of cash. This
is the field that the list is sorted on.
This field may contain any long integer 0 or larger.
8.2 Saving Top Players
----------------------
This menu entry will write the top players record back to the
door information file.
8.3 Exit Top Players Editor
---------------------------
This menu entry will exit the Top 10 Players editor and return
control to the main editor menu. If you have modified any of the
top 10 players data, you will be prompted if you have not saved
it and try to exit this editor.
----------------------------------------------------------------------------
Mycroft Systems, P.O. Box 7672, San Jose, CA. 95150 BBS: (408)927-0105
Casino SysOps Documentation - Version 3.01 Page 25
----------------------------------------------------------------------------
9.0 High Scores Editor
======================
The high scores editor will allow you to examine and modify the top
players for each of the gambling games as well as the top overall
session score. This information is updated each time a player exits
the door and the High Session Scores bulletins are generated from it
at that time.
9.1 Editing High Score Records
------------------------------
The first 9 lines of the display show the information on each of
the high scores. When you press the command key to modify a
record, you will be modifying each of the following sub-fields:
Players Name/Alias
------------------
This field will show the player's name or alias (depending
if he/she selected an alias when first entering the door).
Changing this field will not effect the game itself, but
will change the results in the High Scores bulletins.
This field may contain from 0 to 31 characters.
Players Score
-------------
This field shows the player's amount of net winnings during
his high session. This is the field that is compared when
determining if a new leader has taken over.
This field may contain any long integer 0 or larger.
Date Record Set
---------------
The field contains the date when the high score was achieved.
The date is in MMM DD YYYY format where the MMM is the three
character abbreviation for the month, the DD is the date of
the month with a preceeding 0 if required, and the YYYY is
the Gregorian year. Changing this field has no real effect.
This field is in standard MMM DD YYYY format.
9.2 Saving High Scores
----------------------
Selecting this menu item will cause all changes made to the current
high scores record to be written back to the information file. As
a safetyguard, if you attempt to change game score records or exit
the high scores editor, you will be prompted to guarantee that you
don't accidentally lose your updated information.
----------------------------------------------------------------------------
Mycroft Systems, P.O. Box 7672, San Jose, CA. 95150 BBS: (408)927-0105
Casino SysOps Documentation - Version 3.01 Page 26
----------------------------------------------------------------------------
9.3 Exiting High Scores Editor
------------------------------
Selecting this menu item will exit the high scores editor and
return you to the main editor menu. If you have made changes to
the current game high scores and have not saved them, you will be
prompted to make sure you want to exit.
----------------------------------------------------------------------------
Mycroft Systems, P.O. Box 7672, San Jose, CA. 95150 BBS: (408)927-0105
Casino SysOps Documentation - Version 3.01 Page 27
----------------------------------------------------------------------------
10.0 Notes from the Author
=========================
As many of you know, Mycroft Systems has produced quite a string of
door games and utilities. We strive to produce quality programs and
to support them as best we can.
Casino 3.01 is meant to follow in that tradition. Using the new messa-
ge control system, Casino is one of our first upgraded doors to support
this new system which allows switching to a variety of human languages.
This feature will hopefully be reproduced in all future doors and be
slowly retro-fitted into our existing doors.
We have also, as with a few of our previous doors, attempted to make
the documentation available from within the program. With Casino we
are taking the further step of adding a complete online help system.
This we also hope to provide this in our other future offerings.
As with following our policies, Casino is designed to be an enjoya-
ble program with an attractive user interface that is easy to run
and install. If we have failed in any way, we would love to here
from you in the form of either letters or comments.
Michael W. Bayley
Mycroft Systems
P.O Box 7672
San Jose, CA. 95150
BBS: (408)927-0105
----------------------------------------------------------------------------
Mycroft Systems, P.O. Box 7672, San Jose, CA. 95150 BBS: (408)927-0105
Casino SysOps Documentation - Version 3.01 Page A.1
----------------------------------------------------------------------------
A.0 Registration Information
============================
You are encouraged to register your copy of Casino. Upon doing so
you will be mailed the latest version of the program. The version that
you receive will be the commercial version with the editors enabled and
all of the other restrictions removed.
To register, please fill out the order form in the file ORDER.TXT in
the docs subdirectory. You can register this door only or you can
take advantage of one of our package deals which provide substantial
discounts.
The registration fee for Casino is $20 US plus tax in applicable loca-
tions. Also a $2 shipping and handling fee must be included to cover
our costs for diskettes, mailers, and postage. Your order will be
promptly processed.
Those upgrading from a previously registered copy of The Mycroft
Casino can also so do by mail. The upgrade fee is $2 plus the $2 ship-
ping and handling. See the file UPGRADE.TXT in the docs directory for
more information.
----------------------------------------------------------------------------
Mycroft Systems, P.O. Box 7672, San Jose, CA. 95150 BBS: (408)927-0105
Casino SysOps Documentation - Version 3.01 Page B.1
----------------------------------------------------------------------------
B.0 List of Files
=================
Casino files fall into 4 types. These file types are assigned to
various subdirectories. Each type of file is described here in
detail.
B.1 Documentation Files
-----------------------
The documentation files are those files to support the SysOp in
setting up and maintaining the program. Once printed, these may
be copied off to floppy or simply deleted. Please review each of
these files.
CASSYSOP.DOC - SysOp Documentation
----------------------------------
This is the SysOp documentation file you are currently reading.
This file contains all information for the installation, the
initialization, and the maintenance of the game. Detailed
information is provided for all configurations, editor usage,
ect..
CASINO.DOC - User Documentation
-------------------------------
This file is the user documentation file. It is available to
users to download in the documentation menu. Encourage your
users to download and read this file as it will make the game
more enjoyable as opposed to constantly seeking online help.
CASINO.ZIP - User Documentation (Compressed)
--------------------------------------------
This file is the compressed version of the user documentation
file above. It is also availble through the documentation
menu.
CASINO.CFG - Sample Configuration
---------------------------------
This file is a sample CASINO.CFG file. It is setup to con-
tain all of the commands with their default values.
REGISTER.TXT - Registration Information
---------------------------------------
This file contains information on registering your copy of
Casino. We encourage all SysOps who run the game to regis-
ter their copies. It is suggested however that you use
the ORDER.TXT file to order your registered copy.
DOORS.TXT - Mycroft Door Descriptions
-------------------------------------
This file contains information on other door programs available
from Mycroft Systems. Review this document at your leisure
to see if you would be interested in any other of our door
programs.
----------------------------------------------------------------------------
Mycroft Systems, P.O. Box 7672, San Jose, CA. 95150 BBS: (408)927-0105
Casino SysOps Documentation - Version 3.01 Page B.2
----------------------------------------------------------------------------
ORDER.TXT - Mycroft Door Order Form
-----------------------------------
This file is the Mycroft Doors-by-Mail order form. Fill it
and and send it to any Mycroft Dealer to get the most recent
registered version sent to you by mail. Please check the
"date valid through" line to check if pricing information is
still valid. If the pricing information is out of date, you
can get an up-to-date price list by calling any Mycroft
Dealer.
UPDATE.TXT - Mycroft Door Upgrade Form
--------------------------------------
This file is the Mycroft Updates-by-Mail order form. Fill it
and send it to any Mycroft Dealer to get upgraded registered
versions for any door you have already registered.
DISTRIB.TXT - Mycroft Distributors List
---------------------------------------
This file is a current list of Mycroft Distributors. Please
note that Distributors are not Dealers. Don't not send orders
to them. The Distributor List shows a complete list of BBSs
you may call to check on and download recent versions of
Mycroft Doors. We hope there is one in your dialing area. If
not, consider becomming a Mycroft Distributor yourself.
B.2 Message Files
-----------------
The message files are those files containing text information that
a user will see or read within the game. These files are located
in the MSGS subdirectory. This section will describe the standard
files shipped with the program. These are the US (English) message
bases. Other languages will have the same support files with a
different file extention. See the section on multi-lingual support
for more information.
CASGAME.ENG - Menus & Game Text
-------------------------------
This file contains most of the menus, the display screens, and
the messages used in Casino.
CASHELP.ENG - Help Text
-----------------------
This file contains all of the help screens, menus, and text
required to support the online help system built into the
game.
CASERRS.ENG - Error Text
------------------------
This file contains all of the error messages the program is
capable of generating.
----------------------------------------------------------------------------
Mycroft Systems, P.O. Box 7672, San Jose, CA. 95150 BBS: (408)927-0105
Casino SysOps Documentation - Version 3.01 Page B.3
----------------------------------------------------------------------------
CASEDIT.ENG - Editor Text
-------------------------
This file is the editor message file used in the various edi-
tors. It contains all of the menus, display screens, prompts,
and other text used in the editor.
B.3 Program Files
-----------------
The program files reside in the main program directory. They are
used to run and configure the program as well as support some of
the programs functions. Here is a description of the program
files.
CAS.BAT - Sample Batch File
---------------------------
This file is a sample batch file that may be used or modified
to invoke Casino. If you are using the INSTALL.EXE program,
a custom batch file will automatically be generated for you.
CASXFER.BAT - Sample Download Batch File
----------------------------------------
This file is a sample of the support file used to enable the
downloading of documentation from within the program.
CASINO.EXE - Program Executable File
------------------------------------
This file is the program executable file. It consists of a
main body plus several overlays, which are built in, to run
the various sections of the program.
CASINO.CFG - Program Configuration File
---------------------------------------
This file is the game configuration file. It is a standard
ASCII text file and may be modified using a standard editor.
See the section on game configuration for details of this
file. If you use the INSTALL.EXE program provided with this
door, then this file will automatically be built for you.
CASINO.LNG - Language Selection File
------------------------------------
This file is the language configuration file. It is optional
and only used when you are configuring your version as a
multi-lingual version. The file is a standard ASCII text
file and can be modified with a standard text editor. See the
section on Multi-Lingual Support for more information.
CASINO.ERR - Error Tracking File
--------------------------------
This file is the error tracking file. Almost any error in
the program will generate a message to this file. The error
will be recorded in the language selected in the configuration
file. If the configuration file has not been read or if the
----------------------------------------------------------------------------
Mycroft Systems, P.O. Box 7672, San Jose, CA. 95150 BBS: (408)927-0105
Casino SysOps Documentation - Version 3.01 Page B.4
----------------------------------------------------------------------------
message file containing the error cannot be found then the
error will be recorded as:
Date: MMM DD YYYY User: <user login>
Error [ErrorTag] - Error Message.
Under normal circumstances, the error tag will be followed by
text from the message file.
CSAUTHOR.MSG - Author Message File
---------------------------------
This file contains a message from the author to the players.
It will usually contain information concerning new changes to
the program. Whenever you install an updated version of
Casino, you should run the utility FLAGMSG against this file
to guarantee all users will see this message. The file is a
standard ASCII text file.
CSSYSOP.MSG - SysOp Message File
---------------------------------
This file contains a message from the SysOp to the players.
It should be used to pass information to your players. It
can be used in circumstances like your having changed the
game configuration via the editor. The file is a standard
ASCII text file and can be modified using a standard text
editor. Each line of the file is limited to 78 characters.
TIMEGEN.EXE - Timegen Utility
-----------------------------
This file is the Timegen Utility executable file. This program
is used to impose limits on game access based by user security
levels, time of day, and total time each day. See the
installation section for more information.
TIMES.DEF - Sample Time Control File
------------------------------------
This file is a sample time control source file. The time
control source file is compiled using Timegen to generate the
time control file used by the game.
CASINO.TIM - Game Time Control File
-----------------------------------
This file is a time control file for Casino. The file is
completely optional and only need be used if you want to
restrict access to the program. See the chapter on
installation for more information.
NODES.BBS - Node Definition File Sample
---------------------------------------
This is a sample node ID file. This file must be in the BBS
directory for the program to run remotely. If you use the
INSTALL.EXE program, the file will automatically be built for
----------------------------------------------------------------------------
Mycroft Systems, P.O. Box 7672, San Jose, CA. 95150 BBS: (408)927-0105
Casino SysOps Documentation - Version 3.01 Page B.5
----------------------------------------------------------------------------
you. The file is a standard ASCII text file and is described
in detail in the chapter on installation.
PORTS4.BBS - Port Definition File Sample
---------------------------------------
This is a sample communications port ID file. This file, if
used, must be in the BBS directory for the program to run
remotely. If you use the Install Programs, the file will
automatically be built for you. The file is a standard ASCII
text file and is described in detail in the chapter on
installation.
B.4 Data Files
--------------
The Data Files in Casino reside, for the most part, in the main
program directory. The files that end in .DAT are the data
files used by the game.
CSPLAYER.DAT - Player Information Data
--------------------------------------
This file is the player information file. It contains all
pertanent information on each player in the game.
CSINFO.DAT - Games Information Data
-----------------------------------
This file is keeps track of the last date players were dele-
ted from the game. It also contains all the high scores and
top player information.
<bullet1> - Top 10 Gamblers Bulletin (B/W)
------------------------------------------
The player ratings bulletin will display the top 10
players in the game. The filename and path for the bulletin
are defined by the configuration file command 'BULL1B:'
<bullet2> - Top 10 Gamblers Bulletin (Color)
--------------------------------------------
This bulletin is identical to bulletin 1 except that it is
in color. The filename and path for the bulletin are defi-
ned by the configuration file command 'BULL1C:'.
<bullet3> - Game High Scores Bulletin (B/W)
-------------------------------------------
The game high scores bulletin will display the top scores
achieved for each of the gambling games. The filename and
path are defined by the configuration file command 'BULL2B:'.
<bullet4> - Game High Scores Bulletin (Color)
---------------------------------------------
This bulletin is identical to bulletin 3 except that it is
----------------------------------------------------------------------------
Mycroft Systems, P.O. Box 7672, San Jose, CA. 95150 BBS: (408)927-0105
Casino SysOps Documentation - Version 3.01 Page B.6
----------------------------------------------------------------------------
in color. The filename and path for the bulletin are defi-
ned by the configuration file command 'BULL2C:'.
----------------------------------------------------------------------------
Mycroft Systems, P.O. Box 7672, San Jose, CA. 95150 BBS: (408)927-0105
Casino SysOps Documentation - Version 3.01 Page C.1
----------------------------------------------------------------------------
C.0 SysOp Function Keys
=======================
This appendix will describe the various keys available to SysOps while
a user is within the program.
[Alt F1] This key will eject the current user from the game by
setting all his door access time to consumed.
[Rgt Arrow] This key will add 1 minute of door access time to the
current users current door session.
[Lft Arrow] This key will subtract 1 minute of door access time
from the current users current door session.
[F1] The F1 key will toggle between the various help status
lines. These lines will list all of the other SysOp
keys.
[F2] The F2 key will temporarily turn off the snoop toggle.
It will then display information about the user, such
as when he/she logged into the game, when he/she will
run out of time, his password, etc. To exit the user
information display, press the [END] key.
[F3] The F3 key will temporarily turn off the snoop toggle.
It will then display information about the player,
such as his/her alias, his/her rating, etc.. To exit
the player information display, press the [END] key.
[F5] The F5 key will toggle the users access to the pro-
gram editors. The status line will show an '*'
towards the right side when the user has access.
[F8] The F8 key will toggle the state of the SysOp snoop
toggle. Note that it is reset to its original state
when the BBS is reentered. When this toggle is true,
the local screen will display the same information
as the remote screen. When the toggle is false, the
local screen will remain blank display a single status
line that will be moved aproximately every 5 seconds.
[F9] The F9 key will allow you to drop to a DOS shell. The
player is notified that you have done so, and is locked
out until you return. It is important that you remem-
ber to return to the main Casino directory before ty-
----------------------------------------------------------------------------
Mycroft Systems, P.O. Box 7672, San Jose, CA. 95150 BBS: (408)927-0105
Casino SysOps Documentation - Version 3.01 Page C.2
----------------------------------------------------------------------------
ping 'EXIT' to exit the DOS shell back to the game.
[F10] The F10 key is used to initiate CHAT mode. This allows
the SysOp to converse with the user via the keyboard
The CHAT in this program supports both automatic word
wrap, and also two tone chat mode. Use the [ESC] key
to terminate chat mode.
----------------------------------------------------------------------------
Mycroft Systems, P.O. Box 7672, San Jose, CA. 95150 BBS: (408)927-0105
Casino SysOps Documentation - Version 3.01 Page D.1
----------------------------------------------------------------------------
D.0 Command Line Options
========================
This section covers the various command lines supported by Casino.
CSINIT Execute the initialization program.
This will rebuild the door information
file as well as the player information
file. It has the effect of restarting
a new game.
CSINIT path Execute the initialization program.
This command is identical to the one
above except that you are specifying
the drive and path of where the pro-
gram's data files will be created.
CSUPDATE Execute the program's file updator.
This is only run if you are upgrading
from version 2.xx to version 3.01. It
will convert the data files so that
existing players will retain their
current scores.
CSUPDATE path Execute the programs file updator.
This is identical to the above command
except that you are specifying where
to find the old data files and build
the new ones.
CASINO Execute the program in local mode.
The User is prompted for login and
password. No time controls apply
except the keyboard timeout.
CASINO node Execute the program in G-Mon mode.
G-Mon support files are scanned for
user information. "node" represents
the BBS node number.
CASINO node path tag Standard command line. Executes
Casino in remote BBS mode. The 'node'
parameter is the BBS node number,
the 'path' parameter is the path to
the BBS files, and 'tag' is the BBS
tag ID. The BBS interface files are
scanned for the user info.
CASINO MAINTENANCE Executes Casino program maintenance.
This will delete any players who have
not played for the number of days spe-
cified in the configuration file.
----------------------------------------------------------------------------
Mycroft Systems, P.O. Box 7672, San Jose, CA. 95150 BBS: (408)927-0105
Casino SysOps Documentation - Version 3.01 Page E.1
----------------------------------------------------------------------------
E.0 Multi-Lingual Support
=========================
Casino is one of the first Mycroft Doors designed to support multiple
human languages. Language support is possible due to an inovative
external message file system. As time goes by, more and more Mycroft
Doors will be converted to the multi-lingual support system. Also
more and more languages will be supported.
In Casino, adding another language is as simple as 1, 2, 3. 1. Iden-
tify the language you want to add; 2. Download the language support
file (for Casino, these will be available as CAS-xxx.ZIP where the
xxx in the language extention) and unzip it into the MSGS subdirectory;
3. Add a line to the language control file (for Casino this is
CASINO.LNG).
The following languages are proposed to be supported at some point.
ENG - English code page 437 UKG - English code page 850
FRN - French code page 437 FRC - French code page 863
SPN - Spanish code page 437 SPS - Spanish code page 850
GRM - German code page 437 GMN - German code page 850
ITL - Italian code page 437 ITN - Italian code page 850
PTG - Portugese code page 437 PTU - Portugese code page 860
If you are interested in doing a language conversion, please
contact the author.
To make the languages available to your users, you will need to
create a language control file named CASINO.LNG. This file consists
of 2 or more language definition records. Each record is a single
line. The first part is a 3 character file extention, and the
second part is the language definition text to be displayed in the
language selection menu. The following is a sample to offer English,
French, and German:
ENG English
FRN Francais
GRM Deutch
We hope the multi-lingual support feature becomes a popular one and
that many SysOps will volunteer to do language conversions.
----------------------------------------------------------------------------
Mycroft Systems, P.O. Box 7672, San Jose, CA. 95150 BBS: (408)927-0105