Andrew Brown's War in the Pacific Map README file.
=================================================
Version 4, 19th August 2005.

This file explains how to install and use my alternative map for the
computer game War in the Pacific, which is developed by 2by3 Games and
Matrix Games.

Description
===========
This package provides a completely new map for the game. The map cannot
be used with a scenario unless the scenario is specially modified for
use with the map. Official scenarios will not work with this map.
Also, games started from a scenario that is not modified 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.

A number of modified scenarios are supplied with this mod. Other
modified scenarions are available separately. 

Compatibility
=============
The map, when loaded, can ONLY be used with scenarios that have been
modified to use the map.

Installation
============
The map can be installed automatically using an installation utility, or
manually.

Automatic installation WILL NOT WORK if using the Microsoft operating
systems Windows 95/98 or Millenium Edition. In this case a manual
installation will have to be used.

Before attempting either installation, please ensure that the War in the
Pacific game is NOT running.

If you have a previous version of this map loaded, you do not need to
uninstall it, or unload the map from the game. Neither is a previous
version of this map necessary for this version to be installed and used.
The version of the ModSelect utility that is provided with this package
is able to be used to load version 3 of the map as well as the current
version 4, if it is installed. This is so that players who are still
playing games using the version 3 or 3b map can continue to do so more
easily.

Automatic Installation (Windows NT/2000/XP ONLY)
-----------------------------------------------
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
automatic installation.
 
To install the map automatically, do the following:

- Unzip the map package zip file - WitP_Map_Mod_v4.zip - to any
  convenientlocation 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 usually 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.
  
- Scenario files are prepared for the scenario numbers that are or will
  be used for modified versions of the official scenarios (numbers 101
  to 116). The prepration is done my copying the text and picture files
  from scenarios 1 to 16. This does not create the actual scenarios,
  only the text and picture files that appear in the Scenario Selection
  screens.
  
- 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 mod selection 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 mod selection utility. Note that this does
  not uninstall the map, 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 mod selection utility.Each time that
  this is done it is necessary to exit from the game and restart it
  again for the map change to take effect.
  
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 folder 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_Official" 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 (NOT move) the PWhex.dat file from the "[Game folder]" to the
   "ART\Maps_Official" folder.
 
5) The easiest way to install all of the map files is to unzip the zip
   file into the "[Game folder]" location. This will place most of the
   files for the map in the right place, except for the utility that is
   used to load and unload the modified map: "ModSelect.bat" and the
   file that it requires to run: "Choice.exe". 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
   "ModSelect.bat" file and the "Choice.exe" file 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_Andrews_Map_v4.txt to "[Game folder]"

   From the folder "Misc" (below the folder where the files were
   unzipped):  
   Misc\ModSelect.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_v4\*.* (all files) to
   "[Game folder]\ART\Maps_Modified_v3\"

   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"
   
8) Copy the exe file used by the ModSelect utility:

   If using Windows 95, 98 or Millenium Edition:
   Misc\Choice.com to "[Game folder]"

   OR
   
   If using Windows NT, 2000 or XP:
   Misc\Choice.exe to "[Game folder]"
 
Loading the Modified Map
======================== 
Once the map files are installed, they are ready to be 'loaded' into
the game. This is done by running the "ModSelect" 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 loaded and ready to use.

If the modified map is loaded, then the game needs to be restarted for
the change to take effect.

Restoring the Original Map
========================== 
The original map files can be restored at any time by running the
"ModSelect" utility which is located in the "[Game folder]".

If the official map is restored, then the game needs to be restarted for
the change to take effect.

Note that using the utility to restore the original map does not
uninstall the modified map, it simply overwrites the map used by the
game with the original map art. The "ModSelect" utility can later be
used to once again load the modified map into the game.

The "ModSelect" utility 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
====================
If you no longer wish to use the map you can simply run the "ModSelect"
utility to restore the official map.

If you want to completely uninstalled the map, however, then you can do
the following:

- Run the "ModSelect" utility, which is located in the "[Game folder]",
  to restore the official map files.
  
- Delete the following files:

  "[Game folder]\MapMod-Load.bat"
  "[Game folder]\MapMod-Unload.bat"
  "[Game folder]\READ_ME_Andrews_Map_v4.txt"
  "[Game folder]\mapmod_docs\(all files)"
  "[Game folder]\ART\Maps_Modified_v4\(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 map is to install a second copy of the
