Difference between revisions of "Civ4HandicapInfo"

From Civilization Modding Wiki
Jump to: navigation, search
Line 1: Line 1:
Tags are either text tags (no prefix; they should contain letters), boolean (prefixed by a b, can be 1 [on] or 0 [off]) or integer (prefixed by i, containing numbers).
+
 
 +
The CIV4HandicapInfo.xml file sets the differences between difficulty levels.
 +
 
 +
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.
 +
 
 +
<font color=red>This page is missing information.
 +
Do not remove this notice until it is complete.</font>
 +
 
  
 
'''Note: unless specified, effects are valid for every civ (both humans and AIs)'''
 
'''Note: unless specified, effects are valid for every civ (both humans and AIs)'''
  
{| class="wikitable" border="1" style="text-align:left" cellpadding="5"
+
 
 +
==Tags==
 +
===Headers===
 +
 
 +
These tags typically bracket other tags, sometimes the entire file, and are generally used to specify more than one piece of data.
 +
 
 +
{| border="1" style="text-align:left" cellpadding="3" cellspacing="0"
 
|-
 
|-
! Tag !! Usage !! Default values
+
! style="background:#efefef;" | Tag Name
 +
! style="background:#efefef;" | Description
 
|-
 
|-
! HandicapInfos
+
!HandicapInfo
| This begins and ends the file. Everything must go in between these two, or it will not work.
+
|Main bracket for each entry
|  
 
 
|-
 
|-
! HandicapInfo
+
!Type
| Encloses the entry for each handicap set (one for each difficulty level)
+
|Label that is used throughout all other XML files
|  
+
|}
 +
 
 +
 
 +
===Text===
 +
 
 +
{| border="1" style="text-align:left" cellpadding="3" cellspacing="0"
 
|-
 
|-
! Type
+
! style="background:#efefef;" | Tag Name
| The name that can be used in other files and in the SDK to refer to a particular handicap.
+
! style="background:#efefef;" | Description
|  
 
 
|-
 
|-
! Description
+
!Description  
| References the Text which contains the difficulty description (eg: "settler", or "noble"). The text is specified in any of the Assets\XML\Text files.
+
|References the Text which contains the difficulty description (eg: "settler", or "noble"). The text is specified in any of the Assets\XML\Text files.  
|
 
 
|-
 
|-
! Help
+
!Help  
| References the Text which contains the tooltip for this difficulty. The text is specified in any of the Assets\XML\Text files.
+
|References the Text which contains the tooltip for this difficulty. The text is specified in any of the Assets\XML\Text files.  
|  
+
|}
 +
 
 +
 
 +
===Integers===
 +
 
 +
All of these tags have a numerical value.  Though it sometimes can be negative, it usually is not.
 +
 
 +
{| border="1" style="text-align:left" cellpadding="3" cellspacing="0"
 
|-
 
|-
! iFreeWinsVsBarbs
+
! style="background:#efefef;" | Tag Name
| Sets how many battles are granted to be won against barbarians
+
! style="background:#efefef;" | Description
| 5 for chieftain, 2 for noble, 0 for deity
 
 
|-
 
|-
! iAnimalAttackProb
+
!iAdvancedStartPointsMod
| Sets the aggressivity of animals, specifying their attack chance in percentage  
+
|Sets the advanced start points modifier (in percentage)
| 25 for chieftain, 85 for noble, 90 for deity
+
 
 +
(150 for chieftain, 100 for noble, 75 for deity)
 
|-
 
|-
! iStartingLocPercent
+
!iAIAdvancedStartPercent
| Unknown
+
|Modifies the points an AI starts with in an advanced start (in percent)
| 10 for chieftain, 40 for noble, 90 for deity
+
 
 +
(100 for chieftain, 100 for noble, 170 for deity)
 
|-
 
|-
! iAdvancedStartPointsMod
+
!iAIAnimalBonus
| Sets the advanced start points modifier (in percentage)
+
|Sets the combat bonus animals receive against AI players (in percent)
| 150 for chieftain, 100 for noble, 75 for deity
+
 
 +
(-40 for chieftain, -40 for noble, -40 for deity)
 
|-
 
|-
! iGold
+
!iAIBarbarianBonus
| Sets how much gold every civ starts with
+
|Sets the combat bonus barbarians receive against AI players (in percent)
| 0 for chieftain, 0 for noble, 0 for deity
+
 
 +
(-25 for chieftain, -25 for noble, -25 for deity)
 
|-
 
|-
! iFreeUnits
+
!iAICivicUpkeepPercent
| Sets how many units don't need maintainance  
+
|Modifies the civic maintainance cost for AI (in percent)
| 24 for chieftain, 8 for noble, 1 for deity
+
 
 +
(100 for chieftain, 100 for noble, 60 for deity)
 
|-
 
|-
! iUnitCostPercent
+
!iAIConstructPercent
| Sets the unit support cost modifier (in percentage)  
+
|Modifies the buildings cost for AI (in percent) (not for wonders or projects)
| 20 for chieftain, 50 for noble, 100 for deity
+
 
 +
(160 for chieftain, 100 for noble, 60 for deity)
 
|-
 
|-
! iResearchPercent
+
!iAICreatePercent
| Sets the technology cost modifier (in percentage)  
+
|Modifies the non-world projects cost for AI (in percent)  
| 60 for chieftain, 100 for noble, 130 for deity
+
 
 +
(160 for chieftain, 100 for noble, 60 for deity)
 
|-
 
|-
! iDistanceMaintenancePercent
+
!iAIDeclareWarProb
| Sets the city maintainance cost modifier for distance (in percentage)
+
|A factor that determines how likely an AI will declare war
| 45 for chieftain, 75 for noble, 100 for deity
+
 
 +
(25 for chieftain, 100 for noble, 100 for deity)
 
|-
 
|-
! iNumCitiesMaintenancePercent
+
!iAIGrowthPercent
| Sets the city maintainance cost modifier for number of cities (in percentage)  
+
|Modifies how much food an AI city requires to grow (in percent)  
| 40 for chieftain, 70 for noble, 100 for deity
+
 
 +
(160 for chieftain, 100 for noble, 80 for deity)
 
|-
 
|-
! iMaxNumCitiesMaintenance
+
!iAIInflationPercent
| Sets the max number of cities that contribute to the city maintainance cost
+
|Sets the inflation modifier for AI (how much expenses increase as the game goes on) (in percentage)
| 4 for chieftain, 5 for noble, 8 for deity
+
 
 +
(100 for chieftain, 80 for noble, 80 for deity)
 
|-
 
|-
! iColonyMaintenancePercent
+
!iAIPerEraModifier
| Sets the maintainance cost modifier for colonies (in percentage)  
+
|A modifier which, multiplied for the current era, affects units cost, buildings cost, projects cost, unit support, unit supply, inflation rate, war weariness, civic upkeep, required food for city growth, unit upgrade cost. (in percent)  
| 60 for chieftain, 100 for noble, 150 for deity
+
 
 +
(0 for chieftain, 0 for noble, -5 for deity)
 
|-
 
|-
! iMaxColonyMaintenance
+
!iAIStartingDefenseUnits
| A factor used to determine the maximum maintainance cost for colonies (in percentage)
+
|Sets how many extra defensive units AI players start with
| 200 for chieftain, 200 for noble, 200 for deity
+
 
 +
(0 for chieftain, 0 for noble, 4 for deity)
 
|-
 
|-
! iCorporationMaintenancePercent
+
!iAIStartingExploreUnits
| Sets the corporations maintainance modifier (in percentage)
+
|Sets how many explorer units AI players start with
| 60 for chieftain, 100 for noble, 150 for deity
+
 
 +
(0 for chieftain, 0 for noble, 1 for deity)
 
|-
 
|-
! iCivicUpkeepPercent
+
!iAIStartingUnitMultiplier
| Sets the civics maintainance modifier (in percentage)  
+
|A factor that determinates how many extra units (per unit type) AI players receive at the game starts
| 50 for chieftain, 80 for noble, 100 for deity
+
 
 +
(0 for chieftain, 0 for noble, 1 for deity)
 
|-
 
|-
! iInflationPercent
+
!iAIStartingWorkerUnits
| Sets the inflation modifier (how much expenses increase as the game goes on) (in percentage)
+
|Sets how many extra workers AI players start with
| 60 for chieftain, 90 for noble, 100 for deity
+
 
 +
(0 for chieftain, 0 for noble, 1 for deity)
 
|-
 
|-
! iHealthBonus
+
!iAITrainPercent
| Sets the health bonus/malus for every city
+
|Modifies the standard units cost for AI (in percent)
| 4 for chieftain, 2 for noble, 2 for deity
+
 
 +
(160 for chieftain, 100 for noble, 60 for deity)
 
|-
 
|-
! iHappyBonus
+
!iAIUnitCostPercent
| Sets the happiness bonus/malus for every city
+
|Modifies the unit support costs for AI (in percent)
| 6 for chieftain, 4 for noble, 4 for deity
+
 
 +
(100 for chieftain, 100 for noble, 60 for deity)
 
|-
 
|-
! iAttitudeChange
+
!iAIUnitSupplyPercent
| Sets the attitude bonus/malus for an AI with anyone else
+
|Modifies the unit supply costs for AI (in percent)
| 2 for chieftain, -1 for noble, -1 for deity
+
 
 +
(50 for chieftain, 50 for noble, 50 for deity)
 
|-
 
|-
! iNoTechTradeModifier
+
!iAIUnitUpgradePercent
| Sets a percent modifier for an AI, that determines how many techs a rival can get by trade, before the AI thinks he is becoming too advanced.
+
|Modifies the unit upgrade costs for AI (in percent)
| 100 for chieftain, 70 for noble, 20 for deity
+
 
 +
(50 for chieftain, 50 for noble, 50 for deity)
 
|-
 
|-
! iTechTradeKnownModifier
+
!iAIWarWearinessPercent
| Sets a percent modifier for an AI, that determines how much he will monopoly his techs
+
|Modifies the war weariness in AI cities (in percent)
| -100 for chieftain, 0 for noble, 0 for deity
+
 
 +
(100 for chieftain, 80 for noble, 50 for deity)
 
|-
 
|-
! iUnownedTilesPerGameAnimal
+
!iAIWorkRateModifier
| Sets how many animals can appear in a given continent or island (a value of n means that a size 50 island, with no owners, may have 10/n animals)  
+
|Sets the worker work rate modifier for AI (in percent)  
| 100 for chieftain, 50 for noble, 20 for deity
+
 
 +
(0 for chieftain, 0 for noble, 100 for deity)
 
|-
 
|-
! iUnownedTilesPerBarbarianUnit
+
!iAIWorldConstructPercent
| A factor that determines how many barbarians can appear in a given continent or island with a given unowned size
+
|Modifies the wonders cost for AI (in percent)
| 150 for chieftain, 60 for noble, 25 for deity
+
 
 +
(160 for chieftain, 100 for noble, 100 for deity)
 
|-
 
|-
! iUnownedWaterTilesPerBarbarianUnit
+
!iAIWorldCreatePercent
| A factor that determines how many barbarian ships can appear in a world with a given size
+
|Modifies the world projects cost for AI (in percent)
| 750 for chieftain, 500 for noble, 250 for deity
+
 
 +
(160 for chieftain, 100 for noble, 100 for deity)
 
|-
 
|-
! iUnownedTilesPerBarbarianCity
+
!iAIWorldTrainPercent
| A factor that determines how many barbarian cities can appear in a given continent or island with a given unowned size
+
|Modifies the world-class units cost for AI (in percent)
| 160 for chieftain, 130 for noble, 80 for deity
+
 
 +
(160 for chieftain, 100 for noble, 100 for deity)
 
|-
 
|-
! iBarbarianCreationTurnsElapsed
+
!iAnimalAttackProb
| Set how many turns have to be elapsed before barbarian units may appear
+
|Sets the aggressivity of animals, specifying their attack chance in percentage
| 50 for chieftain, 35 for noble, 10 for deity
+
 
 +
(25 for chieftain, 85 for noble, 90 for deity)
 
|-
 
|-
! iBarbarianCityCreationTurnsElapsed
+
!iAnimalBonus
| Set how many turns have to be elapsed before barbarian cities may appear
+
|Sets the combat bonus animals receive against human players (in percent)
| 55 for chieftain, 40 for noble, 15 for deity
+
 
 +
(-70 for chieftain, -40 for noble, 0 for deity)
 
|-
 
|-
! iBarbarianCityCreationProb
+
!iAttitudeChange
| A factor that determines how likely barbarian cities can appear
+
|Sets the attitude bonus/malus for an AI with anyone else
| 4 for chieftain, 6 for noble, 8 for deity
+
 
 +
(2 for chieftain, -1 for noble, -1 for deity)
 
|-
 
|-
! iAnimalBonus
+
!iBarbarianBonus
| Sets the combat bonus animals receive against human players  
+
|Sets the combat bonus barbarians receive against human players (in percent)
| -70 for chieftain, -40 for noble, 0 for deity
+
 
 +
(-40 for chieftain, -10 for noble, 0 for deity)
 
|-
 
|-
! iBarbarianBonus
+
!iBarbarianCityCreationProb
| Sets the combat bonus barbarians receive against human players
+
|A factor that determines how likely barbarian cities can appear
| -40 for chieftain, -10 for noble, 0 for deity
+
 
 +
(4 for chieftain, 6 for noble, 8 for deity)
 
|-
 
|-
! iAIAnimalBonus
+
!iBarbarianCityCreationTurnsElapsed
| Sets the combat bonus animals receive against AI players
+
|Set how many turns have to be elapsed before barbarian cities may appear
| -40 for chieftain, -40 for noble, -40 for deity
+
 
 +
(55 for chieftain, 40 for noble, 15 for deity)
 
|-
 
|-
! iAIBarbarianBonus
+
!iBarbarianCreationTurnsElapsed
| Sets the combat bonus barbarians receive against AI players
+
|Set how many turns have to be elapsed before barbarian units may appear
| -25 for chieftain, -25 for noble, -25 for deity
+
 
 +
(50 for chieftain, 35 for noble, 10 for deity)
 
|-
 
|-
! iStartingDefenseUnits
+
!iBarbarianDefenders
| Sets how many extra defensive units every player starts with
+
|Sets how many units barbarian cities will have for defense
| 0 for chieftain, 0 for noble, 0 for deity
+
 
 +
(1 for chieftain, 2 for noble, 4 for deity)
 
|-
 
|-
! iStartingWorkerUnits
+
!iCivicUpkeepPercent
| Sets how many extra workers every player starts with
+
|Sets the civics maintainance modifier (in percentage)
| 0 for chieftain, 0 for noble, 0 for deity
+
 
 +
(50 for chieftain, 80 for noble, 100 for deity)
 
|-
 
|-
! iStartingExploreUnits
+
!iColonyMaintenancePercent
| Sets how many explorer units every player starts with
+
|Sets the maintainance cost modifier for colonies (in percentage)
| 0 for chieftain, 0 for noble, 0 for deity
+
 
 +
(60 for chieftain, 100 for noble, 150 for deity)
 
|-
 
|-
! iAIStartingUnitMultiplier
+
!iCorporationMaintenancePercent
| A factor that determinates how many extra units (per unit type) AI players receive at the game starts
+
|Sets the corporations maintainance modifier (in percentage)  
| 0 for chieftain, 0 for noble, 1 for deity
+
 
 +
(60 for chieftain, 100 for noble, 150 for deity)
 
|-
 
|-
! iAIStartingDefenseUnits
+
!iDistanceMaintenancePercent
| Sets how many extra defensive units AI players start with
+
|Sets the city maintainance cost modifier for distance (in percentage)
| 0 for chieftain, 0 for noble, 4 for deity
+
 
 +
(45 for chieftain, 75 for noble, 100 for deity)
 
|-
 
|-
! iAIStartingWorkerUnits
+
!iFreeUnits
| Sets how many extra workers AI players start with
+
|Sets how many units don't need maintainance
| 0 for chieftain, 0 for noble, 1 for deity
+
 
 +
(24 for chieftain, 8 for noble, 1 for deity)
 
|-
 
|-
! iAIStartingExploreUnits
+
!iFreeWinsVsBarbs
| Sets how many explorer units AI players start with
+
|Sets how many battles are granted to be won against barbarians
| 0 for chieftain, 0 for noble, 1 for deity
+
 
 +
(5 for chieftain, 2 for noble, 0 for deity)
 
|-
 
|-
! iBarbarianDefenders
+
!iGold
| Sets how many units barbarian cities will have for defense
+
|Sets how much gold every civ starts with
| 1 for chieftain, 2 for noble, 4 for deity
 
 
|-
 
|-
! iAIDeclareWarProb
+
!iHappyBonus
| A factor that determines how likely an AI will declare war
+
|Sets the happiness bonus/malus for every city
| 25 for chieftain, 100 for noble, 100 for deity
+
 
 +
(6 for chieftain, 4 for noble, 4 for deity)
 
|-
 
|-
! iAIWorkRateModifier
+
!iHealthBonus
| Sets the worker work rate modifier for AI (in percent)
+
|Sets the health bonus/malus for every city
| 0 for chieftain, 0 for noble, 100 for deity
+
 
 +
(4 for chieftain, 2 for noble, 2 for deity)
 
|-
 
|-
! iAIGrowthPercent
+
!iInflationPercent
| Modifies how much food an AI city requires to growth (in percent)  
+
|Sets the inflation modifier (how much expenses increase as the game goes on) (in percentage)  
| 160 for chieftain, 100 for noble, 80 for deity
+
 
 +
(60 for chieftain, 90 for noble, 100 for deity)
 
|-
 
|-
! iAITrainPercent
+
!iMaxColonyMaintenance
| Modifies the standard units cost for AI (in percent)  
+
|A factor used to determine the maximum maintainance cost for colonies (in percentage)  
| 160 for chieftain, 100 for noble, 60 for deity
+
 
 +
(200 for chieftain, 200 for noble, 200 for deity)
 
|-
 
|-
! iAIWorldTrainPercent
+
!iMaxNumCitiesMaintenance
| Modifies the world-class units cost for AI (in percent)
+
|Sets the max number of cities that contribute to the city maintainance cost  
| 160 for chieftain, 100 for noble, 100 for deity
+
 
 +
(4 for chieftain, 5 for noble, 8 for deity)
 
|-
 
|-
! iAIConstructPercent
+
!iNoTechTradeModifier
| Modifies the buildings cost for AI (in percent)
+
|Sets a percent modifier for an AI, that determines how many techs a rival can get by trade, before the AI thinks he is becoming too advanced.
| 160 for chieftain, 100 for noble, 60 for deity
+
 
 +
(100 for chieftain, 70 for noble, 20 for deity)
 
|-
 
|-
! iAIWorldConstructPercent
+
!iNumCitiesMaintenancePercent
| Modifies the wonders cost for AI (in percent)  
+
|Sets the city maintainance cost modifier for number of cities (in percentage)  
| 160 for chieftain, 100 for noble, 100 for deity
+
 
 +
(40 for chieftain, 70 for noble, 100 for deity)
 
|-
 
|-
! iAICreatePercent
+
!iResearchPercent
| Modifies the non-world projects cost for AI (in percent)  
+
|Sets the technology cost modifier (in percentage)  
| 160 for chieftain, 100 for noble, 60 for deity
+
 
 +
(60 for chieftain, 100 for noble, 130 for deity)
 
|-
 
|-
! iAIWorldCreatePercent
+
!iStartingDefenseUnits
| Modifies the world projects cost for AI (in percent)
+
|Sets how many extra defensive units every player starts with
| 160 for chieftain, 100 for noble, 100 for deity
+
 
 +
(0 for chieftain, 0 for noble, 0 for deity)
 
|-
 
|-
! iAICivicUpkeepPercent
+
!iStartingExploreUnits
| Modifies the civic maintainance cost for AI (in percent)
+
|Sets how many explorer units every player starts with
| 100 for chieftain, 100 for noble, 60 for deity
+
 
 +
(0 for chieftain, 0 for noble, 0 for deity)
 
|-
 
|-
! iAIUnitCostPercent
+
!iStartingWorkerUnits
| Modifies the unit support costs for AI (in percent)
+
|Sets how many extra workers every player starts with
| 100 for chieftain, 100 for noble, 60 for deity
+
 
 +
(0 for chieftain, 0 for noble, 0 for deity)
 
|-
 
|-
! iAIUnitSupplyPercent
+
!iStartingLocPercent
| Modifies the unit supply costs for AI (in percent)
+
|Unknown
| 50 for chieftain, 50 for noble, 50 for deity
 
 
|-
 
|-
! iAIUnitUpgradePercent
+
!iTechTradeKnownModifier
| Modifies the unit upgrade costs for AI (in percent)
+
|Sets a percent modifier for an AI, that determines how much he will monopoly his techs
| 50 for chieftain, 50 for noble, 50 for deity
+
 
 +
(-100 for chieftain, 0 for noble, 0 for deity)
 
|-
 
|-
! iAIInflationPercent
+
!iUnitCostPercent
| Sets the inflation modifier for AI (how much expenses increase as the game goes on) (in percentage)  
+
|Sets the unit support cost modifier (in percentage)  
| 100 for chieftain, 80 for noble, 80 for deity
+
 
 +
(20 for chieftain, 50 for noble, 100 for deity)
 
|-
 
|-
! iAIWarWearinessPercent
+
!iUnownedTilesPerBarbarianCity
| Modifies the war weariness in AI cities (in percent)
+
|A factor that determines how many barbarian cities can appear in a given continent or island with a given unowned size
| 100 for chieftain, 80 for noble, 50 for deity
+
 
 +
(160 for chieftain, 130 for noble, 80 for deity)
 
|-
 
|-
! iAIPerEraModifier
+
!iUnownedTilesPerBarbarianUnit
| A modifier which, multiplied for the current era, affects units cost, buildings cost, projects cost, unit support, unit supply, inflation rate, war weariness, civic upkeep, required food for city growth, unit upgrade cost. (in percent)
+
|A factor that determines how many barbarians can appear in a given continent or island with a given unowned size
| 0 for chieftain, 0 for noble, -5 for deity
+
 
 +
(150 for chieftain, 60 for noble, 25 for deity)
 
|-
 
|-
! iAIAdvancedStartPercent
+
!iUnownedTilesPerGameAnimal
| Modifies the points an AI starts with in an advanced start (in percent)
+
|Sets how many animals can appear in a given continent or island (a value of n means that a size 50 island, with no owners, may have 10/n animals)
| 100 for chieftain, 100 for noble, 170 for deity
 
|-
 
! Goodies
 
| Contains a set of GoodyType. When entering a goody hut, the result is randomly picked between the entries in this set. The same item can be repeated, if you want it more likely to be picked. The possible values are specified in the Assets\Xml\GameInfo\CIV4GoodyInfo.xml file.
 
Each entry is in the form:
 
  
:<GoodyType>GOODY_HIGH_GOLD</GoodyType>
+
(100 for chieftain, 50 for noble, 20 for deity)
|
 
 
|-
 
|-
! FreeTechs
+
!iUnownedWaterTilesPerBarbarianUnit
| Contains a set of FreeTech nodes. Each specified tech is given to every player when the game starts. The possible values are specified in the Assets\Xml\Technologies\CIV4TechInfos.xml file.
+
|A factor that determines how many barbarian ships can appear in a world with a given size
Each entry is in the form:
 
  
:<FreeTech>
+
(750 for chieftain, 500 for noble, 250 for deity)
 +
|}
  
::<TechType>TECH_THE_WHEEL</TechType>
 
  
::<bFreeTech>1</bFreeTech>
+
===Lists (Multi-line)===
  
:</FreeTech>
+
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).
  
