Powerups

This page should correctly be named "[Powerups]"; it is wrong due to technical restrictions.

This section of rules(md).ini controls the content of crates, i.e. which bonuses they can provide, which amount of them, and what animation to play when triggered. For general crate rules, like their frequency of appearence, see [CrateRules].

Flags in Powerups are listed as Cratename=X,Y,Z,S, where

• Cratename is the name of the powerup (hardcoded)
• X is the chance¹ that this powerup will be triggered
• Y is the name of the animation to play (or <none>). Not all Powerups actually play an animation when collected.
• Z defines whether the crate is available on water - if you set this to "yes" on the wrong crates, you risk Internal Errors; an example of this is the unit-crate, where you will get an IE if the crate tries to generate naval units on land or land units on water.
• S is a special parameter, different from crate to crate.

The CrateType column gives you the number you need to use for FA2 to spawn the crate in RA2 and YR via trigger action 108. It is not a number you'll find anywhere in the rules.

Example

Armor=10,ARMOR,yes,1.5
Armor crates appear with a chance of 10/110¹, play ARMOR as an animation when triggered, do appear on water, and multiply your unit's Strength by 1.5 when it picks up the crate; the crate's number is 9.

Explanation of [Powerups] flags, default YR values, availability

CrateType	Flag name	Chance1	Animation	Water?	Special Parameter	Flag explanation	Works in game(s)	Play animation?
?	ParaBomb	3 (RA)	PARABOX			Gives you one (1) loaded ParaBomb Superweapon	RA, TS/FS, RA2/YR	?
?	Sonar	3 (RA)	SONARBOX			Gives you one (1) loaded Sonar Pulse Superweapon	RA, TS/FS, RA2/YR	?
?	TimeQuake	3 (RA)	TQUAKE			Creates a Time Quake	RA, TS/FS, RA2/YR	?
0	Money	20	MONEY	yes	2000	Gives you the amount of Credits specified in Special Parameter. Note the exact amount always varies, apparently between ±$9002.	RA, TS/FS, RA2/YR	Yes
1	Unit	20	<none>	no		Gives you one free VehicleType not marked CrateGoodie=no	RA, TS/FS, RA2/YR	No
2	HealBase	10	HEALALL	yes		Heal everything to full health Also forces units of Houses/Countries with IQ ≥ [IQ]>Scatter to scatter.	RA, TS/FS, RA2/YR	Yes
3	Cloak	0	CLOAK	yes		Gives everything within the CrateRadius the effect of Cloakable=yes	RA, TS/FS, RA2/YR	Yes
4	Explosion3	0	<none>	yes	500	Creates an explosion using the warhead defined in C4Warhead, damage controlled by Special Parameter. Only the TechnoType registered as receiver is actually damaged; so only one InfantryType or one VehicleType.	RA, TS/FS, RA2/YR	Yes
5	Napalm3	0	<none>	no	600	Creates an explosion using the warhead defined in FlameDamage, damage controlled by Special Parameter. Only the TechnoType registered as receiver is actually damaged; so only one InfantryType or one VehicleType.	RA, TS/FS, RA2/YR	Yes
6	Squad	0	<none>	no		Spawns a squad of InfantryTypes. From TS to YR, it is forced to the action of the Money powerup, and there's no way to even play the animation, if specified. It'll always play the Money pwoerup's animation if forced.	RA, TS/FS, RA2/YR	Money Powerup
7	Darkness	0	SHROUDX	yes		Shrouds the entire map, even if you have a SpySat Uplink. You need to collect a Reveal crate or sell each Building you already owned with SpySat=yes first before building another one to re-gain full map view.	RA, TS/FS, RA2/YR	Yes
8	Reveal	10	REVEAL	yes		Reveals entire map (sans Gap Generators, of course). In Tiberian Sun, gaining a second Reveal will cause an opposite effect, shrouding the entire map (same as the Darkness powerup)	RA, TS/FS, RA2/YR	Yes
9	Armor	10	ARMOR	yes	1.5	Multiplier to unit Strength, controlled by Special Parameter In TS, this is a multiplier to incoming Damage instead. Uses the Money powerup if the receiving unit already has picked up an Armor crate.	RA, TS/FS, RA2/YR	Yes
10	Speed	10	SPEED	yes	1.2	Multiplier to unit Speed, controlled by Special Parameter. Uses the Money powerup if the receiving unit already has picked up a Speed crate.	RA, TS/FS, RA2/YR	Yes
11	Firepower	10	FIREPOWR	yes	2.0	Multiplier to weapon Damage, controlled by Special Parameter. Uses the Money powerup if the receiving unit already has picked up a Firepower crate.	RA, TS/FS, RA2/YR	Yes
12	ICBM	0	CHEMISLE	yes		Gives you a free shot with the first super weapon in the SuperWeaponTypes list to have Action=Nuke. Note this crate does nothing when a building with the Nuke Special has already been built by whoever collected it. However, if an ICBM crate was collected, and then a Nuke Silo built before firing, the nuke comes out as fully charged for its first shot. In TS, this crate is hardcoded to give you 1x shot of the [MultiLauncher] weapon, while displaying the sidebar cameo and text of the [MultiSpecial] superweapon.	RA, TS/FS, RA2/YR	Yes
13	Invulnerability	0	ARMOR	yes	1.0	Renders your unit invulnerable for the number of minutes set by Special Parameter. In Tiberian Sun and later, has no effect other than playing the specified animation.	RA, TS/FS, RA2/YR	Yes
14	Veteran	20	VETERAN	yes	1	Instant promotion by the number of levels set in Special Parameter. Uses the Money powerup if the receiving unit has already reached full promotion.	RA, TS/FS, RA2/YR	Yes
15	IonStorm	0	<none>	yes		Was intended to generate a random Ion Storm, but has no effect other than playing the specified animation.	RA, TS/FS, RA2/YR	Yes
16	Gas	0	<none>	yes	100	Applies the warhead [Gas] in the cell containing the crate, as well as all 8 adjacent cells, dealing damage controlled by the Special Parameter. In TS, this spawns green gas cloud particles which are attached to the warhead. In RA2/YR, the Weather Storm's clouds are spawned instead, discolored due to the game using incorrect palette. Be sure to check [Gas] and fix [GasCloudSys] before using this.	RA, TS/FS, RA2/YR	Yes
17	Tiberium	0	<none>	no		Creates a small patch of ore or Tiberium, depending on the game. Picks a random "maturity" of Tiberium/Ore patch as well as the amount.	RA, TS/FS, RA2/YR	Yes
18	Pod	0	<none>	no		Would have given you the Drop Pod Special in TS, but that feature was scrapped. It still plays the specified animation when collected.	RA, TS/FS, RA2/YR	Yes

