Civ4BuildInfos

The Civ4BuildInfos file describes the various terrain improvements available for workers, work boats, and others.

All tags must be opened and closed; the first is the "open", the second the "close" tag. If nothing goes inside a "list tag", then it should just be the opening tag with a "/" before the closing bracket. The following tables contain all available tags, as well as their purpose and accepted values.

Tags

Headers

These tags typically bracket other tags, sometimes the entire file, and are generally used to specify more than one piece of data.

Tag Name	Description
BuildInfos	Begins and ends the entire file. Contains various BuildInfo entries.
BuildInfo	Contains the information for each terrain improvement.

Text

Tag Name	Description
Type	The internal name of this build improvement option.
Description	A reference to the text files, which contain an entry for this build option.
Help	Any additional text used for the build; for example, the Final Frontier mod's starbase build.
PrereqTech	The technology required for this improvement.
ImprovementType	The name of the terrain improvement (i.e. farm, mine, whaling boats, etc. Roads and railroads have the value of NONE.)
RouteType	The in-game reference to the type of route provided by this build, as described in the Civ4RouteInfos file. Used for roads and railroads.
EntityEvent	This describes the graphics displayed while this build is being constructed (e.g. a worker using a shovel).
HotKey	Describes the keyboard shortcut for this build. For example, a road has the value of KB_R (KB = keyboard).
FeatureType	Used with the FeatureStructs tag to create terrain-specific information.

Integers

All of these tags have a numerical value. Though it sometimes can be negative, it usually is not.

Tag Name	Description
iTime	The number of turns it takes to complete the improvement, times 100. That is, a value of 600 means the improvement requires 6 turns of action. Note: this is only true for the default worker. Units with a different work rate will work differently. The turns it takes is actually iTime / iWorkRate (in Civ4UnitInfos).
iCost	The gold cost for this improvement (i.e. can be used to draw money from the treasury to pay for improvements).
iHotKeyPriority	If multiple builds have the same hot key shortcut, the build with a value of 1 for this tag is chosen to be constructed.
iProduction	The amount of hammers provided to the nearest city after this build is completed; used with the FeatureStructs tags.

Boolean

All of these can either be 1 (on, or true) or 0 (off, or false). Be careful, as you can wind up with a double-negative, which the game will interpret as "True".

Tag Name	Description
bKill	If 1, the unit constructing the improvement dies (used for fishing boats, whaling boats, etc.).
bAltDown	If 1, the keyboard shortcut requires the Alt key.
bShiftDown	If 1, the keyboard shortcut requires the Shift key.
bCtrlDown	If 1, the keyboard shortcut requires the Control key.
bRemove	If 1, removes the terrain feature after completion (i.e. chopping a forest).

Lists (Multi-line)

All List tags consist of an opening/closing tag, which is shown here, and then each entry within it is another tag with the same name as the parent tag, minus the "s" (i.e. singular, rather than plural).

Tag Name	Description
FeatureStructs	Any features that will be removed with the completion of the build. <FeatureStruct> <FeatureType>FEATURE_FOREST</FeatureType> <PrereqTech>TECH_BRONZE_WORKING</PrereqTech> <iTime>300</iTime> <iProduction>30</iProduction> <bRemove>1</bRemove> </FeatureStruct>

Art

These tags are directly related to the rendering of art for the entry.

Tag Name	Description
Button	References to the build button displayed in the bottom middle of the screen.

Example

In the following example of code, please note that there is a specific order of all of the tags. You must list the tags in this order for the game to properly interpret your file.

<BuildInfos>
 <BuildInfo>
  <Type>BUILD_WINERY</Type>
  <Description>TXT_KEY_BUILD_WINERY</Description>
  <Help/>
  <PrereqTech>TECH_MONARCHY</PrereqTech>
  <iTime>500</iTime>
  <iCost>0</iCost>
  <bKill>0</bKill>
  <ImprovementType>IMPROVEMENT_WINERY</ImprovementType>
  <RouteType>NONE</RouteType>
  <EntityEvent>ENTITY_EVENT_BUILD</EntityEvent>
  <FeatureStructs>
   <FeatureStruct>
    <FeatureType>FEATURE_JUNGLE</FeatureType>
    <PrereqTech>TECH_IRON_WORKING</PrereqTech>
    <iTime>400</iTime>
    <iProduction>0</iProduction>
    <bRemove>1</bRemove>
   </FeatureStruct>
   <FeatureStruct>
    <FeatureType>FEATURE_FOREST</FeatureType>
    <PrereqTech>TECH_BRONZE_WORKING</PrereqTech>
    <iTime>300</iTime>
    <iProduction>30</iProduction>
    <bRemove>1</bRemove>
   </FeatureStruct>
  </FeatureStructs>
  <HotKey>KB_W</HotKey>
  <bAltDown>0</bAltDown>
  <bShiftDown>1</bShiftDown>
  <bCtrlDown>0</bCtrlDown>
  <iHotKeyPriority>1</iHotKeyPriority>
  <Button>,Art/Interface/Buttons/Builds/BuildWinery.dds,Art/Interface/Buttons/Actions_Builds_LeaderHeads_Specialists_Atlas.dds,6,8</Button>
 </BuildInfo>