|  
+
{| border="1" style="text-align:left" cellpadding="3" cellspacing="0"
 
|-
 
|-
! AIFreeTechs
+
! style="background:#efefef;" | Tag Name
| Contains a set of FreeTech nodes. Each specified tech is given to AI players when the game starts. The possible values are specified in the Assets\Xml\Technologies\CIV4TechInfos.xml file.
+
! style="background:#efefef;" | Description
|  
 
 
|-
 
|-
 +
!AIFreeTechs
 +
|Contains a set of FreeTech nodes. Each specified tech is given to AI players when the game starts. The possible values are specified in the Assets\Xml\Technologies\CIV4TechInfos.xml file.
 +
|-
 +
!FreeTechs
 +
|Contains a set of FreeTech nodes. Each specified tech is given to every player when the game starts. The possible values are specified in the Assets\Xml\Technologies\CIV4TechInfos.xml file.
 +
|-
 +
!Goodies
 +
|Contains a set of GoodyType. When entering a goody hut, the result is randomly picked between the entries in this set. The same item can be repeated, if you want it more likely to be picked. The possible values are specified in the Assets\Xml\GameInfo\CIV4GoodyInfo.xml file.
 +
|}
 +
 +
 +
==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.
 +
 +
  <HandicapInfo>
 +
  <Type>HANDICAP_MONARCH</Type>
 +
  <Description>TXT_KEY_HANDICAP_MONARCH</Description>
 +
  <Help>TXT_KEY_HANDICAP_MONARCH_HELP</Help>
 +
  <iFreeWinsVsBarbs>0</iFreeWinsVsBarbs>
 +
  <iAnimalAttackProb>90</iAnimalAttackProb>
 +
  <iStartingLocPercent>60</iStartingLocPercent>
 +
  <iAdvancedStartPointsMod>90</iAdvancedStartPointsMod>
 +
  <iGold>0</iGold>
 +
  <iFreeUnits>4</iFreeUnits>
 +
  <iUnitCostPercent>70</iUnitCostPercent>
 +
  <iResearchPercent>115</iResearchPercent>
 +
  <iDistanceMaintenancePercent>90</iDistanceMaintenancePercent>
 +
  <iNumCitiesMaintenancePercent>85</iNumCitiesMaintenancePercent>
 +
  <iMaxNumCitiesMaintenance>6</iMaxNumCitiesMaintenance>
 +
  <iColonyMaintenancePercent>120</iColonyMaintenancePercent>
 +
  <iMaxColonyMaintenance>200</iMaxColonyMaintenance>
 +
  <iCorporationMaintenancePercent>120</iCorporationMaintenancePercent>
 +
  <iCivicUpkeepPercent>95</iCivicUpkeepPercent>
 +
  <iInflationPercent>100</iInflationPercent>
 +
  <iHealthBonus>2</iHealthBonus>
 +
  <iHappyBonus>4</iHappyBonus>
 +
  <iAttitudeChange>-1</iAttitudeChange>
 +
  <iNoTechTradeModifier>50</iNoTechTradeModifier>
 +
  <iTechTradeKnownModifier>0</iTechTradeKnownModifier>
 +
  <iUnownedTilesPerGameAnimal>35</iUnownedTilesPerGameAnimal>
 +
  <iUnownedTilesPerBarbarianUnit>40</iUnownedTilesPerBarbarianUnit>
 +
  <iUnownedWaterTilesPerBarbarianUnit>400</iUnownedWaterTilesPerBarbarianUnit>
 +
  <iUnownedTilesPerBarbarianCity>110</iUnownedTilesPerBarbarianCity>
 +
  <iBarbarianCreationTurnsElapsed>25</iBarbarianCreationTurnsElapsed>
 +
  <iBarbarianCityCreationTurnsElapsed>30</iBarbarianCityCreationTurnsElapsed>
 +
  <iBarbarianCityCreationProb>7</iBarbarianCityCreationProb>
 +
  <iAnimalBonus>-20</iAnimalBonus>
 +
  <iBarbarianBonus>0</iBarbarianBonus>
 +
  <iAIAnimalBonus>-40</iAIAnimalBonus>
 +
  <iAIBarbarianBonus>-25</iAIBarbarianBonus>
 +
  <iStartingDefenseUnits>0</iStartingDefenseUnits>
 +
  <iStartingWorkerUnits>0</iStartingWorkerUnits>
 +
  <iStartingExploreUnits>0</iStartingExploreUnits>
 +
  <iAIStartingUnitMultiplier>0</iAIStartingUnitMultiplier>
 +
  <iAIStartingDefenseUnits>1</iAIStartingDefenseUnits>
 +
  <iAIStartingWorkerUnits>0</iAIStartingWorkerUnits>
 +
  <iAIStartingExploreUnits>0</iAIStartingExploreUnits>
 +
  <iBarbarianDefenders>3</iBarbarianDefenders>
 +
  <iAIDeclareWarProb>100</iAIDeclareWarProb>
 +
  <iAIWorkRateModifier>20</iAIWorkRateModifier>
 +
  <iAIGrowthPercent>95</iAIGrowthPercent>
 +
  <iAITrainPercent>90</iAITrainPercent>
 +
  <iAIWorldTrainPercent>100</iAIWorldTrainPercent>
 +
  <iAIConstructPercent>90</iAIConstructPercent>
 +
  <iAIWorldConstructPercent>100</iAIWorldConstructPercent>
 +
  <iAICreatePercent>90</iAICreatePercent>
 +
  <iAIWorldCreatePercent>100</iAIWorldCreatePercent>
 +
  <iAICivicUpkeepPercent>90</iAICivicUpkeepPercent>
 +
  <iAIUnitCostPercent>90</iAIUnitCostPercent>
 +
  <iAIUnitSupplyPercent>50</iAIUnitSupplyPercent>
 +
  <iAIUnitUpgradePercent>50</iAIUnitUpgradePercent>
 +
  <iAIInflationPercent>80</iAIInflationPercent>
 +
  <iAIWarWearinessPercent>75</iAIWarWearinessPercent>
 +
  <iAIPerEraModifier>-2</iAIPerEraModifier>
 +
  <iAIAdvancedStartPercent>120</iAIAdvancedStartPercent>
 +
  <Goodies>
 +
    <GoodyType>GOODY_HIGH_GOLD</GoodyType>
 +
    <GoodyType>GOODY_LOW_GOLD</GoodyType>
 +
    <GoodyType>GOODY_LOW_GOLD</GoodyType>
 +
    <GoodyType>GOODY_LOW_GOLD</GoodyType>
 +
    <GoodyType>GOODY_LOW_GOLD</GoodyType>
 +
    <GoodyType>GOODY_MAP</GoodyType>
 +
    <GoodyType>GOODY_MAP</GoodyType>
 +
    <GoodyType>GOODY_WARRIOR</GoodyType>
 +
    <GoodyType>GOODY_WARRIOR</GoodyType>
 +
    <GoodyType>GOODY_SCOUT</GoodyType>
 +
    <GoodyType>GOODY_EXPERIENCE</GoodyType>
 +
    <GoodyType>GOODY_EXPERIENCE</GoodyType>
 +
    <GoodyType>GOODY_HEALING</GoodyType>
 +
    <GoodyType>GOODY_TECH</GoodyType>
 +
    <GoodyType>GOODY_TECH</GoodyType>
 +
    <GoodyType>GOODY_BARBARIANS_WEAK</GoodyType>
 +
    <GoodyType>GOODY_BARBARIANS_WEAK</GoodyType>
 +
    <GoodyType>GOODY_BARBARIANS_WEAK</GoodyType>
 +
    <GoodyType>GOODY_BARBARIANS_STRONG</GoodyType>
 +
    <GoodyType>GOODY_BARBARIANS_STRONG</GoodyType>
 +
  </Goodies>
 +
  <FreeTechs/>
 +
  <AIFreeTechs>
 +
    <FreeTech>
 +
    <TechType>TECH_ARCHERY</TechType>
 +
    <bFreeTech>1</bFreeTech>
 +
    </FreeTech>
 +
  </AIFreeTechs>
 +
  </HandicapInfo>
 +
 +
{|align="right"
 +
|[[Civ4 XML Reference|Back to XML Reference]]
 
|}
 
