The Prerequisite System: Difference between revisions

Latest revision as of 17:57, 2 July 2025

The Prerequisite System controls the conditions required to build a certain object. Those conditions are:

Is this object's TechLevel valid?: Checks if the TechLevel of the object is above -1 and below [MultiplayerDialogSettings]→TechLevel.
Is this house not forbidden from owning this object?: Checks if the house is not listed in ForbiddenHouses.
Is this house allowed to own this object?: Checks if the house is listed in RequiredHouses.
Does this house own all the prerequisite structures?: Checks if the house owns the prerequisite structures listed in Prerequisite
Is this object stolen technology?: If the unit contains RequiresStolenAlliedTech=yes, RequiresStolenSovietTech=yes, or RequiresStolenThirdTech=yes, has the apropriate lab get spied upon?

If all conditions are met, the house is theoretically allowed to build that object, signaled by a "New Construction Options" announcement.
Next, the game determines whether the house actually can build the object:

Does the house own a Factory of the appropriate type?: Checks whether the house has at least one structure with Factory matching the object's type.
Can this house own this object?: Checks if your Factory contains atleast 1 Owner listed as this units Owner.
If the object in question is a VehicleType, does the house have a Factory=VehicleType with the same Naval setting as the object?: Checks whether the house has a War Factory if it's trying to build land-based (Naval=no) vehicles, and whether it has a Shipyard if it's trying to build water-based (Naval=yes) vehicles.

Overrides

If an object has a PrerequisiteOverride BuildingType (or multiple BuildingTypes) set, a house will be allowed to build the object as soon as it possesses any single one of those listed BuildingTypes, no matter what prerequisites the object usually requires. (Hence the name.)
The same applies to objects from SecretLab=yes buildings: If a house gains an object through a Secret Lab, it will be allowed to build that object immediately, no matter what prerequisites the object usually requires. Such an object will be buildable even if it has TechLevel=11 set.
In addition, AI players do not check Prerequisite and TechLevel tags when they're trying to build the Power Plants listed under GDIPowerPlant, NodRegularPower, ThirdPowerPlant.
AI players also ignore all Prerequisite settings except TechLevel on all other objects, they build objects in the order dictated by the ai(md).ini file (the order of BuildingTypes is controlled by different methods covered here).

All cases under the presumption that the house owns a factory of the appropriate type.

Prerequisite Groups

A "prerequisite group" refers to a list of structures, and any single one of them is sufficient to fulfill the type. See: Generic Prerequisites.

Bugs/Side-Effects/Unexpected Limitations

Only one building specified by PrerequisiteOverride= activates production, meaning that it's not a cumulative list like Prerequisites=.

Ares can allow more types of prerequisite alternatives, see: https://ares-developers.github.io/Ares-docs/new/prerequisites.html

At least in Red Alert 2 and Yuri's Revenge, the AI players ignore Prerequisites= for building queues, limited instead by AIBuildThis, Owner, RequiredHouses, ForbiddenHouses, and stolen tech requirements.

Also in Red Alert 2, the AITriggerTypes in ai(md).ini instruct the AI player to produce TaskForces disregarding Prerequisites altogether, as well as TechLevel, limited by other factors as above.

