Category : Various Text files
Archive   : BNWS9501.ZIP
Filename : THEPIT

 
Output of file : THEPIT contained in archive : BNWS9501.ZIP

THE PIT v4.xx - SYSOP DOCUMENTATION
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Written by James R. Berry



Welcome to The Pit 4.0, the latest release from Midas Touch Software.
This document has been prepared with the new player in mind. It explains
step by step by step how to play, with special attention to new features
introduced in this version.



Game Introduction
~~~~~~~~~~~~~~~~~

Regal City had a problem. Thieves and vagrants owned the streets,
tormenting honest merchants and ambushing visitors. And if that weren't bad
enough, those few honest citizens that could swing swords were teaming up
into gangs of vigilantes, adding to the violence.

In a fit of desperation, King Reginald Hornbluff cleared out the dust
and debris from the town square and constructed a huge arena. Then, he
issued an invitation for the thieves and vigilantes to meet in the town
square to settle their differences publicly. This appealed to the egos of
both groups; they agreed to appear.

On the night of the big event, the stands were packed with innocent
townspeople wanting revenge. King Hornbluff was not a stupid man, he charged
the townspeople 3 gold pieces a head to watch the fight and sold sausages and
beer at an outrageous markup.

The first battle between the thieves and the vigilantes was bloody,
violent, and extremely profitable. So profitable in fact, Hornbluff
scheduled a rematch.

As time passed, the duels in the arena became more and more popular.
Young men who would have turned to thievery now became gladiators, earning
fame, glory, and no small amount of gold.

Hornbluff sent his men to capture monsters from the surrounding
territory to challenge these warriors.

Today Regal City is a legend. Warriors come from all around for a
chance at honor, glory, and a quick buck. Hornbluff's Arena, known simply as
The Pit, features battles between some of the strangest and most powerful
creatures in the land.

Rumor has it that even the Gods themselves will visit to smash
foolish mortals wishing to challenge them.

These fights are profitable, but usually very short.






3




And that's where you come in: a lowly farmer's boy ready to seek his
fortune in Regal City. You've done odd jobs along the way, sweeping stables
and tending livestock, and you've saved every penny for a sword and armor
once you get there.

Maybe one day you'll become one of the true legends, an Immortal. Or
perhaps just a dark spot on the floor to be swept away with the sawdust.

Either way, it's in your hands.



Copyright (c) 1990-94 by MIDAS TOUCH SOFTWARE, all rights reserved
Copyright (c) 1990-94 by James R. Berry, all rights reserved


2




WHAT'S IN THE ARCHIVE
---------------------

FILES INCLUDED IN PIT4XX.ZIP:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

PIT.EXE - Executable of THE PIT v4.xx online game.

CONTROL.EXE - This program allows you to configure the THE PIT's options
to match those needed by your particular BBS system.

PEDIT.EXE - This program is a PLAYER EDITOR. With it you can adjust any
players stats to those that you desire.

PITEDIT.EXE - This program allows the SYSOP to edit weapons, enemies,
magic, and other settings in THE PIT. It is a powerful
program with too many options to summarize.

PBULL.EXE - This program generates a TOP 10 LISTING for use as a
bulletin by your BBS.

RANKBLD.EXE - This program uses your PLYR.LST and PLYR.DAT files to
rebuild your RANK.DAT (Player Ranking List). Use this if
your list of rankings has become corrupted.

PLAYER.DOC - This file is all of the documentation needed by players.
Note however that a majority of this information is
contained within the game itself in the form of online
instructions.

SYSOP.DOC - The file you are now reading.

ORDER.FRM - Order Form (Fill out to register THE PIT).

HINT.DOC - Lists hints and other userful information about behind the
scenes info on THE PIT. (ie. percentages in regards to the
TAVERN and other things like ASSASSINS and the DARK
AVENGER)





3




SYSOP COMMANDS
~~~~~~~~~~~~~~

