
                         MajorMUD

      Copyright (c) 1993,1994     West Coast Creations
                   All Rights Reserved


                     LIMITED warranty

This documentation and any related software are sold "as-is",
without any warranty either expressed or implied, including,
but not limited to, the implied warranties of merchantability,
fitness for a particular purpose, and loss of profits or other
economic damages.  West Coast Creations does not warrant
that the operation of this software will be uninterrupted or
error-free.  In no event and under no circumstances will West
Coast Creations be liable for any damages in excess of the
sum paid by customer for the product to which any claim for
damages relates.


                         License

By installing, taking delivery of, or downloading this software,
which refers to any or all executable, library, documentation,
and support files included with this product, any any 
reproductions, whether in machine readable or printed form, 
you agree to the following terms:

You may:
1. Install and operate this software on a single machine.
2. Make one copy this software into machine-readable or
   printed form, for backup or archival purposes in support of
   your use of this software.

This software is licensed to a single corporation or person,
for operation on a single machine only.  Once licensed, the
license to use this software is NOT TRANSFERABLE to any other
person or corporation without the express, written permission
of an officer of West Coast Creations.  Note that this product
cannot be used by anyone in the Province of British Columbia in 
Canada without the express, written permission of an officer of 
West Coast Creations.  Note also that the physical location of 
the BBS upon which MajorMUD is installed may not be moved 
without the express, written permission of an officer of 
West Coast Creations.  

YOU MAY NOT USE, COPY, MODIFY, MERGE, DISASSEMBLE, OR TRANSFER
THIS SOFTWARE, IN WHOLE OR IN PART, EXCEPT AS EXPRESSLY
PROVIDED FOR IN THIS LICENSE.

Violation of any parameter of this license will result in
the immediate forfeiture of said license.


               ***** Technical Support *****

West Coast Creations is based in Vancouver, BC, Canada.  You can 
contact us via the support board at:

                    (604) 739-3712 (2400)
                    (604) 739-3714 (14.4)

We would love to hear any suggestions, criticisms, questions, or 
other comments which you might have.

You can reach us by mail at:     or via Mailink:

West Coast Creations             Lance@WCC     [ Lance ]
PO BOX 74645                     Cat@WCC       [ Mike  ]
Vancouver, BC                    Rasputin@WCC  [ Craig ]
Canada, V6K 4P4                  Orfeo@WCC     [ Geoff ]

If you have a problem which requires faster response, you can 
contact us via the following numbers:

For:               Call:
Game-Play Support  (604) 732-9668 [ Mike  - Anytime ]
Technical Support  (604) 420-2462 [ Lance - Evenings (PST) and Weekends ]

Game-Play Support qualifies as anything related to problems with rooms,
problems with monsters, questions about how abilities affect characters,
what a spell does, what the differences between classes are, anything
about any quests, etc.

Technical Support qualifies as board crashes, user-hangups, commands
not functioning properly, other functional problems.

Please ensure that you call the correct number because we are in 
physically separate locations and cannot answer questions about the
other topic (i.e. Lance knows about the MUD 'engine' which drives the
game but doesn't know very much about the actual monsters, maps, etc.
within the game and Mike is the exact opposite)

If you cannot contact us via the above numbers, you can fax a detailed
description of your problem/question to us at the following number.
We will attempt to contact you as soon as possible after receiving the
fax, although if we get enough detail in the fax, we _might_ be able to
provide a fix at the same time as we return the call.

FAX                    (604) 737-3689   [ Geoff ]




DOCUMENTATION:
This documentation contains sections on:

1) INTRODUCTION 
2) INSTALLATION 
3) CONFIGURATION
4) ONLINE SYSOP FUNCTIONS

Appendix A - Resetting your game 





1) INTRODUCTION:

   MajorMUD is an interactive, text-based adventure game which
evolves around puzzle solving and character building.  The game
begins in the city of NewHaven, set on the far West side
of the MajorMUD world. From NewHaven, users progress to the town
of Silvermere, a city under siege from within it's walls.

   Users start by choosing one of several races, and
one of many classes.  Their character then becomes an adventurer
in the Realm, each with special skills and abilities.  Beginning
in the city of NewHaven, with little money, no weapon,
and no equipment, the user is free to try to advance his character
and make his fortune.
  
   Users advancement happens many ways.  A user can fight his way
