查看“修正”的源代码

{{version|2.7}}
{{需要翻译}}

'''修正'''是加成或减益，由变量引用，并根据类型附加到角色，省份，宗教或好感上。

修正无处不在，可以通过多种方式附加：特质，科技，事件，文化，触发器等。

所有修正的数值均为两倍，但取决于公式中使用它们的方式，它们可能会像：
*Flat (additive): 1 means +1
*Percentage (multiplicative): 1 means +100% (i.e. x 2), 0.1 means +10% (i.e. x 1.1), etc.

==修正列表==

修正只能在正确的范围内使用。
当在错误的范围内使用修正时，它将在工具提示中显示为NONE，并将完全不执行任何操作（但是某些显示为NONE的修正实际上会有效果）：

*'''<sup>[1]</sup>角色''': Character modifiers are attached to characters and modify their personal or state abilities, their behavior (for the AI characters), or the opinion a group of people have of that character. They are primarily used in events via command <code>add_character_modifier</code>, combat [[tactics]] (for commanders), ambitions & focuses, artifacts, bloodlines, and religion <code>character_modifier</code>.
*'''特质''': Traits modifiers are used inside [[traits modding|traits]]. All character modifiers work in traits, but not vice-versa.
*'''<sup>[2]</sup>省份''': Province modifiers are attached to provinces and impact the actions of characters while they are in that province. They are added in events via <code>add_province_modifier</code> command, or via disease.
*'''内阁''': Councillor jobs modifiers give bonus to a province where the job is being performed by the councillor.
*'''科技''': Technology modifiers give bonus to a provinces which have attained that technological level. Anything that works as a province modifier will work as a tech modifier, though not vice-versa.
*'''<sup>[3]</sup>地产''': Holding modifiers are attached to individual holdings in a province with the <code>add_holding_modifier</code> command. In pre-2.4 patches, this kind of modifier was only attached via vanilla code.
*'''<sup>[4]</sup>建筑物''': Building modifiers only affect the holding they're built in. For family palace buildings, any character modifier can also be used, and will apply to its owner. Some modifiers can only work in family palaces.
*'''法律''': Laws modifiers apply to the primary title having such laws active.

Notes:
*''<holding_type>'' can be city, castle or temple
*''<unit>'' can be pikemen, light_cavalry, knights, heavy_infantry, archers or light_infantry. Entries from ''/common/special_troops'' are also valid: horse_archers, war_elephants, camel_cavalry.
*''<tech_type>'' can be economy, culture or military
*✓ means the modifier is known to work in that scope (used in vanilla or tested)
*X means the modifier is known not to work in that scope

