ModEnc is currently in Maintenance Mode: Changes could occur at any given moment, without advance warning.

The Prerequisite System

From ModEnc
Revision as of 10:42, 27 November 2009 by EvilRenegade (talk | contribs) (Replacing Template:TTL with Template:F.)
Jump to: navigation, search

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?Yro.png
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.

Note: If you do not have the appropriate type of Factory=VehicleType, but all other prerequisites are fulfilled, you will probably experience the NCO bug.

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, ThirdPowerPlantYro.png.
  • 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 "prerequisite group". The following "prerequisite groups" are valid:

In Firestorm, two additional groups were available:

==RP's 'NEW' Prerequisite System stuff[RockPatch is obsolete; please remove this template from the page] ==

  • NegativePrerequisite=
If anything on this list is owned by the player, then the object can't be built.
  • AlternatePrerequisite=
A Clone of Prerequisite=, if all items on either Prerequisite=, or AlternatePrerequisite= are owned by the player, then the Prerequisite= condition is considered to be met. (on a side note, more of these clones are wanted)
  • SovietAdvancedPower= RPCE only.
Revival of NodAdvancedPower=, but with a new name so as to not conflict with the un-modded game, thereby not allowing the Soviets to build the Nuclear Reactor, which by default is not on that tag, instead the tag is set to NAAPWR, the TS Nod Advanced Power Plant. Basically this tag allows the Soviets to build their 'Advanced Power Plant' when they are low on power, instead of lots of regular Power Plants, as long as they meet the prerequisites for that Advanced Power Plant. in RP v1.10 this was replaced with the new PowerPlants= tag.
  • PowerPlant=
This is the new version of GDIPowerPlant=, NodRegularPower= and ThirdPowerPlant= listed under the sides header ([GDI], [Nod] and [ThirdSide] are the default 3). Although this is automaticly mapped to the original 3 tags for the original 3 sides, FourthPowerPlant is Obsolete.
  • PowerPlants=
This is a list of power plants per side under the sides header , which lists BuildingType that are randomly selected when that side requires extra power.
  • RequiresStolenTech=
New stolen tech logic based on RequiresStolenAlliedTech=yes, RequiresStolenSovietTech=yes, and RequiresStolenThirdTech=yes, which allows the modder to specify a new structure that needs to be spied upon to obtain this unit. the building you need to spy on also requires the tags IsStolenTech=yes and Spyable=yes
  • RequiresTheater=
A new prerequisite logic based on the theater of the map you are currently playing. This enables modders to make certain structures or units available in, for example, arctic maps only. This, however, does not work correctly with the AI. The available options for this tag are:
  • TEMPERATE - the Temperate theater (most maps).
  • SNOW - the Arctic theater (snowy maps).
  • URBAN - the Urban theater (some city maps).
  • DESERT - the Desert theater (Yro.png, some desert maps, older ones use Temperate).
  • LUNAR - the Lunar theater (Yro.png, Soviet Mission 5).
  • NEWURBAN - the New Urban theater (Yro.png, most YR Urban maps).

Note: Other items may have been planned, or wished for future RP versions, but only completed items are on this list.