through hordes of monsters, or traverse the realm looking for puzzles
to solve and wealth to find.



2) INSTALLATION:

   1) Insert the MajorMUD disk into your BBS computer.  Note that because
      we are attempting to constantly release updates we will not be 
      shipping any disks.  All updates and releases will be available
      for downloading on our support BBS (WCC).  The standard installation
      will require you to download the provided .ZIP file, extract it into
      an empty directory and continue the installation at step 2, using
      the name of the directory you unzipped into instead of A:

   2) Type "A:INSTALL" at your DOS prompt to begin
      installation.

   3) The installation program will begin running:
      A) The install program will try to determine where it
         should install MajorMUD.

      B) It will then bring up a dialog box and ask you to
         verify where MajorMUD is to be installed.  Make
         sure that the directory specified is the directory of
         your actual MajorBBS executable program.

      C) The install program will then verify that you have
         enough disk space for installation.

   4) When the installation program is done running, return to
      your main BBS directory, if you are not there already.

   5) Type "BBS" at the DOS prompt and add MajorMUD to
         your menu structure.

   6) Use the configuration utilities to customize MajorMUD
      for your own system.  For a list of these options, see
      the section title CONFIGURATION.

   8) Run your BBS!  MajorMUD should be all ready to go!


3) CONFIGURATION:

The following CNF options are available for your customization.  Note
that each of these options has help available using the CNF editor.

-- Level 3 -- Security and Accounting -- 

ACTIVATE - The activation code you received from WCC when you
           purchased MajorMUD.  Please note that this must be EXACT.

GAMCRD   - All non-exempt users will be charged this amount of 
           credits/minute.

REALCRD  - All exempt and non-exempt users will be charged this amount
           of credits/minute.  Note the connection to FREEMIN.

FREEMIN  - The number of minutes between cleanups which users may
           spend in the game prior to being charged REALCRD.

SYSOPKEY - The key required to use the SYSOP and related commands.

LOANKEY  - The key required for a user to borrow money from banks.
           Note that this feature has been semi-permanently disabled.

PLAYKEY  - The key required to "Enter the Realm".  Without this key, users
           may enter the module and read the help files, etc. but may not
           actually play the game.

NOPLAYKY - If the user has this key, then they may not play the game
           with one exeption: If they also have the SYSOPKEY, then
           they may still play.

SAVEKEY  - Only players with this key will have their MMUD characters 
           saved.  This should be the same as the PLAYKEY on most 
           systems, but can be used to provide demo access to play
           the game if desired. (i.e. Give paying users both the
           PLAYKEY and the SAVEKEY, but give guests only the SAVEKEY.

-- LEVEL 4 -- Configuration Options --

SECOTH   - This is the number of seconds between the automatic saving of
           player data.  This will be rounded off to the nearest minute.

SECBUFF  - The game uses a number of buffers in memory to improve 
           performance.  These buffers are automatically saved at regular
           intervals as defined by this parameter.

BUFTOSAV - This controls the number of buffers which are actually saved
           on each cycle.  If you do not have hardware disk caching, then
           this should not be set higher than around 5.  If you do have
           disk caching, then you may set this number a fair bit higher.

ROOMBUF  - Each of these parameters defines the number of buffers/type
ITEMBUF    to keep in memory.  If you set these too high, then your BBS
MONSBUF    will not start due to insufficient memory.  The default settings
KMONSBUF   should work on most BBS configurations.
SPELBUF  - If you still have a fair bit of free memory after loading your
RACEBUF    BBS, then feel free to increase these values.
CLASSBUF - Note that increasing MONSBUF too high may cause performance 
BANKBUF    problems on slower machines (i.e. 386)
MESSBUF
SHOPBUF
GANGBUF

TALKCHAR - This gives you the ability to change the default character for
           talking to just about any valid character if a '.' conflicts
           with any other global package.

YELLCHAR - This gives you the ability to change the default character for
           yelling to just about any valid character if a '"' conflicts
           with any other global package.

USRCURNM - The most valuable currency in the land may be renamed.

DEATHHP  - When a user hits 0 HP, he is considered 'unconscious' and is still
           in the game.  This parameter determines the bottom limit to
           be reached before actually dying.

XTRALVL  - To stop users from earning all their experience without training,
           you may limit the number of extra levels of experience which
           they may earn without training.

PUNHUP   - This option defines the level of punishment to apply to 
           characters who drop carrier.  A high level of punishment will
           reduce their HP by approx. 50% and will drop approx. 50% of
           their items.  Medium punishment will only do this if the
           user is in combat with another user when they hangup.  Low
           will not do anything to the user.

INVGLO1  - If there are any global commands which actually change the state
INVGLO2    of the user so that they are not in the original module anymore,
INVGLO3    then you can use these options to disable those global commands
INVGLO4    while the user is playing MajorMUD.  (Otherwise they can use
INVGLO5    the globals to cheat and break out of a tough combat situation)

MAXTOP   - The default topten lists will only display 10 users or gangs
           If you wish to increase this number, this is the option to change.

EVILKEEP - By default, when a user dies, their current level of evil
           points is maintained with their USERID and not their MajorMUD
           character ID.  You can use this option to alter the percentage
           of evil points which are maintained from one character to the
           next.

MAILUSER - MajorMUD will send email such as internal logic errors,
           feedback from users, and unavailable help requests via
           Mailink (If present on the system) to Lance@WCC.  If you
           wish to receive a copy of this mail, specify the user
           account to receive the mail here.


-- Level 6 -- Edit Text Blocks --

USRLOGIN - Users with the PLAYKEY will receive this text message when they
           login to your BBS.

USRLOGOF - Users with the PLAYKEY will receive this text message when they
           logoff your BBS.

USRFOLED - This is the first thing each user sees when they Enter the Realm

USREXIT  - This is the last thing each user sees when they Exit the Realm



4) ONLINE SYSOP FUNCTIONS

