                       =======================
                            DM2CONV v1.0
                         by Vincenzo Alcamo
                       =======================


This tiny program converts DOOM levels for use with DOOM II.
The texture remapping is enabled with the /TEXTURE switch: this switch is
required if you use the original copy of DOOM II (see TEXTURE REMAPPING).


** AN OPTIONAL CAPABILITY OF DM2CONV IS TO REPLACE THINGS **
------------------------------------------------------------
Suppose you want to play SNIPER.WAD with the Super Shotgun: what to do?
Simply run the following command:
   DM2CONV SNIPER SNIPER2 SHOTGUN=SUPERSHOTGUN /TEXTURE
and every shotgun is magically changed into a Super shotgun!!

In the same manner you can add DOOM II's new monsters:
   DM2CONV SNIPER SNIPER2 SERGEANT=REVENANT@5% /TEXTURE
and a 5% of seargents will become Revenant.

This version doesn't support difficulty levels: it is possible, with a
monster substitution (ex: TROOPER=MANCUBUS@1), to change an object that
will appear only in IMTYTD (I'M TOO YOUNG TO DIE) level, making the
game too much difficult than was intended to be.
I apologize for this, but REAL doomers plays only in ULTRAVIOLENCE mode!


** TEXTURE REMAPPING **
-----------------------
Texture remapping is enabled with the /TEXTURE switch.
It works by reading the SIDEDEFS portion of a level and look for
any texture name that DOOM2 doesn't support and replace that with
another texture.
Texture remapping is smart: textures are replaced with similar ones.

Remapping is *required* if you use the wads with an original copy of DOOM2.
Otherwise, you can use the DM2MKWAD utility to build DM2CONV.WAD, a patch
wad file containing all the missing textures.
Execute DM2MKWAD and read the instructions: no data will be changed!


=== PLEASE, READ THE FOLLOWING PARAGRAPH =====================================

The programs DM2CONV and DM2MKWAD are PUBLIC DOMAIN.
The source for DM2CONV is PUBLIC DOMAIN.
The source for DM2MKWAD is PUBLIC DOMAIN and is available from the author.
You can freely distribute this program in any form.

For comments, bug reports, suggestions, etc.. please contact the author:

  snail-mail:
    Vincenzo Alcamo
    via Verdi 185
    40059 Medicina (BO)
    ITALY

  e-mail:
    alcamo@arci01.bo.cnr.it

=== THE FOLLOWING TEXT IS EMBEDDED INTO THE EXECUTABLE ======================

DM2CONV v1.0 by Vincenzo Alcamo (alcamo@arci01.bo.cnr.it)
Converts DOOM maps for use with DOOM2.

DM2CONV <input_wad> [output_wad] [/mapnum] [/SEED[=num]] [/DEBUG] [/NOCHECK]
        [replacements].. [/LIST] [/MORE] [/IGNORE] [/TEXTURE] [@response]..

input_wad    name of DOOM wad file to convert ** REQUIRED **
output_wad   name of output file (if omitted, the input file is overwritten)
/mapnum      number for the first level remapped (default: 1)
/SEED[=num]  random generator seed (default: 0, randomize if num is omitted)
/DEBUG       display debug information
/NOCHECK     allow the use of object numbers not in list
/LIST        display the list of known objects
/IGNORE      make replacements even if no level is remapped
/MORE        display replacements examples
/TEXTURE     convert texture names
@response    response file (text file with additional arguments)

REPLACEMENT is an expression specifying object substitution:
  {source}={dest[@num]}
source is the initial object, dest is the final object,
num is the number of substitutions (absolute or percentual)


Replacement expression examples:

DEM=IMP             all Demons become Imps
DEM,IMP=LOS         all Demons and Imps become Lost Souls
DEM=IMP@5           5 Demons become Imps
DEM=IMP@50%         50% of Demons become Imps
DEM=IMP@5,SER       5 Demons become Imps, the rest are Sergeants
DEM=IMP DEM=TRO     No Demons remain for the second expression

Requests greater than available objects are adjusted proportionally:
DEM=IMP@5,TRO@15    If Demons are 9 -> IMP@25%,TRO@75%

You can substitute the % sign with #,$,& whichever you prefer.


LIST OF KNOWN OBJECTS

2007 AMM Ammo Clip          65 CHD Chaingun Dude      83 MEG Megasphere
  68 ARA Arachnotron      2005 CHS Chainsaw           71 PAI Pain Elemental
  64 ARC Archvile         2026 COM Computer Map     2004 PLA Plasma Gun
2015 ARM Armor Helmet       16 CYB Cyberdemon       2025 RAD Radiation Suit
   8 BAC Backpack         3002 DEM Demon            2010 RCK Rocket
2048 BAM Box of Ammo      2047 ENC Energy Cell        66 REV Revenant
2035 BAR Barrel             17 ENP Energy Pack      2003 ROC Rocket Launcher
2023 BER Berserk          2018 GRE Green Armor         9 SER Sergeant
2006 BFG BFG9000          2014 HEA Health Potion    2008 SHE Shells
2024 BLR Blur Sphere        69 HEL Hell Knight      2001 SHO Shotgun
2019 BLU Blue Armor       3001 IMP Imp              2013 SOU Soul Sphere
3003 BOH Baron of Hell    2022 INV Invulnerability    58 SPE Spectre
2046 BRO Box of Rockets     72 KEN Commander Keen      7 SPI Spiderdemon
2049 BSH Box of Shells    2045 LIG Light Goggles      82 SSH Super Shotgun
  70 BUR Burning Barrel   3006 LOS Lost Soul          84 SSN SS Nazi
3005 CAC Cacodemon          67 MAN Mancubus         2011 STI Stimpack
2002 CHA Chaingun         2012 MED Medikit          3004 TRO Trooper

You can specify an object by its number, its shortname, its name
or even an initial fragment of its name.
