Andrew Brown's War in the Pacific Map Mod README file.
=====================================================
Version 2, 12th January 2005.

This file explains how to install and use my War in the Pacific map mod.
The mod is created to provide an alternative map for the computer game
War in the Pacific, which is developed by 2by3 Games and Matrix Games.

Description
===========
The map mod provides a completely new map for the game. The map cannot
be used with any scenario, unless the scenario is specially modified for
use with the map. Current games are also not able to use the new map. To
use the map a new game must be started using one of the specially
modified scenarios.

Two modified scenarios - scenarios 115 and 116, which are modified
versions of scenarios 15 and 16 respectively - are supplied with the
mod. Other modified scenarions will be made available as time permits. 

Compatibility
=============
The map mod, when loaded, can ONLY be used with scenarios that are
modified to use the map mod.

Installation
============
The map mod can be installed manually or automatically using an
installation utility.

Note: The automatic installation utility DOES NOT WORK with Windows 98
or earlier. If you are using such an OS, then you must install the mod
manually. This is because I could not figure out how to get the script
to work in Windows 98, at least not yet.

Before attempting either installation, please ensure that the War in the
Pacific game is NOT running.

Automatic Installation
----------------------
PLEASE NOTE: Although I have tested the automatic installation utility
on my PC, I can not be certain that it will work in all cases on all
operating systems. PLEASE let me know if you have ANY difficulty with
the utility.
 
To install the map mod automatically, do the following:

- Unzip the map mod zip file - WitP_Map_Mod_v2.zip - to any convenient
  location on your PC. It does not need to be unzipped in the location
  where the game is installed, but it can be. When unzipping the file,
  be sure to preserve the folder structure of the zip file, or the
  automatic installation will not work (in Winzip this means making sure
  that the 'Use folder names' checkbox is ticked).
  
- In the location where the file was unzipped, run the installation
  utility, which is called 'MapMod-Install' (MapMod-Install.bat). The
  utility can be run by double-clicking on it.
  
- The utility should automatically find where the War in the Pacific
  program is installed. It will then make a backup copy of the official
  game map so that it can be restored at any time you wish. If there is
  already a copy of the official map - made during the installation
  of the previous version of this mod - then this step is skipped.
  
- Next, the modified map will be copied to a permanent location, along
  with the documentation for the map mod, the modified scenarios and two
  utilities for loading and unloading the modified map from the game.
  
- You will then be prompted as to whether you wish to load the map into
  the game or not. If you do, the new map will be available when you
  next run the game. If you do not, the map can be loaded later using
  the map loading utility (see 'Loading the Modified Map' below).
  
- Once loaded, the map can be unloaded, and the original map restored,
  at any time by using the map unloading utility. Note that this does
  not uninstall the map mod, it simply overwrites the modified map with
  the original map so that the game can again be played with the
  original map.
  
- It is possible to swap between the original map and the modified map
  whenever you like by using the map load and map unload utilities.
  
Manual Installation
-------------------
To install the map manually, do the following:

1) Using Windows Explorer or equivalent, go to the location where the
   War in the Pacific game is installed, usually
   "C:\Program Files\Matrix Games\War in the Pacific\". In the rest of
   this instruction this will be called "[Game folder]".
  
2) If there is already a backup of the official map (in the folder
   "[Game folder]\ART\Maps_Official"), then it is not necessary to make
   another backup. Go to step 5, below.
   
   Otherwise, go to the "[Game folder]\ART" folder and create a new
   folder below the ART folder called "Maps_Official" (i.e.
   "[Game folder]\ART\Maps_Official". The name needs to be correct for
   the map load/unload utility to work.
  
3) Copy (NOT move) the following files from the "[Game folder]\ART"
   folder into the "[Game folder]\ART\_Maps_Original" folder:

   Jump Map 33.bmp
   MapRev1024.bmp
   MapRev800.bmp
   pickmap1024.bmp
   weathermap1024.bmp
   WITN00.bmp through to WITN19.bmp
   WITP00.bmp through to WITP19.bmp
  
4) Copy the PWhex.dat file from the [Game folder] to the
   "ART\Maps_Official" folder.
 