|}

Revision as of 12:36, 20 May 2009

The CIV4HandicapInfo.xml file sets the differences between difficulty levels.

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.

This page is missing information. Do not remove this notice until it is complete.


Note: unless specified, effects are valid for every civ (both humans and AIs)


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
HandicapInfo Main bracket for each entry
Type Label that is used throughout all other XML files


Text

Tag Name Description
Description References the Text which contains the difficulty description (eg: "settler", or "noble"). The text is specified in any of the Assets\XML\Text files.
Help References the Text which contains the tooltip for this difficulty. The text is specified in any of the Assets\XML\Text files.


Integers

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

Tag Name Description
iAdvancedStartPointsMod Sets the advanced start points modifier (in percentage)

(150 for chieftain, 100 for noble, 75 for deity)

iAIAdvancedStartPercent Modifies the points an AI starts with in an advanced start (in percent)

(100 for chieftain, 100 for noble, 170 for deity)

iAIAnimalBonus Sets the combat bonus animals receive against AI players (in percent)

(-40 for chieftain, -40 for noble, -40 for deity)

iAIBarbarianBonus Sets the combat bonus barbarians receive against AI players (in percent)

(-25 for chieftain, -25 for noble, -25 for deity)

iAICivicUpkeepPercent Modifies the civic maintainance cost for AI (in percent)