There are a few commands that can be activated only by a local sysop.
They are listed below:

- Help Screen - Lists these function key commands

- System Status (Memory, Stack Space)

- Add five minutes to time left for player.

- Subtract five minutes from time left for player.

- Throw player out of THE PIT.

- Chat with player in a two color chat mode.





4




FEATURES OF THE GAME
~~~~~~~~~~~~~~~~~~~~

MULTILINE CHAT/COMBAT
~~~~~~~~~~~~~~~~~~~~~
If you have a multiline BBS, THE PIT is capable of handling chat and
player vs. player combat. Players chat in a multiline chat window in
real time. From inside that area players can challenge each other to
combat, and provided the other player accepts, they drop into a
multiline arena to do battle.

GRAPHICS
~~~~~~~~
THE PIT is capable of displaying graphics to the local player. It
will play sound effects/music through a sound card or pc speaker. And
mouse control is also provided.

ANSI EMULATION
~~~~~~~~~~~~~~
This game simulates ANSI with its own fast screen write routines. The
ANSI.SYS device driver is not required to see the ANSI screens
properly. In fact the program even pops windows up using ANSI
emulation and restores the background to its original condition.

BBS MUSIC
~~~~~~~~~
This game will send BBS MUSIC to terminals that are capable of
playing it (QMODEM, TELEMATE, ect.). It will also play the music
locally only when the local sysop is playing. Sound effects enhance
the game by having weapons clang, arrows fly and healers chanting...

CHAT MODE
~~~~~~~~~
This game also includes a CHAT MODE that will pause the timer while
the player is chatting. A pop-up window will appear that is in split
screen chat mode.

VISUAL BATTLES
~~~~~~~~~~~~~~
The primary thing this game offers that many others do not is a
visual battle. Multiple opponents move about on the screen in an
attempt to defeat the player. Arrows fly, and make sounds as they
take flight. And a defeats even end with a death march.

BATTLE SAVE
~~~~~~~~~~~
If a player is in the middle of a battle and either runs out of time,
hangs up, or is thrown off, the battle is automatically saved and
completed at a later time. Notice that players hanging up in the
middle of battles not only get their game saved, they also get
penalized for their attempt at cheating.





5




CHALLENGE
~~~~~~~~~
If a player is alive and not already engaged in a saved battle, you
can challenge them.

LOG OF BATTLES
~~~~~~~~~~~~~~
A complete two day log of battles is kept track of by the game. You
can find out exactly when someone logged onto the game and what major
conflicts occurred during their session.

STATUS LINE
~~~~~~~~~~~
A status line appears on the bottom of the local sysop screen. It
tells you who is on and how much time they have remaining.

GRAPHICS TERMINAL
~~~~~~~~~~~~~~~~~
THE PIT features a user terminal interface. It acts somewhat like the
ZMODEM protocol. The player activates the THE PIT BBS game as they do
normally. They then activate their PIT TERMINAL INTERFACE (Either
ANSI or EGA version) as if it were a file transfer.

Provided they installed the interface correctly on their end, a
substantial improvement in speed will result. (2400 baud connects
will seem more like 14.4K)

It also has animation, mouse control, panning graphics, ADLIB MUSIC,
and SOUND BLASTER sound effects.

If you do not already have this terminal it is available for download
at:

MTS BBS (806)797-2239 (14.4K - 24 hrs)



6




PLEASE REGISTER!
~~~~~~~~~~~~~~~~

The continued support of this game and others of similar quality
depend soley upon registration. It is simple logic that if a programmer is
not payed for his (or her) efforts, then the programmer will work go to work
for someone else and games like this one will disappear.


UPGRADE POLICY
~~~~~~~~~~~~~~

You can register for the low price of only $29.95 + Shipping
(See REGISTER.DOC). There are several ways to register this game. And they
are all listed in our registration form. (See REGISTER.DOC)