@@ Line 1: / Line 1: @@
-The Prerequisite System controls the conditions required to build a certain object. Those conditions include:
+The Prerequisite System controls the conditions required to build a certain object. Those conditions are:
+:{|style="border: 1px solid #aaaaaa; background:#e5e5e5; border-spacing: 5px;"
+|
 ; Is this object's TechLevel valid?
-: Checks if the TechLevel of the object is above -1 and below [{{TTL|MultiplayerDialogSettings}}] {{TTL|TechLevel}}.
+: Checks if the TechLevel of the object is above -1 and below [{{f|MultiplayerDialogSettings|link}}]&rarr;{{f|TechLevel|link}}.
-; Can this house own this object?
-: Checks if the house is listed in {{TTL|Owner}}.
 ; Is this house not forbidden from owning this object?
-: Checks if the house is not listed in {{TTL|ForbiddenHouses}}.
+: Checks if the house is not listed in {{f|ForbiddenHouses|link}}.
 ; Is this house allowed to own this object?
-: Checks if the house is listed in {{TTL|RequiredHouses}}.
+: Checks if the house is listed in {{f|RequiredHouses|link}}.
 ; Does this house own all the prerequisite structures?
-: Checks if the house owns the prerequisite structures listed in {{TTL|Prerequisite}}
+: Checks if the house owns the prerequisite structures listed in {{f|Prerequisite|link}}
+; Is this object stolen technology?{{yro}}
+: If the unit contains {{f|RequiresStolenAlliedTech|link}}<tt>=yes</tt>, {{f|RequiresStolenSovietTech|link}}<tt>=yes</tt>, or {{f|RequiresStolenThirdTech|link}}<tt>=yes</tt>, has the apropriate lab get spied upon?
+|}
+If all conditions are met, the house is ''theoretically allowed'' to build that object, signaled by a [[EVA_NewConstructionOptions|"New Construction Options"]] announcement.<br>
+Next, the game determines whether the house ''actually can'' build the object:
+:{|style="border: 1px solid #aaaaaa; background:#e5e5e5; border-spacing: 5px;"
+|
+; Does the house own a {{f|Factory|link}} of the appropriate type?
+: Checks whether the house has at least one structure with {{f|Factory|link}} matching the object's type.
+; Can this house own this object?
+: Checks if your {{f|Factory|link}} contains atleast 1 {{f|Owner|link}} listed as this units {{f|Owner|link}}.
+; If the object in question is a VehicleType, does the house have a {{f|Factory|VehicleType|link}} with the same {{f|Naval|link}} setting as the object?
+: Checks whether the house has a War Factory if it's trying to build land-based ({{f|Naval|no|link}}) vehicles, and whether it has a Shipyard if it's trying to build water-based ({{f|Naval|yes|link}}) vehicles.
+|}
+==Overrides==
+*If an object has a {{f|PrerequisiteOverride|link}} BuildingType (or multiple BuildingTypes) set, a house will be allowed to build the object as soon as it possesses any single one of those listed BuildingTypes, no matter what prerequisites the object usually requires. (Hence the name.)
+*The same applies to objects from {{f|SecretLab|yes|link}} buildings: If a house gains an object through a Secret Lab, it will be allowed to build that object immediately, no matter what prerequisites the object usually requires. Such an object will be buildable even if it has {{f|TechLevel|11|link}} set.
+*In addition, AI players do not check {{f|Prerequisite|link}} and {{f|TechLevel|link}} tags when they're trying to build the Power Plants listed under {{f|GDIPowerPlant|link}}, {{f|NodRegularPower|link}}, {{f|ThirdPowerPlant|link}}{{yro}}.
+*AI players also ignore all {{f|Prerequisite|link}} settings except {{f|TechLevel|link}} on all other objects, they build objects in the order dictated by the {{Ini|ai}} file (the order of BuildingTypes is controlled by different methods covered [[AI base building|here]]).
+''All cases under the presumption that the house owns a factory of the appropriate type.''
+==Prerequisite Groups==
+A "prerequisite group" refers to a list of structures, and any single one of them is sufficient to fulfill the type. See: [[Generic Prerequisites]].
+=={{bugs}}==
+Only one building specified by <tt>PrerequisiteOverride=</tt> activates production, meaning that it's not a cumulative list like <tt>Prerequisites=</tt>.
+* Ares can allow more types of prerequisite alternatives, see: https://ares-developers.github.io/Ares-docs/new/prerequisites.html
-If all the conditions are met, the house is allowed to build that object. Accompanied by the [[EVA_NewConstructionOptions]] sound.
+At least in {{ra2}} and {{yr}}, the AI players ignore <tt>Prerequisites=</tt> for building queues, limited instead by [[AIBuildThis]], [[Owner]], [[RequiredHouses]], [[ForbiddenHouses]], and stolen tech requirements.
-Otherwise, if the house has at least one structure listed in {{TTL|PrerequisiteOverride}} or gains this object via [[Secret Lab]], it gets that building even without fulfilling the other criteria.
+Also in {{ra2}}, the [[AITriggerTypes]] in {{ini|ai}} instruct the AI player to produce [[TaskForces]] disregarding <tt>Prerequisites</tt> altogether, as well as [[TechLevel]], limited by other factors as above.
-Then an additional check takes place:
+[[Category: Systems]]
-; Does the house own the {{TTL|Factory}} of the appropriate type?
-: Checks if the house has at least one structure with {{TTL|Factory}} matching the object's type.
-:: '''Note:''' For VehicleTypes, it also checks if said Factory has the same {{TTL|Naval}} setting as the object in question. If it doesn't, the object is removed from the Units tab, and, if that tab is open, the view jumps to the top of it. This is known as the [[New Construction Options]] Bug.