<img src="//kyau.net/img/icons-misc/mmud48.png"> MajorMUD - Documentation

From Wiki³
Revision as of 20:41, 18 March 2019 by Kyau (talk | contribs)
IconThe VOID BBS is up and running!

The documentation and configuration files for MajorMUD are sometimes confusing and archaic, for this I have created this section. Hopefully this will relieve the stress from figuring out what is what.

General

  • WCCMMPLS.DOC: MajorMUD Plus! Entertainment Edition Documentation — contains information on what comes with plus.
  • WCCMMUD.DOC: MajorMUD User Documentation — contains information on character creation, commands and customizing the mud environment.
  • WCCMMUD.LIC: MajorMUD License — contains the limited warranty and license
  • WCCMMUD.NOT: MajorMUD Release Notes — contains the user changelog from Version 0.1e to current (1.11p).

Sysop

  • WCCMMPLS.REL: MajorMUD Plus! Entertainment Edition Readme — contains information on installation, configuration and sysop functions.
  • WCCMMSYS.NOT: MajorMUD Sysop Functions — contains information on the sysop menu and in-game commands.
  • WCCMMSYS.REL: MajorMUD Sysop-Only Release Notes — contains the sysop-only changelog from Version 1.1n to current (1.11p).
  • WCCMMUD.RLN: MajorMUD Readme — contains information on installation, configuration and troubleshooting.

Configuration

  • WCCMMUD.INI: MajorMUD Sysop Command Config — contains general, logging and sysop command settings.

Tweaks

Hex Edits

If you wish to do editing of your MUD it is highly recommended that you apply the following patches.

Use Hex Workshop or equivalent in order to make the following changes.

List of Edits

Offset Change From Change To Notes
000019F3 CO 5D F4 BF Increased Monster Records? #1
0001475B E8 C67A 0500 90 9090 9090 Increased Class Records
00014777 E8 907A 0500 90 9090 9090 Increased Map Records
00014814 66C7 8473 3A07 0000 0000 9090 9090 9090 9090 9090 Increased Abilities/Spells #1
000148BE 66C7 8473 3A07 0000 0000 9090 9090 9090 9090 9090 Increased Abilities/Spells #2
000149B0 66C7 8473 3A07 0000 0000 9090 9090 9090 9090 9090 Increased Abilities/Spells #3
0001561E E800 EDFF FF 9090 9090 90 Fix for Increased Records
00015794 74 EB Increased Race Records
00018290 0F85 FC02 E9FD 0200 MajorMUD Addon Crack #1
0002F57E C800 FF7F Increased Shop Records #1
000392D8 41 4F "(Two handed)" changes to "(Weapon Hand)"
0004E789 53 50 MajorMUD 256-User Crack #1
0004E79C 0400 0001 MajorMUD 256-User Crack #2
0004E9B4 75 EB MajorMUD Addon Crack #2
0004E9BA FF75 08 9090 50 MajorMUD Addon Crack #3
0005AE3D E8 0300 EC FF09 Increased Shop Records #2
0005AEBD E8 0300 EC FF09 Increased Shop Records #3
0005AED5 E8 0300 EC FF09 Increased Shop Records #4
0005B01D D0 07 FF 7F Increased Shop Records #5 (Restocking)
0005F879 D0 07 FF 0F Increased Monster Records #2
000649EA E856 FAFC FF 9090 9090 90 SYS LIST NEWLIMITED call
0006D639 66 C784 433A 0700 0000 00 90 9090 9090 9090 9090 90 Smash, PerStealth, and Meditate Fixes #1
0006D6E3 66 C784 433A 0700 0000 00 90 9090 9090 9090 9090 90 Smash, PerStealth, and Meditate Fixes #2
0006D7D5 66 C784 433A 0700 0000 00 90 9090 9090 9090 9090 90 Smash, PerStealth, and Meditate Fixes #3
0007C02F 64 6973 636F 6E6E 6563 7465 6421 2121 0D 68 756E 6720 7570 2121 210D 0000 0000 00 "just disconnected!!!" changes to "just hung up!!!"
0008FD9F 45 4449 5445 44 53 5953 4F50 00 Changes EDITED to SYSOP
0008BCC5 6C 616E 6365 77 6172 657A Changes SYS LANCE to SYS WAREZ}}

Codec of Twinks

The codec of twinks is a hidden Sysop option in the WCCMMUD.INI configuration file. With this option enabled you will have access to an additional array of Sysop commands.

To enable this option edit or create the file WCCMMUD.INI in your main BBS folder (C:\WGSERV). Add the line for the codec of twinks as follows then save and restart your BBS.