(100 for chieftain, 100 for noble, 60 for deity)

iAIConstructPercent Modifies the buildings cost for AI (in percent) (not for wonders or projects)

(160 for chieftain, 100 for noble, 60 for deity)

iAICreatePercent Modifies the non-world projects cost for AI (in percent)

(160 for chieftain, 100 for noble, 60 for deity)

iAIDeclareWarProb A factor that determines how likely an AI will declare war

(25 for chieftain, 100 for noble, 100 for deity)

iAIGrowthPercent Modifies how much food an AI city requires to grow (in percent)

(160 for chieftain, 100 for noble, 80 for deity)

iAIInflationPercent Sets the inflation modifier for AI (how much expenses increase as the game goes on) (in percentage)

(100 for chieftain, 80 for noble, 80 for deity)

iAIPerEraModifier A modifier which, multiplied for the current era, affects units cost, buildings cost, projects cost, unit support, unit supply, inflation rate, war weariness, civic upkeep, required food for city growth, unit upgrade cost. (in percent)

(0 for chieftain, 0 for noble, -5 for deity)

iAIStartingDefenseUnits Sets how many extra defensive units AI players start with

(0 for chieftain, 0 for noble, 4 for deity)

iAIStartingExploreUnits Sets how many explorer units AI players start with

(0 for chieftain, 0 for noble, 1 for deity)

