BuildLimit

Flag:	BuildLimit
File(s):	Rules(md).ini
Values:	signed integers
Special Values:	negative values (see Special Values below)
Default:	unknown (incorrect comment)
Applicable to:	InfantryTypes, VehicleTypes, AircraftTypes, BuildingTypes

BuildLimit is theoretically used to limit the number of times a user can build the object in question, however:

• It is not an existence limit, meaning even if you can only build the object once, you could still exceed the BuildLimit by finding or taking over more instances of the same object.
  Prominent examples are generated by the Cloning Vats: Yuri Prime is BuildLimit=1 per code, but you can create two through the Cloning Vats.
• The BuildLimit does not have to be reached through building. If a tank has BuildLimit=5 and you build 2 and find 3, you have reached the BuildLimit, even though you did not actually "build" 5 of these tanks.
• As long as the limit is reached, you will not be able to build more of the limited objects, i.e. if a tank has BuildLimit=5, you build those 5, and find 45 more, you could lose 35 of these tanks, all of those you build yourself, and would still not be able to build it again. Because you would still own 15 of the tanks, and the BuildLimit is 5.

Special Values

Note: The comments about this flag found in the rules(md).ini are incorrect!

When you assign a negative value to this flag, the game takes the unsigned version of it, and behaves the same way as with positive values, the only difference being, once you reach the BuildLimit, the icon dissapears off your sidebar for the remainder of the game.

Superweapons

Superweapon limits are independent from the BuildLimit of their carrier buildings, i.e. just because you can build two nuke silos, you don't get two nukes. They both give you SuperWeapon=NukeSpecial, so you will have NukeSpecial. But only once. (Actually, that shouldn't be that much of a surprise to you - you don't get two spyplanes when you have two Radars either.)

Other buildings, however, can multiply their effects without BuildLimit. Infinite Ore Purifiers/Industrial Plants/Cloning Vats... they work as they should.

Notes

• If the BuildLimit is X, you can still have more than X of the tanks in possession – but you will not be able to build more of them yourself as long as the production would increase the number of limited tanks to anything greater than X.

• This system was created to allow the coding of "unique" units, i.e. ones that only exist one at a time. Therefore, the system is "optimized" for BuildLimit=1. A higher BuildLimit is still possible, but you will not be able to queue up the entire limit in a row - you will need to purchase the last one seperately (e.g. if you had BuildLimit=5, you would have to build 4+1). Note that queueing up something else in between is enough, meaning you could queue up the highest possible number of your units, add a different one to the queue, and would then be able to add the last of your limited units as well.