Originally Posted by readme

-- HW2 Map Converter v0.85
-- Created: 09/20/05 by Mikail
-- Last updated: 04/25/06
-- Download:
-- http://www.geocities.com/Area51/Qua...4/homeworld.htm
-- Homepage:
-- http://www.geocities.com/Area51/Qua...4/homeworld.htm
-- Discussion:
-- http://forums.relicnews.com/showthread.php?t=73533


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


INTRODUCTION
This is a map converter for converting Homeworld levels to work
with Homeworld 2's HW Classic Mod Rebalance.

INSTALLATION
1) Extract the contents of this archive into a folder on your
harddrive.
2) Copy the "data" folder to your "Homeworld2" folder.
3) Add the "-overrideBigFile" switch to the target line of your
Homeworld 2 shortcut.

Note: all players must possess the same files in their "data"
folder in order to play against each other over multiplayer
using maps converted by this converter.
Note: Windows Scripting Host v5.6 must also be installed in
order for this program to work.
Note: HW Classic Mod Reblance must also be installed in order
to properly use these maps.

INSTRUCTIONS
There are two ways in which you can use this program:

1) You can drag & drop a single level file onto the JS file, in
which case a new file will be created with the same name
name and in the same directory as the input file, but with
an additional "HW1_" prefix added to the beginning of the
filename.

2) You can run the program from the command-line. The command-
line syntax is as follows:

cscript [script] [Input File] [[Output File]] [[-debug]]
[[-incFunctions]] [[-incVariables]]

Where:
[script] is the full path to "HW2_MapConverter.js".

[Input File] is the full path to the HW1 level you wish
to convert.

[Output File] is the full path to the destination file.
If [Output File] is omitted, then a new file will be
generated with the same name and in the same directory
as the input file, but with an additional "HW1_" prefix.

[-debug] generates and additional file in the same
directory as "HW2_MapConverter.js" that is helpful in
debugging.

[-incFunctions] causes the map-processing functions to
be included using the "dofilepath" function instead of
being added to the end of the outputted level file (the
default).

[-incVariables] causes the map-tweaking variables to be
included using the "dofilepath" function instead of
being added to the end of the outputted level file (the
default).

ADVANCED OPTIONS
If you look in the outputted level file, you'll find a section
called "Map-Tweaking Variables". The variables in this section
make it possible to change basic characteristics of the map
without having to rerun it through the converter.

RUMulti
(default: 4)
Multiplier affecting the density of resources: larger
values mean fewer resources with more RUs (makes HW2
less laggy). By changing this value you can decrease
the number of asteroids and increase their respective
RU values, thereby making large maps less leggy in HW2.
The default value of four (4) means that maps will have
four times fewer resources, but the resources will be
worth four times as much as usual. (Note: this is not
recommended for maps with small resource pockets due to
round-off errors.) 16 is a good value if the map is
still laggy at 4.

PebMulti
(default: 1)
Only every Nth missing asteroid will be converted into
a pebble. (Note: use this in conjunction with RUMulti.)

RUScale
(default: 2 * 700 / 575)
Is equal to HW2 frigate cost / HW1 frigate cost. (Note:
I then scaled this by an additional factor to
compensate for research/upgrade costs.)

MapScale
(default: 161 / 325)
Is equal to HW2 frigate speed / HW1 frigate speed. By
default, maps are scaled by a factor related to the
speeds of frigates in HW1 and HW2. To change this,
simply modify the value of the "MapScale" variable. The
default value is 161 / 325, or about 0.5. (Alternately,
one could use the meter/feet ratio:

1 meter = 3.280839895 feet (since HW2's units
are in meters, and HW1's units are in feet).

UniverseScale
(default: 1.2)
Increases the world bounds (the Sensors Manager pie-
plate) by an additional 20%, since they seem to be a
bit smaller, in HW2, in general.

MinSensorsZoomOverride
(default: 12000)
Overrides the map's minimum sensors zoom distance. To
use the map's original value, set this to equal -1.

MaxSensorsZoomOverride
(default: -1)
Overrides the map's maximum sensors zoom distance. To
use the map's original value, set this to equal -1.

AdvancedGameRule
(default: 0)
A sophisticated gamerule is necessary to spawn player-
owned ships. The default value of zero (false) means
that only the starting positions will be used. (Note:
don't turn this setting on if you don't have a gamerule
to take advantage of it)


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



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



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