iAIStartingUnitMultiplier A factor that determinates how many extra units (per unit type) AI players receive at the game starts

(0 for chieftain, 0 for noble, 1 for deity)

iAIStartingWorkerUnits Sets how many extra workers AI players start with

(0 for chieftain, 0 for noble, 1 for deity)

iAITrainPercent Modifies the standard units cost for AI (in percent)

(160 for chieftain, 100 for noble, 60 for deity)

iAIUnitCostPercent Modifies the unit support costs for AI (in percent)

(100 for chieftain, 100 for noble, 60 for deity)

iAIUnitSupplyPercent Modifies the unit supply costs for AI (in percent)

(50 for chieftain, 50 for noble, 50 for deity)

iAIUnitUpgradePercent Modifies the unit upgrade costs for AI (in percent)

(50 for chieftain, 50 for noble, 50 for deity)

iAIWarWearinessPercent Modifies the war weariness in AI cities (in percent)

(100 for chieftain, 80 for noble, 50 for deity)

iAIWorkRateModifier Sets the worker work rate modifier for AI (in percent)

(0 for chieftain, 0 for noble, 100 for deity)

iAIWorldConstructPercent Modifies the wonders cost for AI (in percent)

(160 for chieftain, 100 for noble, 100 for deity)

iAIWorldCreatePercent Modifies the world projects cost for AI (in percent)