game, then install this map 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 Documentation
=================
All of the documentation for the map 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 package - 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:

- Maps with "World in Flames" style ocean hex dots, plus optional
  hexside art indicating hexside type in places where the type is
  ambiguous, and/or control zone boundaries.
  
- A map similar to the default one, plus hexside art indicating hexside
  type in places where the type is ambiguous.
  
- A map similar to the default one, but with control zone boundaries.
  
- A map drawn with plain black hexsides throughout, as on the official
  map.

- A map drawn with plain black hexsides throughout, as on the official
  map.

These, and other, alternative maps can be downloaded and installed
separately, although the main map package must be installed for these
alternative maps to be used.

Where to get alternative maps and scenarios
===========================================
Alternative maps, and additional scenarios designed or converted for use
with the map can be found at my website:

http://www.bur.st/~akbrown/witp/map_mod.html

Fixes, Changes and Additions
============================
Version 4 includes the following fixes, changes and additions:

Fixes:

   1. There is now a river between Singapore and Johore Bahru
   2. The reef hexside immediately to the West of Palau was not
      represented in the map data. Fixed.

Changes:

   1. The ocean and river colours have been changed in this version. The
      Ocean colours are inspired by (read copied from) the colours used
      by "Subchaser" for his excellent War in the Pacific map.
   2. Coastal swamp hexes can not now be used for the landing or picking
      up of ground forces, unless the hex contains a base. This has been
      achieved by converting these hexes to land or ocean hexes,
      depending on the nearby terrain.
   3. A new transport link type has been introduced on this version of
      the map - low capacity rail. This is simply road, but drawn
      differently, to represent those railways, narrow gauge or
      otherwise, that could not handle large volumes of traffic. Most of
      the rail lines in China have been downgraded to this type of
      "railway" except for the main lines linking Shanghai, Tsingtao,
      Peking, Tientsin, Harbin and Seoul, as well as the connection
      between Canton and Hong Kong.
   4. Apart from China, a few other rail lines, which were narrow gauge
      and/or low capacity lines, have been "downgraded" to "Secondary"
      rail lines. The most significant of these is the central railway
      in Malaya, running South from Kota Bharu.
   5. The transport network in India has been modified. The rail link
      from Raipur North through the forest hexes has been downgraded to
      a "Secondary" line and truncated. A smal number of new rail lines
      have also been added in India due to the addition of several new
      bases.
   6. Significant changes have been made to the terrain in China. A few
      specific changes are listed here, but there are many more.
   7. The coastal road in China, between Swatow and Wenchow, has been
      removed.
   8. Several roads in Northern China, near Lanchow, Tatung and Yenan,
      have been downgraded to trails.
   9. Chungking is now - correctly - on the Northwest side of the
      Yangtze river.
  10. Chungking and Chengtu are now connected by road instead of trail.
  11. The terrain between Chungking and Chengtu is now cultivated
      instead of forest.
  12. The transport link in the single hex (43,31) to the Northeast of
      Chungking has been converted from trail to road.
  13. Sian is now - correctly - on the South side of the Hwang Ho river.
  14. The base of Linfen (50,30), controlled by the Chinese at the start
      of the campaign game, has been replaced with the base of Yangku
      (51,29), controlled by the Japanese.
  15. The railway between Yangku and Sian no longer crosses the Hwang Ho
      river.
  16. The hex containing Hong Kong (43,42) has been converted from clear
      to mountain terrain. Also the river that I added to Hong Kong in
      the previous map revision has been removed again. This should
      (hopefully) provide the right balance to the effectiveness of the
      Hong Kong defence.
  17. The transport link in the hex containing the base of Rahaeng in
      Siam (31,36) has been converted from trail to road. This should
      make it a bit quicker for Japanese units to march to/from Burma.
  18. The transport link in the hex formerly containing the base of
      Takao in Formosa (47,46) has been downgraded from road to trail.
  19. A number of base names in the Dutch East Indies have been changed:
          * Bula -> Boela
          * Banjarmasin -> Bandjermasin
          * Macassar -> Makassar
  20. The road between Bandjermasin and Balikpapan has been truncated,
      so that these two bases are no longer connected.
  21. Moulmein is now - correctly - on the South side of the Salween
      river.
  22. The base of Yanam (21,21) in India has been replaced by the base
      of Vizagapatam (22,21).
  23. The base of Chandpur (31,25) has been renamed Chittagong, which
      was a much more important port.
  24. Dacca has "moved" from hex 32,24 to hex 31,23, which places it a
      more correct distance from Calcutta. This also improves the
      correct placement of Chittagong. The mouths of the Brahmaputra
      river have also been adjusted to suit.
  25. The transport link in the hex containing Kuantan (24,48) in Malaya
      has been upgraded from trail to road.
  26. Saigon (31,45) has been changed from urban to clear terrain.
  27. The trail between Cooktown (48,100) and Cairns (48,102) in
      Northern Australia has been upgraded to a road. In addition the
      hex to the Northwest of Cooktown (47,99) has also been upgraded
      from trail to road.

