Editing Theatre Information

A number of files are used to describe Theatres (Theaters) used in the game world.

&&THEATRES is exported by the scenario creator tool as part of the CVP file.  &&THEATRETEXT is exported by the localization tool.

===== &&THEATRES =====
This section defines:

* Theatre name
* Short name (3 characters)
* Default urban (town/cities) equipment list sequence start, 
* Centre location (x/y)

The following is the default Theatre definition for the World 2020 (W2020) data:

 &&THEATRES
  1, NAS - Northeast Asia, NAS, 21590, 1543, 177,
  2, SAS - Southeast Asia, SAS, 21590, 1519, 275,
  3, CAS - Central Asia, CAS, 21590, 1327, 187,
  4, OCN - Oceania, OCN, 21500, 1622, 476,
  5, MDE - Middle East, MDE, 21530, 1100, 247,
  6, CAN - Central America, CAN, 21500, 392, 319,
  7, ENA - Eastern North America, ENA, 21500, 382, 208,
  8, WNA - Western North America, WNA, 21500, 236, 200,
  9, SAF - Southern Africa, SAF, 21560, 1034, 490,
  10, EAF - Eastern Africa, EAF, 21560, 1090, 370,
  11, NAF - Northwest Africa, NAF, 21560, 878, 302,
  12, WEU - Western Europe, WEU, 21500, 851, 177,
  13, CEU - Central Europe, CEU, 21500, 932, 174,
  14, EEU - Eastern Europe, EEU, 21500, 1047, 139,
  15, NSA - Northern South America, NSA, 21500, 463, 414,
  16, SSA - Southern South America, SSA, 21500, 520, 539,
  17, NAO - North Atlantic, NAO, 21500, 660, 180,
  18, SAO - South Atlantic, SAO, 21500, 775, 535,
  19, NPO - North Pacific, NPO, 21590, 2, 200,
  20, SPO - South Pacific, SPO, 21590, 178, 458,
  21, INO - Indian Ocean, INO, 21590, 1320, 500,
  22, NEU - Northern Europe, NEU, 21500, 834, 104,
  23, CAR - Caribbean, CAR, 21500, 403, 329,                   // Added for SR2030
  24, MED - Mediterranean , MED, 21500, 937, 232,              // Added for SR2030
  25, BLK - Black Sea, BLK, 21500, 1028, 189,                  // Added for SR2030
  26, ARS - Arabian Sea, ARS, 21500, 1225, 335,               // Added for SR2030
  27, MLA - Malay Archipelago, MLA, 21500, 1691, 441,         // Added for SR2030


===== &&THEATRETEXT =====
This includes location text for each theatre - the language localized name, short name, and sort order.  If not present then the information from the &&THEATRE section is used.

===== &&THEATRETRANSF =====
This data controls AI and Minister unit control ("AI Requests").  It is stored in the CVP file and is exported by the scenario creator (effective version x.1.194).  Previously it was stored in \INI\AITheater.INI. 

AI will ordinarily not respond to out-of-theatre requests / hotspots unless this section lists the destination theatre as "opt in".  

An exception to the use of the Theatre Transfer list is that Event 55 (AI Agenda/Stance) uses Parameter i2 to indicate whether the AI region will allow transfers to all other theatres regardless of the transfer list.

Each line starts with the theatre number (ie, 6 for Central America), and then up to 8 neighboring theatres for which theatre-transfers are permitted for unit responses.

===== &&NAVALTRANSIT =====
<small>(Added for SR2030)</small>

This data set is used for cross theatre naval pathing. The numbers after the &&NAVALTRANSIT tag indicate which theatre the data belongs to. The first column is the destination theatre number, the next two values are the hex coordinates (x,y) to use as a waypoint when navigating to that theatre. The last two values are optional shortcut waypoints (Suez Canal, Panama Canal, etc.) that if the player has pathing through them allowed will be used instead of the regular waypoint hex.
 &&NAVALTRANSIT 17         // This is setting data for theatre 17

 ...

 26, 1000, 600, 1035, 265  // Theatre 17 to 26, will waypoint under South Africa (1000, 600), or Suez (1035, 265) if enabled

 ...

 &&END

== Theatre Map ==
[[File:Theatre Map V3.png|left|frameless|1114x1114px]]