5) The easiest way to install all of the mod files is to unzip the zip
   file into the [Game folder] location. This will place most of the
   files for the mod in the right place, except for the two utilities
   that load and unload the modified map: 'MapMod-Load.bat' and
   'MapMod-Unload.bat'. These two files need to be moved from the 'Misc'
   folder to the [Game folder].
  
6) If you have unzipped the file somewhere else, move all of the folders
   from the zip file, and their contents, to [Game folder] making sure
   that you preserve the folder structure. After this, move the two
   utilities, 'MapMod-Load.bat' and 'MapMod-Unload.bat', from the 'Misc'
   folder to the [Game folder].
  
7) The list of files in the mod, and the locations they need to be
   placed is as follows:
  
   From the folder where the files were unzipped:
   READ_ME_Map_Mod_v2.txt - move to "[Game folder]"

   From the folder "Misc" (below the folder where the files were
   unzipped):  
   Misc\MapMod-Load.bat to "[Game folder]"
   Misc\MapMod-Unload.bat to "[Game folder]"
  
   From the folder "mapmod_docs" (below the folder where the files were
   unzipped):  
   mapmod_docs\*.* (all files) to "[Game folder]\mapmod_docs\"

   From the folder "ART" (below the folder where the files were
   unzipped):  
   ART\Maps_Modified_v2\*.* (all files) to
   "[Game folder]\ART\Maps_Modified_v2\"

   From the folder "SCEN" (below the folder where the files were
   unzipped):  
   SCEN\*.txt (all .txt files) to "[Game folder]\SCEN"
   SCEN\*.dat (all .dat files) to "[Game folder]\SCEN"
   SCEN\*.cmt to "[Game folder]\SCEN"
 
Loading the Modified Map
======================== 
Once the map mod files are installed, they are ready to be 'loaded' into
the game. This is done by running the 'MapMod-Load' utility which is
located in the [Game folder]. This does not need to be done again if the
option to load the modified map was accepted during automatic
installation - the modified map is already ready to use.

If the modified map is loaded, then the game needs to be restarted to be
able to use the map.

Restoring the Original Map
========================== 
The original map files can be restored at any time by running the
'MapMod-Unload' utility which is located in the [Game folder]. This does
not need to be done again if the option to load the modified map was
accepted during automatic installation - the modified map is already
ready to use.

If the modified map is loaded, then the game needs to be restarted to be
able to use the map. Note that this does not uninstall the map mod, it
simply overwrites the modified map with the original map so that the
game can again be played with the original map.

If the original map is restored, then the game needs to be restarted to
be able to use the map.

The two utilities can be used to easily swap between the original and
the modified game maps if you are playing different scenarios that make
use of the two different maps.

Uninstalling the Map Mod
========================
To uninstall the map mod, do the following:

- Run the 'MapMod-Unload' utility, which is located in the 
  [Game folder], to restore the original map files.
  
- To completely remove the map mod files, delete the following files:

  "[Game folder]\MapMod-Load.bat"
  "[Game folder]\MapMod-Unload.bat"
  "[Game folder]\READ_ME_Map_Mod_v2.txt"
  "[Game folder]\mapmod_docs\(all files)"
  "[Game folder]\ART\Maps_Modified_v2\(all files)"
  "[Game folder]\SCEN\scn115.cmt"
  "[Game folder]\SCEN\scn116.cmt"
  "[Game folder]\SCEN\*115.txt"
  "[Game folder]\SCEN\*116.txt"
  "[Game folder]\SCEN\*115.dat"
  "[Game folder]\SCEN\*116.dat"
  
Alternative Installation - Separate Game Installation
=====================================================
One alternative for using this mod is to install a second copy of the
game, then install this mod in the second copy. This has not been tested
using the automatic installation script, so please do this using the
manual method described above.

Map Mod Documentation
=====================
All of the documentation for the map mod is located in the
"[Game folder]\mapmod_docs\" folder. To read the documentation, open
the file "[Game folder]\mapmod_docs\Map_Mod_README.html" in a web
browser.

Alternative Maps
=====================
There are two maps supplied with this mod - a map without hexes and a
map with hexes, which replace both official maps of the same type. The
map with hexes is drawn with lighter coloured hexes for ocean areas.

There are also several alternative maps with hexes, as follows:

- A Map with "World in Flames" style ocean hex dots, plus hexside art
  indicating hexside type in places where the type is ambiguous.
  