Additions:

   1. A number of new base locations have been added in India: Poona
      (19,12), Cuttack (27,22), Agra (28,11), Cawnpore (28,23),
      Mangalore (14,17), Jaipur (26,9), Madurai (13,21), Patna (30,19)
   2  The dot base of Portland Roads (49,94) has been added to far
      Northeast Australia.
   2. All Indian bases have had their manpower, heavy industry and
      resource vaules modified and recalculated. The manpower values in
      particular were not very accurate previously.
   3. An atoll has been added in the location of Male, in the Maldives
      (5,22), to provide the option of adding a base here.
   4. A trail now links the Lamon Bay and Manila hexes in the
      Philippines.
   5. A trail now links the base locations of Coen (47,96) and Portland
      Roads (49,94) in the far North of Australia.
   6. A new base location has been added for Skagway in Alaska (122,28),
      and the railway between Whilehorse and Juneau now terminates here.
   7. A new base location has been added for Whittier, in Alaska
      (114,28) and a railway connects this hex to Anchorage.
   8. In the converted scenarios, a new base is added in Australia -
      Katherine (35,87). This base helps to represent the very large
      number of airfields that were built in the area around Darwin
      during the war.
   9. In the converted scenarios, a new base is added in Canada, at the
      Western tip of Vancouver Island, Port Alice. This base was used by
      naval search aircraft, filling a gap between Vancouver/Victoria
      and Prince Rupert.
  10. The North Borneo Railway has been added. it is a small, low
      capacity line (represented as road in the map data) on the South
      China Sea coast of Sabah.

Version 3 includes the following fixes, changes and additions:

Fixes:

   1. The hex types for the Irkutsk (hex 59,12) and Ulan-Ude (hex 59,13)
      in the Soviet Union have been changed from Coastal to Land to
      prevent the AI from trying to use the bases as destinations for
      naval task forces.

Changes:

   1. Christmas Island (IO) (hex 15,62) has been changed from Atoll
      terrain to Jungle terrain. This island has an area of about 100
      square kilometres.
   2. Canton in China (hex 43,41) had been made a coastal location so
      that it can be used as a port. It is open to the sea to the West.
   3. The road in the hex adjacent to Victoria Point in Burma (hex
      25,40) was causing a lot of confusion. It was not supposed to
      connect to Victoria Point as several people supposed, but it was
      not of any use in the game either, so it has been removed.
   4. The transport link between Khota Baru (hex 24,45) and Kuantan (hex
      24,48) has been downgraded from a Road to a Trail, as the
      transport links on the East coast of Malaya were poor.
   5. There was no road between Kuantan (hex 24,48) and Mersing (hex
      23,50), so the road between these two hexes along the Eastern
      coast of Malaya has been removed.
   6. The "Burma Railway", which spans the hexes between 29,35 and 29,38
      has been downgraded from rail/highwway to a track. This line was
      not built until late in the war and was a low-capacity line.
   7. The transport link in Rahaeng (hex 31,36) has been downgraded from
      road to track.
   8. The transort link at Fort St. John in Canada (hex 131,27) has been
      changed from Railway to Road, as the railway did not reach all the
      way to Fort St. John.
   9. Hex 44,60, Northeast of Davao, has been changed from a coastal hex
      to a land hex.
  10. The port values for Noumea (hex 66,117) have been reduced to more
      realistic levels.
  11. The map art at Nome in Alaska (hex 104,23) has been adjusted to
      make it look less like Nome is floating in the sea.

Additions:

   1. The Malaria zone has been made visible by adding a border around
      it, including around bases that are within the zone area but are
      Malaria free, such as Saigon, Manila and Singapore. The border is
      drawn in the same style as the weather area borders, but using
      yellow instead of blue. 

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
=======================
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".