There are a number of online sysop functions available.  They can be 
divided into two main areas: From the menus, and In the game.  

SYSOP FUNCTIONS FROM THE MAJORMUD MENU:

To activate the sysop menu from the MajorMUD main menu, type the word
SYSOP at the menu prompt.  You will then be at the sysop menu which 
is as follows:

C - Clear all saved evil points
U - Apply an update
R - Reindex the Limited Items
D - Check for MUD users with no BBS user account
X - Exit to Main Menu

C - Clear all saved evil points
Clear all saved evil points is a function primarily for any of the existing
boards who wish to reset their game.  As MajorMUD does not store evil points
saved between characters in the WCCUSERS.DAT database, merely overwriting
this database will not remove all of the saved evil points.  
See Appendix A - Resetting your game for more information.

U - Apply an update
There will be several different kind of updates which we will be providing
for MajorMUD.  Essentially, an update will either be a DLL update, a 
database update, or both.  If it is either a DLL update or a 'both' update
then you will have to bring your BBS down and run the standard installation
program to receive the update.  If it is only a database update then you
can update your BBS without shutting it down.  For these cases you will
receive a file usually called WCCUPDAT.DAT.  This file will contain all of
the necessary information for upgrading your databases online.  To apply 
these updates, ensure that this file is accessable in your bbsv6 directory
and choose this option (U) from the MajorMUD sysop menu.  You will be
asked for the name of a file at which point you type in the name of the
update database (wccupdat.dat).  MajorMUD will now apply all of the updates
from this database to your running system.  You will notice an increase in
load during this process as there is a large amount of disk access required,
although your board should still be very much usable.

R - Reindex the Limited Items
MajorMUD has a number of items which have a limited quantity within the 
game.  Although we have tried to catch all of the possible locations in
which an item could get 'lost' we may have missed one or two.  This function
will check through all of the items in your database and confirm that
each item is actually where it thinks it is and that there are as many 
items actually present in the game as the game thinks there are.  This 
function will be automatically run as part of the Upgrade procedure 
described above.  We would recommend that you run this procedure at routine
intervals (every few days) to ensure that your database remains consistent.

D - Check for MUD users with no BBS user account
During the BETA testing period, one of the features which got left until
the end was the deleting of MajorMUD users when the actual BBS account
was deleted.  This utility will walk through all of the MajorMUD characters
and confirm that the BBS account still exists.  If it doesn't exist, you
will be prompted to delete it (at which point, X will take you out of
the checking).  Note that if you choose to not delete the MajorMUD character,
the next user to login and create an account as that userid will 'inherit'
the MajorMUD character for that userid.


SYSOP FUNCTIONS FROM THE WITHIN THE GAME:
As a sysop, there a few special functions which you can activate while
you are playing MajorMUD.  All of the sysop functions in the game
begin with the word SYSOP.  If you type SYSOP alone you will receive
online help as to which options are available.  These commands are:

