Readme file for Momedit 2.2                       By The Source (Rick DiBlasi)
E-mail: rdiblasi@umabnet.ab.umd.edu
   WWW: http://cosyfish.ab.umd.edu/~rdiblasi/
==============================================================================

Introduction:

This is the final version of Momedit for DOS.  I have offically given up on
the Momedit project.  There may be a Win95 version of Momedit eventually, but
I cannot guarentee anything.

Some of this document may be sparse.  I put it together in a hurry, but you are
free to E-mail me with questions if you like.  

I hope you enjoy Momedit...I put a lot of work into it.

**************************  USE AT YOUR OWN RISK  ****************************
***                                                                        ***
*** 'Hacking' a saved game file can possibly have unwanted side effects.   ***
***  Basically it could screw up your current saved game, so be careful.   ***
***                                                                        ***
***  And DO NOT contact MicroProse if this cheat messes anything up!!!     ***
***  They had NOTHING to do with this cheat.  It is a personal project of  ***
***  mine.  Neither I nor MicroProse will be held reponsible for damage    ***
***  caused by the use of this program.                                    ***
***                                                                        ***
***  This cheat could erase your hard drive, melt your monitor, and kill   ***
***  people for pleasure and I still am not responsible. If you do not     ***
***  agree to these terms, delete Momedit now, and never use it!           ***
***                                                                        ***
******************************************************************************

Sorry didn't mean to scare you.   I have tested this program rigorously, but
bugs can still creep up now and then so consider yourself warned.

------------------------------------------------------------------------------
                             W H A T 'S    N E W
------------------------------------------------------------------------------
 
Version 2.2:

- Added a hero editor which contains:
  - Hero name
  - Hero type (ie: The Unknown, The Necromancer, etc)
  - Experience Points
  - Damage
  - Type of Weapon (ie: magical, adamantium)
  - Hero position (X,Y Coordinates and plane)
- Changing Wizard Names and Casting Skill
- Changing City Names, Race, and Location (X,Y Coordinates and plane)
  (When cities are moved, fortress and summoning circle are moved with it if 
  present.) 
- Editing number of spell books
- Turning on and off global enchantments
- Fixed some minor internal bugs

Note--> Complete version history is at the end of this document.

Known Bugs:

- In the Info window, the commas in the free disk space number may be off.
- Not really a bug, but:  If you change the hero type, the type of items he/she
  can carry is not changed.

------------------------------------------------------------------------------
                           I N S T R U C T I O N S
------------------------------------------------------------------------------
Before you begin:

Copy momedit2.exe into your Master of Magic directory (usually c:\magic).
It will not run from any other directory.  Typing 'momedit2 /?' will display
a list of Momedit2's command line parameters.

About the mouse:

When using the mouse clicking the LEFT BUTTON is just like hitting ENTER and
clicking the RIGHT BUTTON is just like hitting ESCAPE.  The instructions below
assume you are using the keyboard, but the LEFT and RIGHT mouse buttons can be
used in place of ENTER and ESCAPE respectively.  Also you can LEFT click on the
top of screen to access these functions:
                LEFT click on 'F5=Info' for the info screen
                LEFT click on 'F12=Quit' to exit without saving changes

Every menu:

The ARROW keys move the red selection box.  Hitting ENTER will select whatever 
is under the red box.  ESCAPE will exit to the previous menu, except at the 
first menu which will exit the program.  If any changes were made in a window,
a dialog box will appear asking if you want to save your changes.  Hit Y if you
want to save or N if you don't.  If no changes were made, this box will not 
appear.  Hit F5 to display the small information window.  Also, for a "quick
exit" without saving hit F10 or F12.

File pick menu:

A list of your saved games will appear.  The choice that reads "LAST GAME", is
the file MOM uses when you choose CONTINUE from the main menu.  When you choose
a saved game file, Momedit2 will create a backup of the file with a .bak 
extension.  MOM names it's saved games save1.gam through save9.gam, so the 
backups will be labeled save1.bak through save9.bak.  If you do not want 
momedit2 to create backup files, use the /x command line parameter.  

Note--> If you have saved games from an old version of MOM and then upgraded
        to a newer version without deleting the old files, it is possible that
        Momedit2 will see these old files without them showing up in MOM.  It
        is not a bug; I just didn't feel like doing the extra coding to hide
        them.  If it bothers you to see them in Momedit2's file listing than
        delete them...no big deal.  :)
        Version 1.2 and above have file sizes of 123,300.  I don't remember
        what the size of the older files were, but they were a little smaller.


Wizard menu:

This is a list of the wizards in your saved game.  If a wizard is defeated, 
"<defeated>" will appear instead of his/her name.  Your wizard is always the
first one in the list and has "(YOU)" printed next to the name.  Once you pick
a wizard his/her name will appear in the upper right corner of the screen.  If
you choose your wizard, "YOU" will be printed instead of the wizards name.

Spell book window:

The spell book is divided into the 6 different types of magic: nature, sorcery,
chaos, life, death, and arcane.  Use the SPACEBAR or ENTER key to toggle the
choices.  These choice are YES, NO, MAYBE.  You can also use the Y, N, and M 
keys.  Yes means that the spell is currently in your spell book.  No means that
the spell is not in your book and you can never research it.  Maybe means it is
not in your spell book, but it could be aquired by researching eventually.

Note-->  I do not know if the game has a limit on the number of spells you can
         have at one time.  You can experiment on your own.

Global Enchantment:

Use the SPACEBAR or ENTER to scoll through YES or NO.  You cannot use Y and N
to change values like you can in other menus.  (Yea, I know its inconsistant
with rest of the program...sue me.  :)

Note -->  Some enhantments do not have the correct effect when turned on from
          this menu.  (ie:  awareness will not display the cities)