All MINOR bug fixes (v3.01 - v3.99) are FREE if DOWNLOADED from our
BBS (Contact us by VOICE to obtain them). All additional MAJOR versions
(v5.0, v6.0, ect.) cost about $8.00 + Shipping.


BUGS!
~~~~~

If you have found a bug or you have a question or suggestion, please
call our BBS:

MIDAS TOUCH SOFTWARE BBS
14.4K - 24hrs/Day
(806)797-2239


Or call our CUSTOMER SUPPORT phone number:

MIDAS TOUCH SOFTWARE
(806)796-1781
[MON-FRI 10AM - 7PM CST]








Introduction
~~~~~~~~~~~~
This is the configuration program for The Pit 4.x. Use this program
to tell the game about your system. We've done our best to provide useful
options and make things easy to configure.

Most problems that people encounter running The Pit can be solved by
adjusting these settings. If something isn't functioning properly, check
your configuration file first.

System Requirements
~~~~~~~~~~~~~~~~~~~
The Pit 4.x can run on any IBM system. It takes up 420k of memory
and 2 Megs of disk space initially. It is possible to play The Pit in Local
mode without being connected to a BBS.

This version of The Pit supports multi-line BBS's. Specific
information is provided later in this document.

Program Layout
~~~~~~~~~~~~~~
Just use the standard control keys (Arrows, Pg Up, Pg Down) to move
to the item you wish to change and press Enter. The area will be highlighted
while you're working on it. When you're done, just press ESC.
































3




MAIN MENU: SELECT A COMMAND
~~~~~~~~~~~~~~~~~~~~~~~~~~~

1. Edit Pit Configuration
~~~~~~~~~~~~~~~~~~~~~~
This command allows you to select a specific PIT configuration to
edit. You simply select a configuration file and we will enter an
editing menu.

2. Edit Node Configuration
~~~~~~~~~~~~~~~~~~~~~~~
This command allows us to select which pit configuration a specific
BBS node (phone line) will run from.

3. Toggle Multiline Active
~~~~~~~~~~~~~~~~~~~~~~~
This command toggles multiline play on or off.

4. Edit Number of Nodes
~~~~~~~~~~~~~~~~~~~~
We use this command to select how many nodes we wish to run. This
setting will effect the number of nodes displayed in the "Edit Node
Configuration" menu. This number should be set to the number of lines
you are running on your BBS. It can be changed to a number greater
than "1" if "Toggle Multiline Active" is set to Multiline Play
Active.

5. Reset THE PIT
~~~~~~~~~~~~~~

A) Reset Entire Game
~~~~~~~~~~~~~~~~~
This command clears all of the data files used by THE PIT.
This effectively restarts the game.

B) Reset Player Node List
~~~~~~~~~~~~~~~~~~~~~~
This command resets the player node list. This is the list
that tells the game which node a user is on and also controls
multiline challenges/chat. This file may require resetting to
solve a persistent multiline error.

C) Reset Immortal List
~~~~~~~~~~~~~~~~~~~
This command resets our immortals list. We provide this in
case of possible file corruption. If the immortal list keeps
resulting in game crashes, reset this file.

6. Quit CONTROL STATION
~~~~~~~~~~~~~~~~~~~~
This command as well as the key will allow us to exit the
CONTROL STATION.




4




EDITING THE PIT CONFIGURATION
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

1. Load/Edit New Config
~~~~~~~~~~~~~~~~~~~~
Choose a pit configuration file you would like to edit.

2. Edit Description of Config
~~~~~~~~~~~~~~~~~~~~~~~~~~
You can attach a description to a pit configuration file to make it
easier to keep track of its function.

3. Save Config File as...
~~~~~~~~~~~~~~~~~~~~~~
You can save the file you are currently editing under any name you
wish. Choose a file name to save it as, or choose "New" to save
it under a new file name.

4. Modem Settings
~~~~~~~~~~~~~~
This section allows us to setup the modem so that it will function
properly with in the game.