CODEC_OF_TWINKS=78

Additional Commands

This is the complete list of additional commands that are added by the codec of twinks.

  • Summon monsters, items or spells to your current location.
    SYS SUMMON <monster number>, SYS SUMMON <item>, SYS SUMMON <spell>
  • Teleport to any map and room in the game.
    SYS E <room#> <map#>
  • List a users Quest Flags (ie. what they have completed).
    SYS GOD <character> ABILITIES
  • Tweak the statistics of everyone simultaneously, or reset all edits to this.
    SYS TWEAK and SYS EDIT CLEAR

There are also commands that require you to be located in a certain room in order for them to work, these include the invasions and the alignment and high level spell stuff.

Room #238 Map #1

From this room you can use the following commands. They do not need to be proceeded by SYS, just issue the commands.

  • EXPME : gives experience points
  • GOODRING : gives you the good alignment quest ring
  • NEUTRING : gives you the neutral alignment quest ring
  • EVILRING : gives you the evil alignment quest ring
  • GOOD[1-5] / NEUT[1-5] / EVIL[1-5] : gives you complete flags for alignment quests at the level you assign
  • LEARN SPELL : gives you the spells: Eye of Magnus, Bigheal, Combat Fury, Death Gaze, Glove of Invulnerability, Judgement of Doom, Negate Magic, Sphere of Isolation (must be a caster class in order to get these)

Support Chamber

From the support chamber you can now start monster invasions, which can be summoned at max once per day. Again there is no need to proceed the command with SYS as long as you are in the Support Chamber.

  • ORC INVASION
  • RED INVASION
  • CULT INVASION
  • GREEN INVASION
  • DUERGAR INVASION
  • SARACEN INVASION

Resetting MajorMUD

If you do not understand the difference between these two options and you just know that you want a complete 'MajorMUD reset' then take a full backup of your system and do Option #2 (Full Reset).

Option #1 (Partial Reset)

If you wish to reset all of the users on your board while maintaining the current map environment, you must follow these steps.

* Note: Only choose this option if you *KNOW WHAT YOU ARE DOING* and know that you want it reset in this manner.

  1. Copy WCCUSERS.VIR to WCCUSERS.DAT
  2. Copy WCCGANGS.VIR to WCCGANGS.DAT
  3. Copy WCCBANKS.VIR to WCCBANKS.DAT
  4. Refer to appendix A.1 in this document and follow those instructions now if applicable to you (i.e. if you own MajorMUD Plus).
  5. Run the BBS and IMMEDIATELY choose C for Clear all saved evil points on the sysop menu.
    * Note: This must be done prior to anyone creating new characters.
  6. Immediately following C, choose CP to clear all the saved profile information.
    * Note: This must also be done prior to anyone creating new characters.
  7. Choose R to re-index the limited items from the sysop menu.

Option #2 (Full Reset)

If you wish to completely reset and start from scratch, follow these steps:

  1. Before you shutdown your BBS for the last time prior to the reset, choose C for Clear all saved evil points on the MajorMUD sysop menu.
  2. Immediately following C, choose CP to clear all the saved profile information.
  3. Shutdown the BBS
  4. Refer to appendix A.1 in this document and follow those instructions now if applicable to you (i.e. if you own MajorMUD Plus).
  5. Keep a backup copy of your WCCADDON.SYS file if you own any MajorMUD addons
  6. If you created a WCCMMUD.INI file, take a backup of this file now
  7. Write down any custom settings you may have done in your CNF options
  8. Delete all the WCC files from your Worldgroup directory (DEL WCC*.*)
    * Note: If you are running any other WCC Products (currently only WCC Line Control is available) please contact Metropolis for information on which files to NOT delete.
    * Note: If you received a new WCCDMA.SYS file (for running on a DMA server) after the latest version was released, make sure you save this file to restore it after re-installing.
  9. Re-install the latest version of MajorMUD using the appropriate methods and apply any newer patches
  10. Modify your CNF options as appropriate (refer to what you wrote down in step 7)
  11. If you took a backup of your WCCADDON.SYS file, copy it into your BBS directory now.
  12. If you took a backup of your WCCMMUD.INI file, copy it into your BBS directory now.
  13. Run the BBS and IMMEDIATELY choose C for Clear all saved evil points on the sysop menu.
    *Note: This must be done prior to anyone creating new characters.
  14. Immediately following C, choose CP to clear all the saved profile information.
    *Note: This must also be done prior to anyone creating new characters.
  15. Apply all appropriate database patches

Resetting MajorMUD Plus - Entertainment Edition