(160 for chieftain, 100 for noble, 100 for deity)

iAIWorldTrainPercent Modifies the world-class units cost for AI (in percent)

(160 for chieftain, 100 for noble, 100 for deity)

iAnimalAttackProb Sets the aggressivity of animals, specifying their attack chance in percentage

(25 for chieftain, 85 for noble, 90 for deity)

iAnimalBonus Sets the combat bonus animals receive against human players (in percent)

(-70 for chieftain, -40 for noble, 0 for deity)

iAttitudeChange Sets the attitude bonus/malus for an AI with anyone else

(2 for chieftain, -1 for noble, -1 for deity)

iBarbarianBonus Sets the combat bonus barbarians receive against human players (in percent)

(-40 for chieftain, -10 for noble, 0 for deity)

iBarbarianCityCreationProb A factor that determines how likely barbarian cities can appear

(4 for chieftain, 6 for noble, 8 for deity)

iBarbarianCityCreationTurnsElapsed Set how many turns have to be elapsed before barbarian cities may appear

(55 for chieftain, 40 for noble, 15 for deity)

iBarbarianCreationTurnsElapsed Set how many turns have to be elapsed before barbarian units may appear

(50 for chieftain, 35 for noble, 10 for deity)

iBarbarianDefenders Sets how many units barbarian cities will have for defense