A. Fossil Driver Usage
~~~~~~~~~~~~~~~~~~~
This defaults to "Inactive". Normally THE PIT uses its own
internal communication routines to handle the modem.

Sometimes the fossil driver is required for our software to
run on your BBS system. If you have X00.SYS, BNU.SYS, or a
digiboard fossil loaded you can set this option to "Active".
The game will automatically detect the driver and utilize its
communication routines instead.

B. Com Port Addressing
~~~~~~~~~~~~~~~~~~~
This section will allow you to change the default settings
for your com ports. Normally these do not require any
changes, as they are already set to the default addresses
used by 99% of all BBS systems.

Notice that these settings are used internally by only our
game. They will have no effect on your BBS Systems settings
nor DOS.

C. Baud Rate Setting
~~~~~~~~~~~~~~~~~
We provide the ability to lock the baud rate of your modem to
almost all of the baud rates possible for a modem.

For most BBS systems the best selection is "Do Not Set, Use
Default Rate". This option forces THE PIT to run at the baud
rate at which the BBS is already connected to the caller. Any


5




C. Baud Rate Setting (Continued)
~~~~~~~~~~~~~~~~~
other option results in THE PIT setting the baud rate on the
modem to the rate specified.

On a high speed modem the baud rate might readjust itself
based on the integrity of the phone line. This might result
in THE PIT setting the baud rate incorrectly. The most
noticeable effect will be the appearance of ANSI trash on the
screen instead of the ANSI expected.

D. Flow Control
~~~~~~~~~~~~
This selection has only two options, either "None" or
"CTS/RTS Flow Control".

If you are running a modem that is faster than 2400 you are
ABSOLUTELY REQUIRED to have CTS/RTS turned on. Under this
setting, the game uses the CTS and RTS pins on the modem to
regulate the flow of data across the phone line. Without the
CTS/RTS set on, the result would be that no data would flow
at all. The remote caller would see nothing on their end, and
they would be unable to get a response from any key press.

E. 16550 FIFO Buffer
~~~~~~~~~~~~~~~~~
This setting allows you to select the size of the "First-In
First-Out" buffer on your 16550 chip. This buffer is used
primarily by high speed modems to achieve an effective
transfer rate greater than the normal 19,200 baud rate. The
safest setting is "FIFO Buffer Is Turned OFF". However, if
you know what your BBS is using, you can always change it to
1, 4, 8, or 14 byte buffers.























6




5. Door File Settings
~~~~~~~~~~~~~~~~~~
This option is used primarily to choose which BBS door file type we
are using and where it is located (i.e. its path).

A. BBS Door File Type
~~~~~~~~~~~~~~~~~~
You can select which BBS door file your BBS system passes its
user information through. We currently support 9 different
door file types.

B. Path To Door File Type
~~~~~~~~~~~~~~~~~~~~~~
You select this option to tell the game where your BBS door
file (i.e. DOOR.SYS) is located. There are also several
parameters available (%P, %N, and %Z) to make setting this
easier for multiline BBS's. By passing specific codes on THE
PIT's command line, you can take advantage of these
parameters.

%P : This parameter is replaced by a path that is passed to
THE PIT at run time. This is done by a command line
parameter called "/PATH=".

For example, if you set the path as "%P\NODE1\" in the
pit configuration. Then you passed a run time parameter
to THE PIT like so: "PIT /PATH=C:\BBS".

The game would replace the %P parameter with the run
time information passed to THE PIT. This would result in
the path internally rewritten as: "C:\BBS\NODE1\".

This parameter was primarily added to allow BBS's with a
hundred or more phone lines, an easy way to define the
path of the door file on the fly.

%N : This parameter is replaced by the node number that is
passed to THE PIT at run time. This is done by a command
line parameter called "/NODE=".

For example, if you set the path as
"C:\WILDCAT\WCWORK\NODE%N\" in the pit configuration.
Then you passed a run time parameter to THE PIT like so:
"PIT /NODE=12".