- A map similar to the default one, plus hexside art indicating hexside
  type in places where the type is ambiguous.
  
- A map drawn with plain black hexsides throughout, as on the official
  map.

These packages can be downloaded and installed separately, although the
main map mod package must be installed for these alternative maps to be
used.

Fixes, Changes and Additions
============================
Version 2 includes the following fixes, changes and additions:
Fixes:

   1. Chandpur (hex 31,25) in India was defined as a Land hex, making it
      impossible for naval task forces to travel there. Fixed by making
      it a coastal hex.
   2. Clark Field (hex 43,51) in the Philippines was defined as a
      coastal hex, with the ability for naval task forces to travel
      there via Bataan. Fixed by making the hex a Land hex and
      specifying all bordering hexsides as Land only hexsides. This now
      matches the way that the Clark Field hex is defined on the
      official map.
   3. Tabar (hex 63,88) was defined as a deep ocean hex, and the base
      was not moved from its position on the official map, making the
      base unuseable. The hex has now been drawn in and defined as an
      Atoll, and the base has been moved to its correct place
      (basically, this base was missed completely).
   4. Some hexsides in Manchukuo were defined as Ocean hexsides instead
      of Land hexsids as they should have been. Fixed.
   5. Hex 21,14 in India had railway/highway defined as its transport
      link type instead of trail (for a cultivated hex). Fixed.
   6. Hex 63,43 in Japan had a railway/highway defined as its transport
      link type, but the hex was drawn as containing trails. The map art
      was changed from trails to railway/highway to match the map data.
   7. Okinawa hexes were defined as clear instead of mountains, as in
      the official map. Fixed.
   8. The railway to Darwin, in Australia (hex 36,84), did not extend
      into Darwin itself. Fixed
   9. The Deboyne Island base (hex 59,98) was not in its correct
      location. Fixed.
  10. Numerous minor fixes to hexsides and transport links.

Changes:

   1. The terrain type for Dacca (hex 32,24) in India has been changed
      from urban to cultivated (clear). Although it is heavily populated
      today it was MUCH smaller at the time of World War Two. In
      addition it is now flanked by rivers on five hexsides.
   2. Palk Strait, between Southern India and Ceylon, has been made
      impassable to Naval units. This shallow and treacherous strait is
      only navigable by small boats.
   3. Fort St. John in Canada (hex 131,27) has been moved one hex to the
      Northwest to place it on the correct side of the river, and to
      even out the distances on the air route that was used for ferrying
      aircraft to Alaska and the USSR.
   4. The Snake River in the USA was changed to a more correct alignment
      to make the inclusion of Boise easier.
   5. The amount of heavy industry and resources in Auckland, New
      Zealand, which were added in version 1, have been reduced
      considerably.
   6. The Coastal Defence units in Canada that were added in Version 1
      have been reworked to make them more accurate. The CD forces in
      Vancouver were also adjusted to more realistic levels (they were
      massively overpowered).

Additions:

   1. The base Rangpur has been added four hexes inland from Calcutta.
      This part of India had no bases, while there are quite a few
      defined along the coast in the Dacca-Calcutta area.
   2. A trail has been added from Imphal (hex 34,26) to meet the railway
      at hex 34,24.
   3. A beach base has been added to Ramree Island (hex 29,29) near
      Akyab.
   4. A river has been added between Hong Kong (hex 43,42) and the rest
      of China. This "river" is intended to simulate the difficulty of
      moving into the region of Hong Kong and Hong Kong island.
   5. Christmas Island in the Indian Ocean (hex 15,62), near Java, has
      been added. It is an undeveloped Australian base at the start of
      the war. If this base causes too many problems with gameplay it
      will be removed in a future update.
   6. The base Boise (hex 143,40) has been added in the United States.
   7. The base Sacramento (hex 143,48) has been added in the United
      States. The railway/highway routes in the area were also adjusted.
      This base provides a backup location, reflecting real-life
      capability, in the unlikely event that San Francisco is attacked
      by the Japanese.
  
Problems or Information
=======================
This is my first attempt at writing an installation utility for a mod. I
have tried to make it simple to use. If you are having problems with
installing, using, or uninstalling this mod, please contact me via the
Matrix Games forums at www.matrixgames.com, user name "Andrew Brown".