PowersUpToLevel

Flag:	PowersUpToLevel
File(s):	rules(md).ini
Values:	signed integers
Applicable to:	BuildingTypes (upgrades)

Specifies the 'power level' (not to be confused with power) to which this upgrade powers up the parent building. In cases where the parent building allows for multiple upgrades, this defines which upgrade-plug on the building this upgrade slots into. A value of -1 means the upgrade is placed to the first available slot, while positive values correspond to specific upgrade graphics and positions on the structure as defined with the PowerUpNAnim, PowerUpNAnimDamaged, PowerUpNLocXX, PowerUpNLocYY, and PowerUpNLocZZ statements in art.ini, as well as certain hardcoded functions (see levels below).

Levels

In Tiberian Sun, PowersUpToLevel=1 has a unique hardcoded feature which enables the upgrade to fire its Primary and Secondary weapons (if it has any) simultaneously. This includes spawning all the appropriate projectiles and muzzle animations. For example in the vanilla game, this allows the Component Tower's twin-barreled Vulcan Cannon upgrade fire both guns at once.

A similar effect can be achieved with just one weapon and a burst multiplier, but the bursts are always fired in succession instead of simultaneously, meaning there is always at least a one-frame delay between the bursts.

Below is a snippet from the TS rules.ini:

[GAVULC]
PowersUpBuilding=gactwr
PowersUpToLevel=1
Primary=VulcanTower
Secondary=VulcanTower

Note however that the Primary and Secondary do not have to be the same for this to work.