The game would replace the %N parameter with the run
time information passed to THE PIT. This would result in
the path internally rewritten as:
"C:\WILDCAT\WCWORK\NODE12\".

%Z : This parameter works exactly the same as %N except the
internal number is expanded into a 3 digit zeroed
number. For example if the node number passed is "3"
then %Z would be replaced by "003".Or if the number is
"12" then %Z would be replaced internally by "012".

7




6. Game Time Settings
~~~~~~~~~~~~~~~~~~
This section deals with the length of and display of game time.

A. Maximum Time Per Day
~~~~~~~~~~~~~~~~~~~~
This is the maximum number of minutes you will allow the
caller to play THE PIT per day. This value self-adjusts for
each caller, depending on how much actual time they have left
on your BBS system each day.

B. Show Time Left In Game
~~~~~~~~~~~~~~~~~~~~~~
This setting has two options, either "Yes" or "No". If set to
"No", the time left will not be displayed to the players.

If set to "Yes", THE PIT will display how many minutes the
user has left in the game on the menu. Each time a key is
pressed in the game, the displayed time is updated.

C. Game Down Time
~~~~~~~~~~~~~~
This option will make THE PIT inaccessible for the duration
of time given.

7. Monitor Settings
~~~~~~~~~~~~~~~~
This section deals with the video monitor's settings. How data is
written to the screen as well as what mode the game will run in.

A. Monitor Type
~~~~~~~~~~~~
This option allows you to either specifically tell
the game what kind of monitor you are running, or let
it auto-detect it. If Monochrome is selected, the
game will always run in black and white. If CGA is
selected, it will result in the game running in color
text mode, but graphics will be inaccessible. The
other modes allow you to play in either text or
graphics mode.

B. Video Write
~~~~~~~~~~~
This option tells the game what kind of text mode
screen writes you wish the game to perform. "Direct
Video Write" is the best option since it writes to
the screen four times faster than any other mode.
"Bios Video Write" is provided strictly for
compatibility sake. Bios writes are not recommended
because they are so slow.






8




C. Snow Checking
~~~~~~~~~~~~~
This option is given for compatibility. Only very old
CGA monitors require this selection. It can be left
OFF in most cases.

D. Display ANSI Graphics Only
~~~~~~~~~~~~~~~~~~~~~~~~~~
This option was installed primarily for Desqview
users. It forces THE PIT to never allow graphics mode
activation in THE PIT.

When a user activates the PIT Terminal in graphics
mode, THE PIT will change modes on the BBS end to
match the remote terminal. Desqview BBS Systems
suffer from screen bleeds when too many nodes utilize
the graphics screens. Setting this option to "Yes"
will prevent this from occurring.

8. Hardware Settings
~~~~~~~~~~~~~~~~~
This section is used to set up the hardware peripherals that are
attached to the system. Sound Cards, Mouse and Joystick are covered.

A. Music
~~~~~
MIDI music will be played through a sound card, the pc
speaker, or not at all. You must choose the best choice for
your system.

Remember to not choose a sound card if you are running under
DESQVIEW. Multiple users accessing the same sound card might
cause a system crash.

Notice that the Sound Blaster Pro 16 is not given as a
choice. At the time this game was written we did not own a SB
16. We believe that it will only function if "Sound Blaster
v1.5" is chosen as the sound card type.

B. Sound FX
~~~~~~~~
Sound Effects will be played through a sound card, the pc
speaker, or not at all. You must choose how your sound
effects will be played. (See the notes about Desqview and the
Sound Blaster Pro 16 above.)

C. Sound Blaster Card Settings
~~~~~~~~~~~~~~~~~~~~~~~~~~~
This selection will allow you to change your Sound Blaster
settings from the defaults. If you have your sound card dip
switches set to alternate settings, you will have to change
these settings to match it. We provide you the standard
choices of IRQ's and Addresses provided by the manufacturer.



9