SYSOP BUFFERS
SYSOP STATUS
SYSOP MAP
SYSOP GOD
SYSOP LIST
SYSOP REPORT
SYSOP LIGHTNING
SYSOP DISBAND

The BUFFERS command has three variations:
SYSOP BUFFERS 
    Displays the current status of MajorMUD's in-memory buffers
SYSOP BUFFERS CLEAR
    Clears any of the hits and misses counts for the buffers
SYSOP BUFFERS SAVE
    This will save all of the modified buffers in MajorMUD.  Note that
    this function should not normally be used for two reasons: 1) MajorMUD
    automatically saves all the modified buffers at routine intervals and
    2) This function will effectively FREEZE your board for all other 
    users until it has completed.

The STATUS command has two variations:
SYSOP STATUS
    Displays debugging information about the room you are currently in.
    If you are having problems with monsters not regenerating, or monsters
    that never seem to stop regenerating, then you may be asked by 
    Technical Support (Lance) to provide the results of this command for
    the affected rooms.
SYSOP STATUS <character-id>
    This command allows you to view the status of the requested user 
    if they are currently playing MajorMUD.

The MAP command will display a generated map of your current area.  Note
that as you move from room to room this map may change dramatically - it
is only there as a quick check to give you a rough idea as to what the
current area looks like.  Note also that as this function is a recursive
function, it has caused a stack overflow on one or two occasions.  I have
since modified this routine to only recurse a few times (and have not had
any problems with this command here) but I would still like to warn you
of the potential problem with the use of this command.
    
The GOD command has the following variations:
SYSOP GOD <character-id> INVENTORY
    This command will allow you to view the Inventory of the given user
SYSOP GOD <character-id> ADD LIFE
    This command will allow you to add a single life to the given user.
    This can be used if you feel a user was killed unjustly.  Note that
    this will not allow the number of lives remaining to exceed 9.
SYSOP GOD <character-id> ADD EVIL <amount>
    Using this command you can either make a user more or less evil.  A
    positive amount will make them more evil, a negative amount will make
    them less evil.  You can use the SYSOP LIST USERS command to view
    their current number of evil points.
SYSOP GOD <character-id> CLEAR SUICIDE
    If a user forgets their suicide password, you can clear it using this
    command.  Obviously, you wouldn't want to clear their suicide password
    until you confirm that it is indeed the actual user who is asking and
    not someone who has hacked into their account (or a not-so-friend who
    is borrowing the account)
SYSOP GOD <character-id> SPEAK <message>
    This command will send a message to the target user in the style of
    The gods tell you: <message>
SYSOP GOD <character-id> CHANGE NAME <new-character-id>
    If a user has chosen a name which you find offensive, or which conflicts
    with another user (by being 'similar') then you may use this command
    to change their name to something else.  Be very careful when using
    this command because it really hasn't been tested too much.

The LIST command has the following variations:
SYSOP LIST USERS
    This command will give you a list of all of the users currently in
    the game and will provide information such as their userid and their
    current room number.  If a user is reporting problems in a given room,
    then you may be asked to use this command to provide us with the
    exact room number in which the problem is occurring.
SYSOP LIST EVIL
    This command is very similar to the list users command but will also
    include information related to any evil activities which have been
    performed recently.
SYSOP LIST GANG <gangname>
    This command will let you view a list of all of the members of any
    gang on your board.  You must type in the full name of the gang.

The REPORT command has not yet been implemented.

The LIGHTNING command can be used to simulate a lightning attack on a 
user of your choice (SYSOP LIGHTNING <character-id>).  This lightning
will look exactly like the lightning that is generated against FIENDS
at random intervals.

The DISBAND command can be used to disband any gangs which have offensive
names.  Using this command will remove the gang from the TOPTEN list (if
it was there) and will inform each user that their gang has been disbanded
as they login.  Usage: SYSOP DISBAND <gangname>


Appendix A - Resetting your game 

To successfully reset your board, you must follow these steps:
1) Copy WCCUSERS.VIR to WCCUSERS.DAT
2) Copy WCCGANGS.VIR to WCCGANGS.DAT
3) Copy WCCBANKS.VIR to WCCBANKS.DAT
4) Run the BBS and choose C for Clear all saved evil points on the sysop menu
5) Choose R for reindex the limited items on the sysop menu.
