ChangeUnitTypeByGen

Syntax  

ChangeUnitTypeByGen = <UnitGeneration>;<TechUpgPath>[;InFP][;OnMap][;REGorAREA_AreaUID]

Description

Replace the "old" Unit with a "new" Unit in a specified Region or Area, or on map. Replace also in Force Pool.

Example  

ChangeUnitTypeByGen = $uni_USA_Infantry39; $uni_USA_Infantry42;InFP;OnMap

Change the unit (the envelope, not the models!) from Infantry 39 to Infantry 42 on map and in FP. Generally used with ObsoleteModelGen to obsolete models, so they automatically switch to another model generation.

Parameters

<UnitGeneration>

The generation to convert, will use the PoolGeneration entry in Units.xls for the search.

<TechUpgPath>

What is the entry to look for in Units.Xls. If TechUpgAlt (literally), this is the TechUpgAlt column, otherwise this is the TechAutoUpg column.

[FP]

Optional parameter: Change also the Unit in the Unit Force Pool

[OnMap]

Optional parameter: Change also the Unit on map (one at least must be set between FP and OnMap).

[REGorAREA_AreaUID]

Optional parameter: If REG then a valid Region Alias must be specified. If AREA then a valid Area Alias must be specified. If not specified, the currently selected Region or Alias is used.