Cities menu:

A list of all cities controlled by the current wizard are shown here.  The list
can scroll up or down if there are more cities than can fit in the window at 
once. This editor does not allow you to change ownership of a city.

City building window:

The name of the current city appears in the window title.  Use the SPACEBAR or
ENTER key to toggle the choices. These choices are YES, NO, REPLACED. You can
also use the Y, N, and R keys.  Yes means the city has the building and it will
appear in the city window in the game.  No means the building has not been 
built.  Replaced is a special term used by the game.  The building is in the
city, but is does not appear in the city window.  As an example, when the game
places a fantasic stable in a city, it "replaces" the old stable.  If too many
buildings appear in the city window, the game slows down when the window is
open.

City Enchantment window:

All of the possible enchantments that can be put on a city are here.  Use the 
SPACEBAR or ENTER key to toggle the choices.  The name of the casting wizard
will appear next to the spell or NO if the enchantment is not cast.  Use the N
key to turn off an enchantment and use Y to turn on the enchantment with you
being the casting wizard.  Use can also use the 1, 2, 3, 4, and 5 keys where 1
is you and 2 is the first enemy wizard.  If a wizard is defeated, he/she will
not be allowed to cast an enchantment.  If you make an enemy wizard cast an
enchantment, it is possible that the wizard (the computer AI) will turn it off
at any time.

City Info:

The population has to be between 1,000 and 30,000.  If you type a value not in
this range, 30,000 will be substituted.  Normally the game only allows a
maximum population of 25,000, but 30,000 works fine.  Everything else should be
self explanatory.

Note -->  Be careful when you move your city.  You don't want to place it on
          top of another city or on the water.
          
Special Abilities:

Listed in this menu are all of the special abilities that your wizard can have.
SPACEBAR and ENTER toggle the abilities to YES or NO.  You can also hit Y for
YES and N for NO.

Note -->  Be careful with the special abilities because some of them are
          contradicting...like Infernal Power and Divine power.

Hero Editing:

You can only edit a Hero if you hire one first.  You cannot just create on from
scratch.  In the listing of the hero types, I put the hero's normal name in
parentethis.

Note -->  Don't move your hero on top of the water if he/she can normally walk
          on water.  Also, changing the hero type does not change the types of
          items they can carry.

Wizard Info:

Use the UP ARROW and DOWN ARROW to navigate this menu.  Gold and mana are the 
amounts in your reserve and Fame is obviously the amount of fame you have.  The
casting total and casting remaining are a little different.  Casting remaining
refects the amount of mana you have to spend until the current spell is cast.
A value appears here only when you are casting a spell.  If you set this value
to 0, the spell will be cast on your next turn.  Casting total is useful only
when casting dispel spells.  The higher the number, the more powerful the
dispel.  There is only a value here when you are casting a spell.  Any other
time it's value is 0.  All of these values must be between 0 and 30,000.  If
the value you entered is not in this range, it will default to 30,000.

Casting skill can be 99,999,999.  The game does some sort of math arrive at the
actual value. 

Note-->  Be careful with the FAME value.  If it is too high when the game is
         over, it will go bananas!  What I normally do is to turn fame down
         to around 500 before I defeat the last wizard.  You can experiment
         with different values and find one that works best for you.


------------------------------------------------------------------------------
                    A S O R T E D   I N F O R M A T I O N 
------------------------------------------------------------------------------
/* Begin Personal Plee */

Also, since this is freeware, I am not asking for money.  But I am asking 
everyone who uses this to try and watch at least two episodes of Babylon 5.
It is one of my favorite shows and I definetly don't want it cancelled before
it's planned five year run.  I really think you will like it, but if not, at
least I tried.  If you want more information about Babylon 5 and you have 
internet access, the following info is for you:

Babylon 5 on the internet:
  WWW site: http://www.hyperion.com/lurk/lurker.html
  FTP site: ftp.hyperion.com
    Usenet: rec.arts.sf.tv.babylon5

/* End Personal Plee */

------------------------------------------------------------------------------
                  C O V E R   M Y   B U T T   S E C T I O N 
------------------------------------------------------------------------------

I assume NO responsiblity for the reliability of this program.  I will not be
held reponsible for any damages caused by this program or the use thereof.
                          ** USE AT YOUR OWN RISK **

------------------------------------------------------------------------------
                        V E R S I O N   H I S T O R Y
------------------------------------------------------------------------------

Version 2.2:

- Added a hero editor which contains:
  - Hero name
  - Hero type (ie: The Unknown, The Necromancer, etc)
  - Experience Points
  - Damage
  - Type of Weapon (ie: magical, adamantium)
  - Hero position (X,Y Coordinates and plane)
- Changing Wizard Names and Casting Skill
- Changing City Names, Race, and Location (X,Y Coordinates and plane)
  (When cities are moved, fortress and summoning circle are moved with it if 
  present.) 
- Editing number of spell books
- Fixed some minor internal bugs

Version 2.1:

- Added Mouse Support
- Editing Wizard Special Abilities
- Editing Fame
- Fixed some minor bugs

Version 2.0: (complete rewrite)

- Added colorful pop-up windows and selection bars
- Support for editing ANY wizard
- Gold, mana, casting remaining and total
- Add or remove known spells
- Add or remove city buildings, enchantments, population
- Added some new bugs...minor of course.  :)

Version 1.0 (Gold and Mana Multiplier)

- Could only edit YOUR gold and mana
  (This was very simple little cheat.)

------------------------------------------------------------------------------
                              T H E   E N D
------------------------------------------------------------------------------

Master of Magic (C)1995 Simtex Software 
Momedit and Momedit2 (C)1996 Richard A. DiBlasi

I hope you enjoy this program.  If not, hey, what do you want for free?  :)

EOF