(1 for chieftain, 2 for noble, 4 for deity)

iCivicUpkeepPercent Sets the civics maintainance modifier (in percentage)

(50 for chieftain, 80 for noble, 100 for deity)

iColonyMaintenancePercent Sets the maintainance cost modifier for colonies (in percentage)

(60 for chieftain, 100 for noble, 150 for deity)

iCorporationMaintenancePercent Sets the corporations maintainance modifier (in percentage)

(60 for chieftain, 100 for noble, 150 for deity)

iDistanceMaintenancePercent Sets the city maintainance cost modifier for distance (in percentage)

(45 for chieftain, 75 for noble, 100 for deity)

iFreeUnits Sets how many units don't need maintainance

(24 for chieftain, 8 for noble, 1 for deity)

iFreeWinsVsBarbs Sets how many battles are granted to be won against barbarians

(5 for chieftain, 2 for noble, 0 for deity)

iGold Sets how much gold every civ starts with
iHappyBonus Sets the happiness bonus/malus for every city

(6 for chieftain, 4 for noble, 4 for deity)

iHealthBonus Sets the health bonus/malus for every city

(4 for chieftain, 2 for noble, 2 for deity)

iInflationPercent Sets the inflation modifier (how much expenses increase as the game goes on) (in percentage)

(60 for chieftain, 90 for noble, 100 for deity)

iMaxColonyMaintenance A factor used to determine the maximum maintainance cost for colonies (in percentage)

(200 for chieftain, 200 for noble, 200 for deity)

iMaxNumCitiesMaintenance Sets the max number of cities that contribute to the city maintainance cost

(4 for chieftain, 5 for noble, 8 for deity)

iNoTechTradeModifier Sets a percent modifier for an AI, that determines how many techs a rival can get by trade, before the AI thinks he is becoming too advanced.

(100 for chieftain, 70 for noble, 20 for deity)

iNumCitiesMaintenancePercent Sets the city maintainance cost modifier for number of cities (in percentage)

(40 for chieftain, 70 for noble, 100 for deity)

iResearchPercent Sets the technology cost modifier (in percentage)

(60 for chieftain, 100 for noble, 130 for deity)

iStartingDefenseUnits Sets how many extra defensive units every player starts with

(0 for chieftain, 0 for noble, 0 for deity)

iStartingExploreUnits Sets how many explorer units every player starts with

(0 for chieftain, 0 for noble, 0 for deity)

iStartingWorkerUnits Sets how many extra workers every player starts with

(0 for chieftain, 0 for noble, 0 for deity)

iStartingLocPercent Unknown
iTechTradeKnownModifier Sets a percent modifier for an AI, that determines how much he will monopoly his techs

(-100 for chieftain, 0 for noble, 0 for deity)

iUnitCostPercent Sets the unit support cost modifier (in percentage)

(20 for chieftain, 50 for noble, 100 for deity)

iUnownedTilesPerBarbarianCity A factor that determines how many barbarian cities can appear in a given continent or island with a given unowned size

(160 for chieftain, 130 for noble, 80 for deity)

iUnownedTilesPerBarbarianUnit A factor that determines how many barbarians can appear in a given continent or island with a given unowned size

(150 for chieftain, 60 for noble, 25 for deity)

iUnownedTilesPerGameAnimal Sets how many animals can appear in a given continent or island (a value of n means that a size 50 island, with no owners, may have 10/n animals)

(100 for chieftain, 50 for noble, 20 for deity)

iUnownedWaterTilesPerBarbarianUnit A factor that determines how many barbarian ships can appear in a world with a given size