</BuildInfos>

Civ4 XML Files GlobalDefines • GlobalDefinesAlt • GlobalTypes • PythonCallbackDefines Art: Civ4ArtDefines_Bonus • Civ4ArtDefines_Building • Civ4ArtDefines_Civilization • Civ4ArtDefines_Feature • Civ4ArtDefines_Improvement • Civ4ArtDefines_Interface • Civ4ArtDefines_Leaderhead • Civ4ArtDefines_Misc • Civ4ArtDefines_Movie • Civ4ArtDefines_Terrain • Civ4ArtDefines_Unit • Civ4MainMenus • Civ4RiverModelInfos • Civ4RouteModelInfos Audio; Buildings: Audio2DScripts • Audio3DScripts • AudioDefines • AudioSoundscapeScripts • Civ4BuildingClassInfos • Civ4BuildingInfos • Civ4CityLSystem • Civ4PlotLSystem • Civ4SpecialBuildingInfos BasicInfos: Civ4AttitudeInfos • Civ4BasicInfos • Civ4CalendarInfos • Civ4CityTabInfos • Civ4DenialInfos • Civ4DomainInfos • Civ4InvisibleInfos • Civ4MemoryInfos • Civ4MonthInfos • Civ4NewConceptInfos • Civ4SeasonInfos • Civ4UnitAIInfos • Civ4UnitCombatInfos Civilizations; Events: Civ4CivilizationInfos • Civ4LeaderHeadInfos • Civ4TraitInfos • Civ4UnitArtStyleTypeInfos • Civ4EventInfos • Civ4EventTriggerInfos GameInfo: Civ4CivicInfos • Civ4CivicOptionInfos • Civ4ClimateInfo • Civ4CommerceInfo • Civ4CorporationInfo • Civ4CultureLevelInfo • Civ4CursorInfo • Civ4DiplomacyInfos • Civ4EmphasizeInfos • Civ4EspionageMissionInfo • Civ4EraInfos • Civ4ForceControlInfos • Civ4GameOptionInfos • Civ4GameSpeedInfo • Civ4GoodyInfo • Civ4GraphicOptionInfos • Civ4HandicapInfo • Civ4Hints • Civ4MPOptionInfos • Civ4PlayerOptionInfos • Civ4ProcessInfo • Civ4ReligionInfo • Civ4SeaLevelInfo • Civ4SpecialistInfos • Civ4TurnTimerInfo • Civ4UpKeepInfo • Civ4VictoryInfo • Civ4VoteInfo • Civ4VoteSourceInfos • Civ4WorldInfo Interface: Civ4AdvisorInfos • Civ4CameraInfos • Civ4ColorVals • Civ4InterfaceModeInfos • Civ4PlayerColorInfos • Civ4SlideShowInfos • Civ4SlideShowRandomInfos • Civ4SpaceShipInfos • Civ4ThroneRoomeInfos • Civ4ThroneRoomCameraInfos • Civ4ThroneRoomStyleInfos • Civ4WorldPickerInfos Misc: Civ4AttachableInfos • Civ4CameraOverlayInfos • Civ4DetailManager • Civ4EffectInfos • Civ4QuestInfos • Civ4RiverInfos • Civ4RouteInfos • Civ4TerrainPlainInfos • Civ4TutorialInfos • Civ4WaterPlaneInfos Technologies: Civ4TechInfos Terrain: Civ4BonusClassInfos • Civ4BonusInfos • Civ4FeatureInfos • Civ4ImprovementInfos • Civ4SymbolMeshPaths • Civ4TerrainInfos • Civ4TerrainSettings • Civ4YieldInfos Units: Civ4AnimationInfos • Civ4AnimationPathInfos • Civ4AutomateInfos • Civ4BuildInfos • Civ4CommandInfos • Civ4ControlInfos • Civ4EntityEventInfos • Civ4FormationInfos • Civ4MissionInfos • Civ4PromotionInfos • Civ4SpecialUnitInfos • Civ4UnitClassInfos • Civ4UnitInfos Schemas: Civ4GlobalDefinesSchema • Civ4GlobalTypesSchema • Civ4ArtDefinesSchema • AudioDefinesSchema • AudioScriptSchema • Civ4BasicInfoSchema • Civ4BuildingSchema • Civ4LSystemSchema • Civ4CivilizationSchema • Civ4EventSchema • Civ4GameInfoSchema • Civ4InterfaceSchema • Civ4MiscSchema • Civ4TutorialSchema • Civ4DetailManagerSchema • Civ4TechnologiesSchema • Civ4TerrainSchema • Civ4FormationSchema • Civ4UnitSchema Italics: Beyond the Sword only