MW2:Mercs TXT2MEK 1.0 by NdR (ender@annex.com) for NAIS

        Come to the NAIS homepage at http://nais.annex.com/ for more toys!
---------------------------------------------------------------------------

TXT2MEK is a simple way to import mechs into MW2:Mercs.  This lets you edit
mechs in any text editor, so it's easier to move weapons around.  Better
yet, TXT2MEK automatically places Endo-Steel and Ferro-Fibrous criticals
for you, and can also automatically distribute or maximize armor.

TXT2MEK commands always start with '+' or '!'.  You can make comments by
starting a line with '#' or ';' (TXT2MEK ignores lines like that).

To turn your text file (say, jnr00usr.txt) into a mech, type:
        TXT2MEK jnr00usr.txt

If there are no errors, TXT2MEK will create a MEK file with the same name
as your text file, and will print how many tons and criticals you have left.
(If there ARE errors, TXT2MEK won't create the MEK file until you fix them.
It won't let you create hacked/illegal mechs.)

---------------------------------------------------------------------------

Use the following commands to define the basic mech:
        !NAME mechname           Name of your mech (up to 23 characters)
        !TONS nnn                Tonnage of the mech (1-100)
        !TYPE [IS | CLAN]        Type of mech (Inner Sphere or Clan)

Some mechs don't have lower arm or hand criticals.  Use !NOCRIT to remove
those criticals: (one !NOCRIT per critical you want to remove)
        !NOCRIT [R.HAND | R.ARM | L.HAND | L.ARM]

Use one of these to determine the mech's speed:
        !ENGINE nnn [XL]         Engine rating (1-400, add XL for XL engine)
        !WALK mmm [XL]           Walking movement points (1-20) - this times
                                 TONS is your engine rating

You can use the following upgrades:
        !UPGRADE DSHS            Double-strength heatsinks
        !UPGRADE ENDO            Endo-steel internal structure
        !UPGRADE FERRO           Ferro-fibrous armor

If you want TXT2MEK to automatically place armor on your mech:
        !ARMOR nnn               Places nnn tons of armor on mech (0.5-20)
        !ARMOR MAX               Places the maximum amount of armor

---------------------------------------------------------------------------

All equipment commands start with '+' and a location for the equipment:
        +HD    +RT    +CT    +LT    +RA    +LA    +RL    +LL

To place armor (this overrides the !ARMOR command), use:
        +loc ARMOR nnn[/mmm]     Places nnn points of armor on the location
                                 For RT/CT/LT, mmm is rear armor

You can place jumpjets, heatsinks, or MASC with:
        +loc JUMPJET             Places a jumpjet (torsos and legs only)
        +loc HEATSINK            Places a heatsink at the location
        +loc MASC                Places MASC at the location

You can place weapons and ammo with:
        +loc [weapon]            Places the weapon at the location
        +loc [weapon] AMMO       Places a ton of ammo at the location

(for example, the following would place an AC20 and ammo in the left torso:)
        +LT AC20
        +LT AC20 AMMO

---------------------------------------------------------------------------

Clan weapons:
        cLRM20      cLRM15      cLRM10      cLRM5       cSRM6       cSRM4   
        cSRM2       cSSRM6      cSSRM4      cSSRM2      cMGun       cGAUSS  
        cLBAC2      cLBAC5      cLBAC10     cLBAC20     cuAC2       cuAC5   
        cuAC10      cuAC20      cFLAMER     cerPPC      cerLLAS     cerMLAS 
        cerSLAS     cLPLAS      cMPLAS      cSPLAS      cNARC       cAMS    
        cInfSRM     cInfSSRM    cArrowIV

Inner sphere weapons:
        LRM20       LRM15       LRM10       LRM5        SRM6        SRM4    
        SRM2        SSRM2       MGun        GAUSS       AC2         AC5     
        AC10        AC20        uAC5        LBAC10      FLAMER      erPPC   
        PPC         erLLAS      LLAS        MLAS        SLAS        LPLAS   
        MPLAS       SPLAS       NARC        AMS         InfSRM      InfSSRM 
        ArrowIV 

Note that you can't mix IS and CLAN weapons, and there are NO NUKES...

---------------------------------------------------------------------------

;This is an example 30-ton 3050 mech.  Copy this into jav00usr.txt and run
;TXT2MEK JAV00USR.TXT and you'll have a speedy little pulse laser carrier.

!NAME Zippy-XL
!TYPE IS
!TONS 30
!ENGINE 210XL
!UPGRADE ENDO
!UPGRADE FERRO
!UPGRADE DSHS
!ARMOR MAX

+RT LPLAS
+LT Heat Sink
+LT SPLAS
+HD SPLAS
+CT Jumpjet
+CT Jumpjet
+RL Jumpjet
+LL Jumpjet

(Press 1=basics, 2=commands, 3=equipment, 4=weapons list, 5=example, X=exit)