(750 for chieftain, 500 for noble, 250 for deity)


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
AIFreeTechs Contains a set of FreeTech nodes. Each specified tech is given to AI players when the game starts. The possible values are specified in the Assets\Xml\Technologies\CIV4TechInfos.xml file.
FreeTechs Contains a set of FreeTech nodes. Each specified tech is given to every player when the game starts. The possible values are specified in the Assets\Xml\Technologies\CIV4TechInfos.xml file.
Goodies Contains a set of GoodyType. When entering a goody hut, the result is randomly picked between the entries in this set. The same item can be repeated, if you want it more likely to be picked. The possible values are specified in the Assets\Xml\GameInfo\CIV4GoodyInfo.xml file.


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.

 <HandicapInfo>
  <Type>HANDICAP_MONARCH</Type>
  <Description>TXT_KEY_HANDICAP_MONARCH</Description>
  <Help>TXT_KEY_HANDICAP_MONARCH_HELP</Help>
  <iFreeWinsVsBarbs>0</iFreeWinsVsBarbs>
  <iAnimalAttackProb>90</iAnimalAttackProb>
  <iStartingLocPercent>60</iStartingLocPercent>
  <iAdvancedStartPointsMod>90</iAdvancedStartPointsMod>
  <iGold>0</iGold>
  <iFreeUnits>4</iFreeUnits>
  <iUnitCostPercent>70</iUnitCostPercent>
  <iResearchPercent>115</iResearchPercent>
  <iDistanceMaintenancePercent>90</iDistanceMaintenancePercent>
  <iNumCitiesMaintenancePercent>85</iNumCitiesMaintenancePercent>
  <iMaxNumCitiesMaintenance>6</iMaxNumCitiesMaintenance>
  <iColonyMaintenancePercent>120</iColonyMaintenancePercent>
  <iMaxColonyMaintenance>200</iMaxColonyMaintenance>
  <iCorporationMaintenancePercent>120</iCorporationMaintenancePercent>
  <iCivicUpkeepPercent>95</iCivicUpkeepPercent>
  <iInflationPercent>100</iInflationPercent>
  <iHealthBonus>2</iHealthBonus>
  <iHappyBonus>4</iHappyBonus>
  <iAttitudeChange>-1</iAttitudeChange>
  <iNoTechTradeModifier>50</iNoTechTradeModifier>
  <iTechTradeKnownModifier>0</iTechTradeKnownModifier>
  <iUnownedTilesPerGameAnimal>35</iUnownedTilesPerGameAnimal>
  <iUnownedTilesPerBarbarianUnit>40</iUnownedTilesPerBarbarianUnit>
  <iUnownedWaterTilesPerBarbarianUnit>400</iUnownedWaterTilesPerBarbarianUnit>
  <iUnownedTilesPerBarbarianCity>110</iUnownedTilesPerBarbarianCity>
  <iBarbarianCreationTurnsElapsed>25</iBarbarianCreationTurnsElapsed>
  <iBarbarianCityCreationTurnsElapsed>30</iBarbarianCityCreationTurnsElapsed>
  <iBarbarianCityCreationProb>7</iBarbarianCityCreationProb>
  <iAnimalBonus>-20</iAnimalBonus>
  <iBarbarianBonus>0</iBarbarianBonus>
  <iAIAnimalBonus>-40</iAIAnimalBonus>
  <iAIBarbarianBonus>-25</iAIBarbarianBonus>
  <iStartingDefenseUnits>0</iStartingDefenseUnits>
  <iStartingWorkerUnits>0</iStartingWorkerUnits>
  <iStartingExploreUnits>0</iStartingExploreUnits>
  <iAIStartingUnitMultiplier>0</iAIStartingUnitMultiplier>
  <iAIStartingDefenseUnits>1</iAIStartingDefenseUnits>
  <iAIStartingWorkerUnits>0</iAIStartingWorkerUnits>
  <iAIStartingExploreUnits>0</iAIStartingExploreUnits>
  <iBarbarianDefenders>3</iBarbarianDefenders>
  <iAIDeclareWarProb>100</iAIDeclareWarProb>
  <iAIWorkRateModifier>20</iAIWorkRateModifier>
  <iAIGrowthPercent>95</iAIGrowthPercent>
  <iAITrainPercent>90</iAITrainPercent>
  <iAIWorldTrainPercent>100</iAIWorldTrainPercent>
  <iAIConstructPercent>90</iAIConstructPercent>
  <iAIWorldConstructPercent>100</iAIWorldConstructPercent>
  <iAICreatePercent>90</iAICreatePercent>
  <iAIWorldCreatePercent>100</iAIWorldCreatePercent>
  <iAICivicUpkeepPercent>90</iAICivicUpkeepPercent>
  <iAIUnitCostPercent>90</iAIUnitCostPercent>
  <iAIUnitSupplyPercent>50</iAIUnitSupplyPercent>
  <iAIUnitUpgradePercent>50</iAIUnitUpgradePercent>
  <iAIInflationPercent>80</iAIInflationPercent>
  <iAIWarWearinessPercent>75</iAIWarWearinessPercent>
  <iAIPerEraModifier>-2</iAIPerEraModifier>
  <iAIAdvancedStartPercent>120</iAIAdvancedStartPercent>
  <Goodies>
   <GoodyType>GOODY_HIGH_GOLD</GoodyType>
   <GoodyType>GOODY_LOW_GOLD</GoodyType>
   <GoodyType>GOODY_LOW_GOLD</GoodyType>
   <GoodyType>GOODY_LOW_GOLD</GoodyType>
   <GoodyType>GOODY_LOW_GOLD</GoodyType>
   <GoodyType>GOODY_MAP</GoodyType>
   <GoodyType>GOODY_MAP</GoodyType>
   <GoodyType>GOODY_WARRIOR</GoodyType>
   <GoodyType>GOODY_WARRIOR</GoodyType>
   <GoodyType>GOODY_SCOUT</GoodyType>
   <GoodyType>GOODY_EXPERIENCE</GoodyType>
   <GoodyType>GOODY_EXPERIENCE</GoodyType>
   <GoodyType>GOODY_HEALING</GoodyType>
   <GoodyType>GOODY_TECH</GoodyType>
   <GoodyType>GOODY_TECH</GoodyType>
   <GoodyType>GOODY_BARBARIANS_WEAK</GoodyType>
   <GoodyType>GOODY_BARBARIANS_WEAK</GoodyType>
   <GoodyType>GOODY_BARBARIANS_WEAK</GoodyType>
   <GoodyType>GOODY_BARBARIANS_STRONG</GoodyType>
   <GoodyType>GOODY_BARBARIANS_STRONG</GoodyType>
  </Goodies>
  <FreeTechs/>
  <AIFreeTechs>
   <FreeTech>
    <TechType>TECH_ARCHERY</TechType>
    <bFreeTech>1</bFreeTech>
   </FreeTech>
  </AIFreeTechs>
 </HandicapInfo>
Back to XML Reference