Crate IDs 19 and up are random skirmish crates, respecting Chance set by the rules.ini

Works fine                 

Can be triggered, but logic doesn't work                 

Not available                 

¹ ↑ Note: These chances are not percentage values, but rather shares of the sum of all default shares, meaning:

• In RA2/YR, the chance is x/110
• In TS/FS, the chance is x/441
• In RA, the chance is x/146

where x is, in all cases, the chance-parameter.

² ↑ Money crates do not only award the amounts set in the rules, but also vary the amount randomly by 900 credits.

³ ↑ The Napalm and Explosion crates appear to only damage (or kill) one infantry of a squad: the infantry that was registered as the receiver. It needs to be tested if the same goes for the Gas crate.

Trivia

Calculating from the shares-system, our example, the Armor-crate, has a chance of

• 9.09% (10/110) to appear in RA2/YR, while 1% equals 1.1 shares.
• 7.48% (33/441) to appear in TS/FS, while 1% equals 4.41 shares.
• 6.85% (10/146) to appear in RA, while 1% equals 1.46 shares.

Obsolete Powerups in RA2/YR

Several Powerups do not work the way they were coded anymore. They are, however, not useless. Even though they do not create a specific, special effect when you pick them up, they do play the specified animation. And animations can have Damage, can spawn Particles and even neutral infantry. Whatever you can do with an animation can be called by a crate. Several mods use this to have a crate spawning neutral Brutes, for example.

The only CrateTypes that can be used for this in YR are the IonStorm, Pod and Invulnerability crates, as only these play their set animations. The others either don't exist in RA2/YR or (in the case of Squad) are forced to use another action.

See also

• [CrateRules]
• CrateBeneath
• CrateBeneathIsMoney
• CarriesCrate
• Machine's thread about TS's Armor