If you own MajorMUD Plus - Entertainment Edition and you are resetting your MajorMUD game then you most likely want to reset the MajorMUD plus registries and descriptions.

Do this with the clear plus data option in the MajorMUD offline utilities (refer to the MajorMUD Plus release notes - WCCMMPLS.REL - for more information)

Multiple MUDs

This method converts your currently installed MUD to new call letters (i.e. WCC to WBB) and then allows you to install a second MUD using the standard SETUP.EXE.

If you don't have a currently installed MUD, install it normally and test it out and then come back to this.

* Note: Backup your whole C:\WGSERV directory somewhere just in case something goes wrong.

Renaming

  1. Disable the MajorMUD and MajorMUD Plus modules through the offline utils menu (WGSDMOD.EXE)
  2. Locate your Worldgroup directory in Command Line mode (what used to be MS-DOS), typically CD C:\WGSERV
  3. Run COPY WCC*.* WBB*.*
  4. Run DEL WCC*.*
  5. Go into the WGSDFCVT sub-directory, CD WGSDFCVT and repeat steps 3 & 4
  6. Go into the GCVIRDAT sub-directory, CD GCVIRDAT and repeat steps 3 & 4
  7. Exit Command Line mode

Hex Editing

* The .MDF file's are renamed to .DMD when they are disabled, and vice versa.
Filename Filename Filename
WBBMMHLP.h wbbmmud.dmd or wbbmmud.mdf* WGSDFCVT\WBBTEXT.CV_
wbbmmpls.dll WBBMMUD.h WGSDFCVT\WBBGEN4.CV_
wbbmmpls.dmd or wbbmmpls.mdf* WBBMMUD.mcv WGSDFCVT\WBBGEN3.CV_
WBBMMPLS.h WBBMMUD.msg WGSDFCVT\WBBGEN2.CV_
WBBMMPLS.mcv WBBMMUD.UIC WGSDFCVT\WBBGEN1.CV_
WBBMMPLS.msg wbbmmutl.exe
wbbmmud.dll WBBTEXT.h

This process needs to be done for the entire list of files to the right one at a time.

  1. Open the file in the hex editor
  2. Initiate a "replace" operation (usually Edit --> Replace)
  3. Make sure that you have "Match Case" enabled/selected.
    Also make sure you're searching for "Text" or "Strings"
  4. Search for WCC and replace with WBB (replace All when it asks)
  5. Search for wcc and replace with wbb (replace All when it asks)
  6. Save and Close

Finalizing

  1. Change the module name.
    1. Edit the file WBBMMUD.DMD with Notepad.
    2. Change Module Name: MajorMUD to something different.
      Example: Module Name: CrazyMUD
      Do the same for the other line below:
      Add-On Utility: WBBMMUTL -- MajorMUD Utilities => Add-On Utility: WBBMMUTL -- CrazyMUD Utilities
    3. Do the same for "WBBMMPLS.DMD".
      * Note: if you still have MajorMUD as an enabled module you would need to edit the .MDF files as opposed to .DMD.
  2. Re-Enable the modules from the Offline Util., they should now show up with your new module name
  3. Fix/Add the page in the Menu Editor (WGSRUNMT.EXE), since it will have the wrong module name now.
  4. You may want to go into the Security and Accouting for MajorMUD and MajorMUD Plus and check the key names. Hex editing most likely changed the keys for things like gameop and sysop from WCCGAMEOP to WBBGAMEOP. Though, you probably want it this way, and then just add the new keys to whichever classes.
  5. Use NMR to change all the references in the rooms database for WCC files to WBB files. this is under tools --> rooms --> change dat call letters (NMR v1.4 required)
  6. Run an Offline Recovery
  7. Test out the Realm (best to test with your lines closed for the first time).
    Gain some EXP with a character and Exit and Re-Enter the Realm.

* Note: After writing this tutorial Worldgroup did crash on me the first time I gained EXP with a character. After I restarted Worldgroup back up though it was fine from then on.

You can install another instance of MajorMUD by using the setup like it was a fresh install on a BBS without MajorMUD.

Other Options

You may also want to change the name that appears next to things in the Audit Trail.

  1. Open up wbbmmud.dll and wbbmmpls.dll in a Hex Editor
  2. Replace all instances of MajorMUD with CustmMUD or w/e you want.
    The only tricky part here is you can't change the length of the text MajorMUD.
    Therefore you must replace the letters letter for letter (aka your custom name *must* be no longer and no shorter then 8 characters).[1]

References

  1. ^ How to setup multiple MUDs - by Syntax

MajorMUD is Copyright © 2018 Metropolis, Inc. and is not affiliated with this site.