Powerups
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 chance1 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/1101, 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.
| 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
Can be triggered, but logic doesn't work
Not available1 ↑ 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.
2 ↑ Money crates do not only award the amounts set in the rules, but also vary the amount randomly by 900 credits.
3 ↑ 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.