D. Adlib Card Settings
~~~~~~~~~~~~~~~~~~~
This section will allow you to change your Adlib settings
from the defaults. If you have your sound card dip switch set
to alternate settings, you will have to change these settings
to match it. We have provided you with the standard choices
of IRQ's and Addresses available from the manufacturer.

E. Mouse
~~~~~
This option allows us to either auto-detect the existant of a
mouse and utilize it, or claim to have none.

F. Joystick
~~~~~~~~
This option allows us to either activate the use of a
joystick or not activate it.

9. SysOp Flag Settings
~~~~~~~~~~~~~~~~~~~
This option will effect the setting for the Hangup Penalty. If a user
hangs up in the game, this flag will penalize the user if it is set
to "Active", or not if it is set to "Inactive". Notice that this
penalty can be individually controlled with in the PLAYER EDITOR
(PEDIT.EXE).

10. Bulletin Creation
~~~~~~~~~~~~~~~~~
This section controls the creation and file name used when creating a
top ten list of players.

A. Create Bulletins
~~~~~~~~~~~~~~~~
This section activates the creation of a particular bulletin
and when exactly you would like to have it created.

B. ANSI Bulletin
~~~~~~~~~~~~~
This is the full path and file name of the color ANSI
bulletin.

C. B&W ANSI Bulletin
~~~~~~~~~~~~~~~~~
This is the full path and file name of the B&W ANSI Bulletin.

D. ASCII Bulletin
~~~~~~~~~~~~~~
This is the full path and file name of the ASCII Bulletin.








10




11. LAN/Multitasker
~~~~~~~~~~~~~~~
Select which kind of mutliline platform you are running.

A. None
~~~~
This is the default setting. This is the only choice if you
are running a single line system. If any other setting is
selected while in single line mode, this mode will over-ride
all others.

If you are running in Multiline Play mode this selection will
default to "Share.exe" mode. Multiline play is impossible
without share loaded. The game utilizes share excusively to
perform its multiline file locking.

B. Share.exe
~~~~~~~~~
This selection is the best choice if you are unsure of which
choice to make. As long as SHARE.EXE is loaded, running this
game in multiline mode should give you no problems.

C. Desqview
~~~~~~~~
This selection tells the game that you are running desqview.
Actually the game automatically detects the existance of
desqview and will utilize its functions regardless of what
you choose. This selection verifies your choice of running
Desqview and share.exe as your multiline system. The game
will give up time desqview time slices while it runs.

D. OS/2
~~~~
This selection tells the game that you are running OS/2 as
your multitasker. The game will require that SHARE be loaded
as well. It will also give up time slices under OS/2 as a
result of your selection.

E. Windows
~~~~~~~
This selection tells the game that you are running Windows as
your multitasker. The version of Windows you are running will
be auto-detected and displayed at the intro to the game. The
game will require that SHARE be loaded, and time slices will
be given up under Windows.

F. Net Bios Compat. LAN
~~~~~~~~~~~~~~~~~~~~
This selection tells THE PIT that a netbios compatible LAN is
being run. The game will attempt to detect the existance of
NETBIOS in memory. If this selection fails for you, or you
are running NETWARE, choose "Share.exe" instead.

"Desqview" could also be chosen if you are running a
combination of Desqview and Netbios.

11




12. PIT Game Setting
~~~~~~~~~~~~~~~~
Select which set of game data files to use in THE PIT. This will
control which set of weapons, armor, enemy's, ect will be used for
game play.




  3 Responses to “Category : Various Text files
Archive   : BNWS9501.ZIP
Filename : THEPIT

  1. Very nice! Thank you for this wonderful archive. I wonder why I found it only now. Long live the BBS file archives!

  2. This is so awesome! 😀 I’d be cool if you could download an entire archive of this at once, though.

  3. But one thing that puzzles me is the “mtswslnkmcjklsdlsbdmMICROSOFT” string. There is an article about it here. It is definitely worth a read: http://www.os2museum.com/wp/mtswslnk/