{| class="wikitable sortable"
!Character [[attributes|attribute]] modifiers
!Description !! Type !! Character<sup>[1]</sup> !! Traits !! Province<sup>[2]</sup> !! Councillor !! Technology !! Holding<sup>[3]</sup> !! Building<sup>[4]</sup> !! Laws
|-
|diplomacy
|Diplomacy skill of a character 
|Flat
|✓||✓||X|| || || || ||
|-
|diplomacy_penalty
|Modifies diplomacy skill of character. Total bonus cannot exceed 0. 
|Flat
|✓||✓||X|| || || || ||
|-
|stewardship
|Stewardship skill of a character
|Flat
|✓||✓||X|| || || || ||
|-
|stewardship_penalty
|Modifies stewardship skill of character. Total bonus cannot exceed 0. 
|Flat
|✓||✓||X|| || || || ||
|-
|martial
|Martial skill of a character
|Flat
|✓||✓||X|| || || || ||
|-
|martial_penalty
|Modifies martial skill of character. Total bonus cannot exceed 0. 
|Flat
|✓||✓||X|| || || || ||
|-
|intrigue
|Intrigue skill of a character
|Flat
|✓||✓||X|| || || || ||
|-
|intrigue_penalty
|Modifies intrigue skill of character. Total bonus cannot exceed 0. 
|Flat
|✓||✓||X|| || || || ||
|-
|learning
|Learning skill of a character
|Flat
|✓||✓||X|| || || || ||
|-
|learning_penalty
|Modifies learning skill of character. Total bonus cannot exceed 0. 
|Flat
|✓||✓||X|| || || || ||
|-
|fertility
|Fertility of a character.
|Percent
|✓||✓||X|| || || ||✓||
|-
|fertility_penalty
|Modifies fertility of character. Total bonus cannot exceed 0. 
|Percent
|✓||✓||X|| || || || ||
|-
|health
|Health of a character
|Flat
|✓||✓||X|| || || || ||
|-
|health_penalty
|Modifies health of character. Total bonus cannot exceed 0, i.e a disease with <code>health_penalty = -1</code> combined with a treatment <code>health_penalty = 2</code> will not result in +1 health, but 0.
|Flat
|✓||✓||X|| || || || ||
|-
|combat_rating
|Duel skill of a character
|Flat
|✓||✓||X|| || || || ||
|-
|threat_decay_speed
|threat decay percentage per month
|Percent
|✓||✓|| || || || || ||
|-
!Realm modifiers
!Description !! Type !! Character<sup>[1]</sup> !! Traits !! Province<sup>[2]</sup> !! Councillor !! Technology !! Holding<sup>[3]</sup> !! Building<sup>[4]</sup> !! Laws
|-
|demesne_size
|Maximum demesne size
|Flat
|✓||✓||X|| || || || |✓||✓
|-
|vassal_limit
|Vassal limit
|Flat
|X||X||X|| || || || |X||✓
|-
|global_revolt_risk
|Revolt risk in a ruler's realm (whole provinces, not only demesne)
|Percent
|✓||✓||X|| || || || ||✓
|-
|local_revolt_risk
|Revolt risk in a in a province
|Percent
|X||X||✓||✓|| ||X|| ||
|-
|disease_defence
|Chance of a province to gain a disease
|Percent
| || ||✓|| || ||X|| ||
|-
|culture_flex
|Tolerance to other cultures
|Percent
|✓||✓||✓|| ||✓|| || ||
|-
|religion_flex
|Tolerance to other religions
|Percent
|✓||✓||✓|| ||✓|| || ||
|-
|short_reign_length
|Short reign penalty in years
|Flat
|✓|| ||✓|| ||✓|| || ||
|-
|moved_capital_months_mult
|Modifies the delay for how often one can change capital, if their government allows for more frequent switching than once per lifetime. Scripted on capital buildings.
|
| || || || || || ||✓||
|-
!Intrigue modifiers
!Description !! Type !! Character<sup>[1]</sup> !! Traits !! Province<sup>[2]</sup> !! Councillor !! Technology !! Holding<sup>[3]</sup> !! Building<sup>[4]</sup> !! Laws
|-
|assassinate_chance_modifier
|Chances to assassinate characters in a province
|Percent
|✓||✓||✓||✓|| || || ||
|-
|arrest_chance_modifier
|
|Percent
|✓||✓||✓||✓|| || || ||
|-
|plot_power_modifier
|Plot power for character's plots
|Percent
|✓||✓||X||✓|| || || ||✓
|-
|murder_plot_power_modifier
|Defaults to 1, and is multiplied with a character's plot power when it comes to murder plots.
|Percent
|✓||{{sup|✓}}||X||{{sup|✓}}|| || || ||{{sup|✓}}
|-
|defensive_plot_power_modifier
|
|Percent
|✓||{{sup|✓}}||X||{{sup|✓}}|| || || ||{{sup|✓}}
|-
|plot_discovery_chance
|Chances to uncover plots in a province
|Percent
|✓||X|| ||✓|| || || ||
|-
!Wealth, prestige, and piety
!Description !! Type !! Character<sup>[1]</sup> !! Traits !! Province<sup>[2]</sup> !! Councillor !! Technology !! Holding<sup>[3]</sup> !! Building<sup>[4]</sup> !! Laws
|-
|tax_income
|Taxes from holding in demesne
|Flat
|✓||✓||✓|| || ||✓||✓||
|-
|global_tax_modifier
|Tax gained from every province in a ruler's realm. If used as a trait, properly increases the overall demesne income but is listed as 'Stewardship' bonus.
|Percent
|✓||✓|| || || || || ||X
|-
|local_tax_modifier
|Tax gained from every holding in a province
|Percent
| ||✓||✓||✓|| ||✓||✓||
|-
|''<holding_type>''_tax_modifier
|Tax gained from castles/cities/temples in demesne
|Percent
|✓|| ||✓|| ||✓|| || ||X
|-
|''<holding_type>''_vassal_tax_modifier
|Tax gained from vassals of the government type that normally corresponds to that holding
|Percent
|✓|| || || || || || ||✓
|-
|nomad_tax_modifier
|
|
| || || || || || ||✓||
|-
|monthly_character_prestige
|Prestige of a character earned each month
|Flat
|✓||✓|| ||✓|| || ||✓||
|-
|liege_prestige
|Gives prestige to building owner and his/her liege
|
|✓||X||X|| || ||✓||✓||
|-
|add_prestige_modifier
|Modifier of character prestige gain
|Percent
|X||X||✓|| ||✓|| || ||
|-
|monthly_character_piety
|Piety of a character earned each month
|Flat
|✓||✓||✓||✓|| || ||✓||
|-
|liege_piety
|Gives piety to building owner and his/her liege
|
|✓||X||X|| || ||✓||✓||
|-
|add_piety_modifier
|Modifier of character piety gain
|Percent
|X||X||✓|| ||✓|| || ||
|-
|monthly_character_wealth
|Wealth of a character earned each month
|Flat
|✓||✓|| || || || || ||
|-
!id="AI_behavior"|AI behavior modifiers
!Description !! Type !! Character<sup>[1]</sup> !! Traits !! Province<sup>[2]</sup> !! Councillor !! Technology !! Holding<sup>[3]</sup> !! Building<sup>[4]</sup> !! Laws
|-
|ai_rationality
|Influences the way the AI makes choices, such as whether the AI will compare its own levy size with its enemy levy size if it wants to go to war.
|Flat
|X||✓|| || || || || ||
|-
|ai_zeal
|Influences the way the AI deals with religious conflict, primarily whether the AI will join crusades and neighboring holy wars.
|Flat
|X||✓|| || || || || ||
|-
|ai_greed
|Influences interactions concerning money, such as the effect of gifts on opinion as well as likelihood to ransom or start embargo wars.
|Flat
|X||✓|| || || || || ||
|-
|ai_honor
|Influences the likelihood the AI will honor relationships and alliances, and the chance of attacking despite such relations. Also affects its likelihood of joining plots.
|Flat
|X||✓|| || || || || ||
|-
|ai_ambition
|Influences the AI's desire for expansion, primarily affecting the likelihood of wanting to declare war.
|Flat
|X||✓|| || || || || ||
|-
!AI construction modifiers
!Description !! Type !! Character<sup>[1]</sup> !! Traits !! Province<sup>[2]</sup> !! Councillor !! Technology !! Holding<sup>[3]</sup> !! Building<sup>[4]</sup> !! Laws
|-
|ai_feudal_modifier
|Influences the AI's building creation weight if the ai is feudal, or if tribal but strive to become feudal
|Flat
| || || || || || ||✓||
|-
|ai_republic_modifier
|Influences the AI's building creation weight if the ai is a republic, or if tribal but strive to become a republic
|Flat
|X||X|| || || || ||✓||
|-
!Construction modifiers
!Description !! Type !! Character<sup>[1]</sup> !! Traits !! Province<sup>[2]</sup> !! Councillor !! Technology !! Holding<sup>[3]</sup> !! Building<sup>[4]</sup> !! Laws
|-
|build_cost_modifier
|Cost of constructing a building (demesne only)
|Flat
|✓||✓|| || || || || ||
|-
|build_cost_castle_modifier
|Cost of constructing a castle building
|Flat
||||| || || || || ||
|-
|build_cost_city_modifier
|Cost of constructing a city building
|Flat
||||| || || || || ||
|-
|build_cost_temple_modifier
|Cost of constructing a temple building
|Flat
|✓||{{sup|✓}}|| || || || || ||
|-
|build_cost_tribal_modifier
|Cost of constructing a tribal building
|Flat
||||| || || || || ||
|-
|build_time_modifier
|Time to construct a building (demesne only)
|Flat
|✓||✓|| || || || || ||
|-
|build_time_castle_modifier
|Time to construct a building in a castle
|Flat
||||| || || || || ||
|-
|build_time_city_modifier
|Time to construct a building in a city
|Flat
||||| || || || || ||
|-
|build_time_temple_modifier
|Time to construct a building in a temple
|Flat
||||| || || || || ||
|-
|build_time_tribal_modifier
|Time to construct a building in a tribe
|Flat
||||| || || || || ||
|-
|local_build_cost_modifier
|Cost of constructing a building in a province
|Percent
|✓||✓||✓||✓||✓||X||X<ref>[[forum:589686/page-1630#post-23600210]]</ref>||
|-
|local_build_cost_castle_modifier
|Cost of constructing a castle building in a province
|Percent
| || || || || || ||X||
|-
|local_build_cost_city_modifier
|Cost of constructing a city building in a province
|Percent
| || || || || || ||X||
|-
|local_build_cost_temple_modifier
|Cost of constructing a temple building in a province
|Percent
|{{sup|✓}}||{{sup|✓}}||{{sup|✓}}||{{sup|✓}}||{{sup|✓}}||X||X||
|-
|local_build_cost_tribal_modifier
|Cost of constructing a tribal building in a province
|Percent
| || || || || || ||X||
|-
|local_build_time_modifier
|Time to construct a building in a province
|Percent
|✓||✓||✓||✓||✓||X||X<ref>[[forum:589686/page-1630#post-23600210]]</ref>||
|-
|local_build_time_castle_modifier
|Time to construct a building in a castle
|Percent
| || || || || || ||X||
|-
|local_build_time_city_modifier
|Time to construct a building in a city
|Percent
| || || || || || ||X||
|-
|local_build_time_temple_modifier
|Time to construct a building in a temple
|Percent
| || || || || || ||X||
|-
|local_build_time_tribal_modifier
|Time to construct a building in a tribe
|Percent
| || || || || || ||X||
|- id="Opinion_modifier_types"
![[Opinion]] modifiers
!Description !! Type !! Character<sup>[1]</sup> !! Traits !! Province<sup>[2]</sup> !! Councillor !! Technology !! Holding<sup>[3]</sup> !! Building<sup>[4]</sup> !! Laws
|-
|ambition_opinion
|Changes the trait-holder's opinion of characters [[Opinion#Ambition_opinion|from which they want something]] (e.g., a county)
|Flat
|✓|| || || || || || ||
|-
|vassal_opinion
|For traits, changes opinion of direct vassals and courtiers. For artifacts, changes opinion of vassals and below.
|Flat
|✓||✓|| || || || || |✓||
|-
|sex_appeal_opinion
|Changes the opinion of adults interested in your gender. Also changes the opinion of homosexuals of the opposite gender, but only for traits, not for character modifiers or artifacts. Only active for adults below age 45 for women and 65 for men.
|Flat
|✓||✓|| || || || || |✓||
|-
|same_opinion
|Changes a character's opinion with the same trait as you
|Flat
|✓||✓|| || || || || ||
|-
|same_opinion_if_same_religion
|Changes a character's opinion with the same trait, if they have your religion
|Flat
|✓||✓|| || || || || ||
|-
|opposite_opinion
|Changes a character's opinion with a trait defined in ''opposites = { }'' of you
|Flat
|✓||✓|| || || || || ||
|-
|liege_opinion
|Changes your opinion of your liege ''OR'' changes your liege's opinion of you (depending on where it is used)
|Flat
|✓||✓|| || || || || ||
|-
|general_opinion
|Changes all characters' opinion of you
|Flat
|✓||✓|| || || || || ||
|-
|twin_opinion
|Changes your twin's opinion of you
|Flat
|✓||✓|| || || || || ||
|-
|dynasty_opinion
|Changes all dynasty members' opinion of you
|Flat
|X||✓|| || || || || ||✓
|-
|male_dynasty_opinion
|Changes all men in your dynasty's opinion of you
|Flat
|X||X|| || || || || ||✓
|-
|female_dynasty_opinion
|Changes all women in your dynasty's opinion of you
|Flat
|X||X|| || || || || ||✓
|-
|child_opinion
|Changes your children's opinion of you
|Flat
|X||X|| || || || || ||✓
|-
|oldest_child_opinion
|Changes your oldest child's opinion of you
|Flat
| ||X|| || || || || ||✓
|-
|youngest_child_opinion
|
|Flat
| ||X|| || || || || ||✓
|-
|spouse_opinion
|Changes your spouses' opinion of you
|Flat
|X||✓|| || || || || |X||
|-
|male_opinion
|
|Flat
| || || || || || || ||
|-
|female_opinion
|
|Flat
| || || || || || || ||
|-
|''<religion>''_opinion
|Changes the opinion of all characters of that religion toward the character. Custom religions can be added, but must be defined in 00_modifier_definitions.txt first.
|Flat
|✓||✓|| || || || || ||X<ref>[[forum:874495/page-27#post-21629145]]</ref>
|-
|''<religion_group>''_opinion
|Changes the opinion of all characters of that religion group toward the character. Custom religions can be added, but must be defined in 00_modifier_definitions.txt first.
|Flat
|✓||✓||X|| || || || || ]]
|-
|same_religion_opinion
|Changes same religion members' opinion of you
|Flat
|✓||✓|| || || || || ||
|-
|infidel_opinion
|Opinion of other religion groups
|Flat
|✓||✓|| || || || || ||
|-
|<''religion_group''>_church_opinion
|
|Flat
|?||✓|| || || || || ||
|-
|church_opinion
|Changes the clergy's opinion of you
|Flat
|✓||✓|| || ||✓|| ||✓||
|-
|temple_opinion
|
|Flat
| ||X|| || || || || ||✓
|-
|temple_all_opinion
|
|Flat
|✓||X|| || || || || ||
|-
|town_opinion
|
|Flat
|✓||✓|| || ||✓|| || ||
|-
|city_opinion
|Changes Burgher vassals' opinion of you
|Flat
|X||X|| || || || || ||✓
|-
|castle_opinion
|Changes Feudal vassals' opinion of you. If used in a province modifier, only has an effect if it is your capital.
|Flat
|✓|| ||✓|| ||✓|| || ||
|-
|feudal_opinion
|Opinion of direct feudal vassals
|Flat
| ||X|| || || || || |X||✓
|-
|tribal_opinion
|Opinion of tribal vassals (all tribals, including unreformed tribals)
|Flat
|✓||✓|| || || || || ||✓
|-
|unreformed_tribal_opinion
|
|Flat
|✓||✓|| || || || || ||✓
|-
|rel_head_opinion
|Opinion of character's religious head
|Flat
|✓||X|| || || || || ||
|-
|free_invest_vassal_opinion
|Opinion of vassals with bishops
|Flat
|✓||X|| || || || || ||
|-
|clan_sentiment
|
|
|{{sup|✓}}|| || || || || ||✓||
|-
![[Warfare]] modifiers
!Description !! Type !! Character<sup>[1]</sup> !! Traits !! Province<sup>[2]</sup> !! Councillor !! Technology !! Holding<sup>[3]</sup> !! Building<sup>[4]</sup> !! Laws
|-
|levy_size
|Maximum levies. Does not influence fleet size.
|Percent
|✓||✓||✓||✓|| ||✓||✓||X
|-
|''<holding_type>''_levy_size
|Maximum levies of a castle/city/temple
|Percent
| || ||✓||✓|| || || ||
|-
|global_levy_size
|Levy size modifier for characters
|Percent
|✓|| || || || || || ||
|-
|levy_reinforce_rate
|Time for levies to regenerate
|Percent
|✓||✓||✓||✓|| ||✓||✓||
|-
|army_reinforce_rate
|Time for commanded army, retinue, or horde to regenerate (i.e., if character leads centre flank)
|Percent
|✓|| || || || || || ||
|-
|phase_''<phase>''_attack
|Increases or decreases the effectiveness of the specified phase, as the attacking army.  e.g., <code>phase_melee_attack</code>.  Phase: melee, skirmish, pursue
|Percent
|✓|| || || || || || ||
|-
|phase_''<phase>''_defense
|Increases or decreases the effectiveness of the specified phase, as the defending army.
|Percent
|✓|| || || || || || ||
|-
|''<unit>''
|Adds (or removes in case of a negative number) a specified number of the given unit to the holding's levy, indirectly also increasing the holding's garrison size by the same amount.
|Flat
| || ||✓||✓|| || || ||
|-
|''<unit>''_max_levy
|archers_max_levy, etc.
|
| || || || || ||✓|| ||
|-
|''<unit>''_min_levy
|archers_min_levy etc.
|
| || || || || || || ||
|-
|''<unit>''_offensive
|
|Percent
| || ||✓|| ||✓|| ||✓||✓
|-
|''<unit>''_defensive
|
|Percent
| || || || ||✓|| ||✓||✓
|-
|''<unit>''_morale
|
|Percent
| || || || ||✓|| ||✓||
|-
|''<holding_type>''_vassal_min_levy
|Minimum levy vassals have to provide to their liege. Not cumulative between laws (takes the lowest).
|Percent
| || || || || || || ||✓
|-
|''<holding_type>''_vassal_max_levy
|Maximum levy vassals have to provide to their liege. Not cumulative between laws (takes the highest).
|Percent
| || || || || || || ||✓
|-
|land_morale
|Morale of realm army
|Percent
|✓||✓||✓|| ||✓|| ||✓||X
|-
|land_organisation
|Morale recovery rate
|Percent
|✓|| ||✓|| || || || ||
|-
|regiment_reinforcement_speed
|
|
| || ||✓|| || || || ||
|-
|garrison_size
|Size of holding garrison
|Percent
|X||X||✓||✓|| ||✓||✓||
|-
|global_garrison_size
|Garrison size modifier for characters
|Percent
|{{sup|✓}}|| || || || || || ||
|-
|garrison_growth
|Regeneration rate of holding garrison. Doesn't work in 2.2.1 will appear as NONE
|
| || ||✓||✓|| ||✓|| ||
|-
|fort_level
|Holding fort level
|Flat
|X||X||✓|| || ||✓||✓||
|-
|global_defensive
|
|
| ||X||✓|| || || || ||
|-
|land
|
|
| || ||✓|| || || || ||
|-
|global_supply_limit
|
|Percent
|X||✓||✓|| ||✓|| || ||
|-
|global_winter_supply
|Applicable on the capital.
|
| || || || || || ||✓||
|-
|supply_limit
|Amount of soldiers that can remain in a province until attrition occurs
|Percent
|X||✓||✓|| || ||X|| ||
|-
|max_attrition
|Province maximum attrition
|Percent
|✓||✓||✓|| || ||X|| ||
|-
|attrition
|Amount of attrition received by the troops being led. Not a command modifier
|Percent
|✓|| || || || || || ||
|-
|days_of_supply
|Additional days troops can go without supplies before receiving attrition. Not a command modifier
|Flat
|✓|| || || || || || ||
|-
|siege_defence
|Siege defence speed
|Percent
|✓|| ||✓|| ||✓|| || ||
|-
|siege_speed
|Siege offence speed
|Percent
|✓||✓||✓|| ||✓|| || ||
|-
|global_movement_speed
|
|Percent
| ||X||✓|| || || ||✓||
|-
|local_movement_speed
|Increases movement rate
|Percent
| || ||✓|| || ||X||X||
|-
|galleys_perc
|Number of galleys
|Percent
|X||X||✓|| ||✓|| || ||
|-
|retinuesize
|Number of retinues
|Flat
|✓||X<ref>[[forum:589686/page-1273#post-20658606]]</ref>|| || || ||✓||✓||
|-
|retinuesize_perc
|Number of retinues
|Percent
|✓|| || || || || ||✓||
|-
|retinue_maintenence_cost
|Applicable on characters, family palaces and the capital. The equivalent for tribal governments is <code>horde_maintenence_cost</code>.
|
|{{sup|✓}}||X|| || || || ||{{sup|✓}}||
|-
|horde_maintenence_cost
|Applicable on characters, family palaces and the capital.
|
|{{sup|✓}}|| || || || || ||✓||
|-
![[Technology]] modifiers
!Description !! Type !! Character<sup>[1]</sup> !! Traits !! Province<sup>[2]</sup> !! Councillor !! Technology !! Holding<sup>[3]</sup> !! Building<sup>[4]</sup> !! Laws
|-
|tech_growth_modifier
|Growth rate of all technology types.
|Percent
|X||X||X||✓|| ||✓||✓||
|-
|commander_limit
|Increases the number of commanders a ruler can have. Scripted in buildings for capital settlements.
|Flat
| || ||X|| || || ||✓||
|-
|tech_growth_modifier_''<tech_type>''
|Growth rate of cultural/military/economy technology. Cumulative with tech_growth_modifier.
|Percent
|X||X||X||✓|| || ||✓||
|-
|''<tech_type>''_techpoints
|Generation of technology points in province
|Percent
| || ||✓||✓|| ||X<ref>[[forum:589686/page-1362#post-21600911]]</ref>||✓||
|-
![[Trade post|Trade]] modifiers
!Description !! Type !! Character<sup>[1]</sup> !! Traits !! Province<sup>[2]</sup> !! Councillor !! Technology !! Holding<sup>[3]</sup> !! Building<sup>[4]</sup> !! Laws
|-
|max_tradeposts
|Maximum number of trade posts
|Flat
|X||X|| || || || ||✓||
|-
|tradevalue
|Trade zone value
|Flat
|✓||✓||✓|| || ||✓||✓||
|-
|trade_route_wealth
|
|
| || ||✓|| || || ||✓||
|-
|trade_route_value
|
|
| || ||✓|| || || ||✓||
|-
|global_trade_route_wealth
|Applicable on the capital of holders of a trade post.
|
| || || || || || ||✓||
|-
|global_trade_route_value
|Applicable on the capital of holders of a trade post.
|
| || || || || || ||✓||
|-
|global_tradevalue
|Applicable on the capital of holders of a trade post.
|
| || || || || || ||✓||
|-
|global_tradevalue_mult
|Applicable on the capital of holders of a trade post.
|
| || || || || || || ||
|-
|multiplicative_trade_post_income_modifier
|Increases trade post income by the specified percent (1.0 = +100% = double income).
|Percent
| || || || || ||✓|| ||
|-
!Population modifiers
!Description !! Type !! Character<sup>[1]</sup> !! Traits !! Province<sup>[2]</sup> !! Councillor !! Technology !! Holding<sup>[3]</sup> !! Building<sup>[4]</sup> !! Laws
|-
|population_growth
|
|
|✓|| || || || ||✓|| ||
|-
|manpower_growth
|
|
|{{sup|✓}}|| ||X||✓|| ||✓|| ||
|-
|max_population_mult
|
|Percent
|{{sup|✓}}|| ||✓|| || || ||✓||
|-
|max_manpower_mult
|
|
|✓||✓|| || || || ||{{sup|✓}}||
|-
|max_population
|
|Flat
|{{sup|✓}}|| || || || || ||✓||
|-
|}

==Custom modifiers==

Custom modifiers can be defined in <code>common/modifier_definitions</code>.

{| class="wikitable sortable"
!Flag
!Value
!Description
!Code
|-
|show_as_percent
|bool
|Show it as a percentage boost, rather than a regular number. Automatically multiplies it by 100 for display as well
|<code>show_as_percent = yes</code>
|-
|is_good
|bool
|Show positive numbers in green
|<code>is_good = yes</code>
|-
|is_monthly
|bool
|Add a "(monthly)" to the display
|<code>is_monthly = no</code>
|-
|is_hidden
|bool
|Don't show it at all
|<code>is_hidden = no</code>
|-
|max_decimals
|int
|How many numbers after the decimal point to show
|<code>max_decimals = 2</code>
|-
|show_value
|bool
|Whether to show its value at all. Setting to "no" can be useful for showing a modifier unlocks some sort of feature. Note it will only show up when the modifier is not equal to zero
|<code>show_value = no</code>
|-
|}

They are based on an hardcoded convention on their name, similarly to the <code>sympathy_<religion></code> modifier, which works for any custom religion, not only vanilla religions.

They are restricted to the following entities:

* Special units:
** <code><special_unit></code>: defines the modifier providing the troop itself. E.G., "horse_archers". It's what you'd use in the building giving the special unit.
** <code><special_unit>_offensive</code>: Defines the unit's offensive modifier. E.G., horse_archers_offensive
** <code><special_unit>_defensive</code>: Defines the unit's defensive modifier
** <code><special_unit>_morale</code>: Defines the unit's morale modifier
* Cultures: 
** <code><culture>_opinion</code>: Gives opinion bonus with specified culture, E.G., norse_opinion
** <code><culture_group>_opinion</code>: Gives opinion bonus with specified group, E.G., north_germanic_opinion
* Religions:
** <code><religion>_opinion</code>: Gives opinion bonus with specified religion, E.G., catholic_opinion
** <code><religion_group>_opinion</code>: Gives opinion bonus with specified group, E.G., muslim_opinion
* Traits:
** <code><trait>_opinion</code>: Gives opinion bonus with persons who have specified trait, E.G., genius_opinion
** <code>opinion_of_<trait></code>: Makes the character like characters who have the specified trait, E.G., opinion_of_lustful
* Offmap currency: The name of this token is defined in the offmap itself. Gives monthly offmap currency

If not matching any convention, custom modifiers with <code>show_value = no</code> can still be used to display a localized text in the tooltip of an element that accepts a modifier ( bloodlines, traits, ...). This allows to describe features that are managed externally via scripting (events, ...).

Custom modifiers are localized via the following keys:
* <code><modifier></code>: the description of the modifier
* <code><modifier>_EXPLANATION</code>: shows an explanation in places that sum up different modifiers (opinion breakdowns, ...)

==Static modifiers==

'''Static modifiers''' are global modifiers (character, province, or unit), and defined in ''/common/static_modifiers.txt''

Some of these modifiers are referenced from the code.

=== Culture modifiers ===

'''Culture modifiers''' can be used to differentiate between different cultures. 

Vanilla CK2 uses a single modifier, ''default_culture_modifier'', which does nothing and appears to simply be a placeholder. Modders can use these culture modifiers to, for example, enhance a specific culture's heavy infantry statistics, reduce or increase specific troop type numbers per holding, increase tax income, or any number of other effects.

For example, the following is a culture modifier used in the [[Elder Kings|Elder Scrolls Modification]] to differentiate unit statistics of the Nibenean from other [[culture]]s in the modification.
  nibenean_culture_modifier = {
  	pikemen_offensive = 0.1
  	pikemen_defensive = 0.1
  	light_cavalry_offensive = 0.25
  	light_cavalry_defensive = 0.25
  	knights_offensive = 0.15
  	knights_defensive = 0.15
  	heavy_infantry_offensive = -0.2
  	heavy_infantry_defensive = -0.2
  	light_infantry_offensive = -0.2
  	light_infantry_defensive = -0.2
  	archers_offensive = -0.1
  	archers_defensive = -0.1
  	
  	land_organisation = 0.1
  }


==Event modifiers==

Event modifiers are either:
*character modifiers
*province modifiers
*holding modifiers (since [[patch 2.4]])

They are stored under <code>common/event_modifiers/</code> and grouped and referenced by a name.

In addition to their modifier properties, they also have:
* an optional <code>is_visible</code> condition block, to decides if the viewer can see this trait on holder (default is yes). ROOT is the viewer, FROM is the holder.
* the optional <code>major = yes</code> property
* a mandatory <code>icon</code>, see vanilla icons below:


List of vanilla icons (positive index / negative index):
{{MultiColumn|
* Martial: [[File:Martial_positive_modifier.png]] 1 / 19
* Learning: [[File:Learning_positive_modifier.png]] 2 / 20
* Diplomacy: [[File:Diplomacy_positive_modifier.png]] 3 / 21
* Stewardship: [[File:Stewardship_positive_modifier.png]] 4 / 22
* Intrigue: [[File:Intrigue_positive_modifier.png]] 5 / 23
* Money: [[File:Money_positive_modifier.png]] 6 / 24
* Prestige: [[File:Prestige_positive_modifier.png]] 7 / 25
* Piety: [[File:Piety_positive_modifier.png]] 8 / 26
* Titles: [[File:Titles_positive_modifier.png]] 9 / 27
* Council: [[File:Council_positive_modifier.png]] 10 / 28
* Laws: [[File:Laws_positive_modifier.png]] 11 / 29
* Technology: [[File:Technology_positive_modifier.png]] 12 / 30
* Military: [[File:Military_positive_modifier.png]] 13 / 31
* Plots: [[File:Plots_positive_modifier.png]] 14 / 32
* Messages: [[File:Messages_positive_modifier.png]] 15 / 33
* Diplomatic actions: [[File:Diplomatic_actions_positive_modifier.png]] 16 / 34
* Church: [[File:Church_positive_modifier.png]] 17 / 35
* Characters: [[File:Characters_positive_modifier.png]] 18 / 36
* Prison: [[File:Prison_positive_modifier.png]] 37 / 38
* Love: [[File:Love_positive_modifier.png]] 39 / 40
* Death: [[File:Death_positive_modifier.png]] 41 / 42
* Indian religion: [[File:Indian_religion_positive_modifier.png]] 43 / 44
* Dog:  [[File:Dog_positive_modifier.png]] 45 / 65
* Cat: [[File:Cat_positive_modifier.png]] 46 / 66
* Owl: [[File:Owl_positive_modifier.png]] 47 / 67
* Pagan religion: [[File:Pagan_religion_positive_modifier.png]] 48 / 49
* Staff of Asclepius: [[File:Staff of Asclepius_positive_modifier.png]] 50 / 51
* Mystic: [[File:Mystic_positive_modifier.png]] 52 / 53
* Bonesaw: [[File:Bonesaw_positive_modifier.png]] 54 / 55
* Horseshoe: [[File:Horseshoe_positive_modifier.png]] 56 / 57
* Parrot: [[File:Parrot_positive_modifier.png]] 58 / 68
* Ham: [[File:Ham_positive_modifier.png]] 59 / 60
* Anchor: [[File:Anchor_positive_modifier.png]] 61 / 62
* Jewish religion: [[File:Jewish religion_positive_modifier.png]] 63 / 64
* Bed: [[File:Bed_positive_modifier.png]] 69 / 70
* Wolf: [[File:Wolf_positive_modifier.png]] 71 / 72
* Raven: [[File:Raven_positive_modifier.png]] 73 / 74
* Demon horns: [[File:Demon_horns_positive_modifier.png]] 75 / 76
* Trident: [[File:Trident_positive_modifier.png]] 77 / 78
* Stars: [[File:Stars_positive_modifier.png]] 79 / 80
* Eye: [[File:Eye_positive_modifier.png]] 81 / 82
* Test/tubes: [[File:Test_tubes_positive_modifier.png]] 83 / 84
* Science flask: [[File:Science_flask_positive_modifier.png]] 85 / 86
* Flower: [[File:Flower_positive_modifier.png]] 87 / 88
* Rats: [[File:Rats_positive_modifier.png]] 89 / 90
* Otter: [[File:Otter_positive_modifier.png]] 91 / 92
* Hedgehog: [[File:Hedgehog_positive_modifier.png]] 93 / 94
* Taoist: [[File:Taoist positive modifier.png]] 95 / 96
* Paper: [[File:Paper positive modifier.png]] 97 / 98
* Bamboo Book:  [[File:Bamboo book positive modifier.png]] 99 / 100
* Pagoda:   [[File:Pagoda positive modifier.png]]  101 / 102
* Firework:   [[File:Firework positive modifier.png]] 103 / 104
* Torch:  [[File:Torch positive modifier.png]]  105 / 106 
* Panda:  [[File:Panda positive modifier.png]] 107 / 108
* Dragon:  [[File:Dragon positive modifier.png]]  109 / 110
* Eagle:  [[File:Eagle positive modifier.png]]  111 /112
* Pregnancy:  [[File:Pregnancy positive modifier.png]]   113 / 114
* Evil Sword: [[File:Evil sword positive modifier.png]]  115 / 116
* Combat Skill: [[File:Combat skill old positive modifier.png]]  117 /118
* Broken Bone:  [[File:Broken bone positive modifier.png]]  119 / 120
* Chicken:  [[File:Chicken positive modifier.png]]  121 / 122
* Combat Skill (New): [[File:Combat skill new positive modifier.png]] 123 / 124
* Bear:  [[File:Bear positive modifier.png]]  125 /126
* Lion:  [[File:Lion positive modifier.png]]  127 / 128
* Rain Good:  [[File:Rain good positive modifier.png]]  129 / 130
* Rain Storm: [[File:Rain storm positive modifier.png]]  131 / 132
* Sun:  [[File:Sun positive modifier.png]]  133 / 134

|4}}

 
Example:
<pre>
sweet_temptation = {
  fertility = 0.2
  church_opinion = -20
  icon = 26
}
</pre>

Event modifiers are attached by event to a character/province via ''add_character_modifier/add_province_modifier'' [[effects]]:
<pre>
add_character_modifier = {
  modifier = sweet_temptation
  duration = -1
}
</pre>

==Triggered modifiers==

Triggered modifiers are similar to character event modifiers, except that they do not need to be attached or detached by script: depending on conditions they will automatically be applied or removed.

For performance reasons, they only apply to playable characters (counts or above). As they are evaluated every day for every landed character in existence, these are very resource intensive.

They are stored in /common/triggered_modifiers/00_triggered_modifiers.txt

Structure:
<pre>
triggered_modifier_name = {
  potential = {
    #Conditions on characters to check
  }
  trigger = {
    #Conditions for modifier to activate
  }
  icon = 24 #Same icons as event modifier icons
  active = no #Completely de-activates the modifier

  # Character modifiers go here
  land_morale = -0.25
}
</pre>

==Religion modifiers==

Religion modifiers impact the [[moral authority]] of a religion.
They are stored under <code>common/religion_modifiers/</code>.

{| class="wikitable sortable"
!Flag
!Value
!Description
!Code
|-
|authority
|int
|Percentage of religion moral authority.
|authority = -10
|-
|years
|int
|Duration of the modifier in years.
|years = 20
|-
|}

Example:
<pre>
won_holy_war = {
  authority = 3
  years = 20
}
</pre>

Religion modifiers can be attached via event with the <code>religion_authority</code> command: 
<pre>
religion_authority = {
  modifier = ruler_bowed_to_pope
  years = 10
}
</pre>

==Society modifiers==

The equivalent of religious moral authority for societies is influence.

They are stored under <code>common/event_modifiers/</code>.

{| class="wikitable sortable"
!Flag
!Value
!Description
!Code
|-
|society_influence
|int
|Percentage of society influence.
|<code>society_influence = 1</code>
|-
|}

They can also be capped via [[static modifier]]'s <code>static_modifier_cap = 10</code>.

Society modifiers are attached via event with <code>add_society_modifier</code> command.

<pre>
add_society_modifier = 	{
  modifier = successful_mission
  years = 10
}
</pre>

==Opinion modifiers==

Opinion modifiers modify the [[relations]] between two characters.
They are somehow similar to the opinion_xxx character modifiers, but apply to a single character, rather than a group of character (clergy, mayors, ...). In addition they can contain extra information, such as cause for imprisonment.
They are stored under common/opinion_modifiers/.

In [[patch 2.1.5]] some hardcoded opinion modifiers for relatives have been added for brother, half-brother, sister, half-sister, grandfather, grandmother, grandchild, uncle, aunt, nephew and niece.

{| class="wikitable sortable"
!Flag
!Value
!Description
!Code
|-
|opinion
|double
|
|<code>opinion = -30</code>
|-
|days
|int
|Duration in days
|<code>days = 120</code>
|-
|months
|int
|Duration in months
|<code>months = 120</code>
|-
|years
|int
|Duration in years
|<code>years = 3</code>
|-
|inherit
|bool
|Heirs inherit this opinion
|
<pre>opinion_supported_cardinal = {
  opinion = 15
  months = 1000
  inherit = yes
}
</pre>
|-
|decay
|bool
|Linear decay over time
|<pre>
common_interests_opinion = {
  opinion = 20
  decay = yes
}
</pre>
|-
|revoke_reason
|bool
|Gives righteous cause to revoke one title
|
<pre>
declared_war = {
  opinion = -25
  months = 160
  revoke_reason = yes
}
</pre>
|-
|prison_reason
|bool
|Gives righteous cause to imprison a character
|
<pre>
opinion_dishonorable = {
  opinion = -10
  months = 60
  prison_reason = yes
}
</pre>
|-
|execute_reason
|bool
|Gives righteous cause to execute a character
|<pre>
opinion_rebel_traitor = {
  opinion = -100
  months = 1200
  prison_reason = yes
  revoke_reason = yes
  execute_reason = yes
  inherit = yes
}
</pre>
|-
|banish_reason
|bool
|Gives righteous cause to banish a character
|<pre>
attempted_murder_of_spouse = {
  opinion = -70
  crime = yes

  prison_reason = yes
  banish_reason = yes
  execute_reason = yes
}
</pre>
|-
|preparing_adventure_against_me
|bool
|
|preparing_adventure_against_me = yes
|-
|preparing_to_invade_me
|bool
|Used by Prepared Invasion mechanic
|preparing_to_invade_me = yes
|-
|preparing_invasion
|bool
|Used by Prepared Invasion mechanic
|
<pre>
preparing_to_invade = {
  opinion = -10
  months = 24
  preparing_invasion = yes
}
</pre>
|-
|enemy
|bool
|Makes the characters enemies of each other (effectively at war)
|
<pre>
opinion_looted = {
  opinion = -40
  months = 6
  enemy = yes
}
</pre>
|-
|crime
|bool
|Character counts as a rival for the is_foe condition (committed a criminal act against me)
|
<pre>
grievously_offended = {
  opinion = -30
  months = 60
  crime = yes
  disable_non_aggression_pacts = yes
}
</pre>
|-
|disable_non_aggression_pacts
|bool
|Temporarily disables all non-aggression pacts between the two characters
|
<pre>
broken_non_aggression_pact = {
  opinion = -10
  years = 3
  disable_non_aggression_pacts = yes
}
</pre>
|-
|non_aggression_pact
|bool
|Gives a temporary [[non-aggression pact]] between the two characters
|
<pre>
in_non_aggression_pact = {
  opinion = 10
  years = 3
  non_aggression_pact = yes
}
</pre>
|-
|obedient
|bool
|The AI will accept all diplomatic interactions from the other character. Also makes the trigger <code>obedient</code> return true.
|<pre>
opinion_loyal_servant = {
  opinion = 50
  months = 1200	# For life
  obedient = yes
}
</pre>
|-
|non_interference
|bool
|The AI will accept all diplomatic interactions from the other character. Non-interference is considered a subset of obedient, so any obedient character is automatically non-interfering as well. Also makes the trigger <code>non_interference</code> return true.
|
|-
|}

Example:
<pre>
declared_war = {
  opinion = -25
  months = 160
  revoke_reason = yes
}
</pre>

Opinion modifiers can be attached via event, via the ''opinion'' effect:
<pre>
opinion = {
  modifier = opinion_shocked
  who = ROOT
  years = 2
}
</pre>

==Command modifiers==

These modifiers apply only to the command_modifier clause of traits.
They are multiplied by the number of martial points times COMMAND_MODIFIER_MARTIAL_MULTIPLIER = 0.05

{| class="wikitable sortable"
!Modifier
!Description
!Type
|-
|morale_offence
|
|Percentage
|-
|morale_defence
|
|Percentage
|-
|defence
|
|Percentage
|-
|speed
|Army movement speed
|Percentage
|-
|retreat
|
|Percentage
|-
|damage
|
|Percentage
|-
|siege
|Reduces siege time
|Percentage
|-
|random
|
|Percentage
|-
|flank
|Active when character leads a flank
|Percentage
|-
|center
|Active when character leads centre 
|Percentage
|-
|cavalry
|Both knights and light_cavalry unit types.
|Percentage
|-
|religious_enemy
|
|Percentage
|-
|''%phase%''
|
|Percentage
|-
|''%unit_type%''
|light_infantry, heavy_infantry, etc.
|Percentage
|-
|terrain
|Gives TERRAIN_SPEC_BONUS = 0.2 bonus when fighting in that terrain.
|Percentage
|-
|narrow_flank
|
|Percentage
|-
|winter_supply
|
|
|-
|winter_combat
|
|Percentage
|-
|}

For instance:
<pre>
command_modifier = {
	morale_defence = 0.1
	center = 0.1
}
</pre>

==References==

<references/>

[[Category:Modding]]
[[Category:Lists]]
{{ModdingNavbox}}