编辑“Modifiers”（章节）

== Modifier fields ==
Modifiers are applied to a scope in a modifier or triggered_modifier field.  Some objects can apply modifiers to other scopes, in which case the field includes the scope applying to.  All the following Objects have modifier fields:
{| class="wikitable sortable mw-collapsible"
|+ style="text-align: left; white-space:nowrap;" | Objects that Accept Modifiers
! Object !! Modifier field !! Field Scope !! Triggered modifier fields
|-
| [[Agenda_modding|Agendas]] || modifier = {..} || country || none
|-
| [[Tradition_modding#Ascension_Perks|Ascension Perks]] || modifier = {..} || country || none
|-
| rowspan=2 | [[Building_modding#Data_Structure|Buildings]] || planet_modifier = {..} || planet || rowspan=2 | planet
|-
|| country_modifier = {..} || country
|-
| Colony Types || planet_modifier = {..} || planet || ?
|-
| [[Ship_modding#Components|Component Templates]] || modifier = {..}<ref>This is a limited field that only accepts a few special modifiers.  See [[Ship modding#Data_Structure_5|Ship Modding]] for more information</ref><br />ship_modifier = {..} || ship || none
|-
| rowspan=3 | [[Planet_Generation_modding#Deposits|Deposits]] || planet_modifier = {..} || planet || rowspan=3 | planet
|-
|| blocked_modifier = {..} || planet
|-
|| country_modifier = {..} || country
|-
| [[Building_modding#Data_Structure|Districts]] || planet_modifier = {..} || planet || none
|-
| [[Edicts_modding|Edicts]] || modifier = {..} || country || none
|-
| rowspan=2 | Espionage Assets || passive = {..} || country || rowspan=2 | none
|-
|| active = {..} || country
|-
| [[Ethics_modding#Ethics|Ethics]] || country_modifier = {..} || country || none
|-
| [[Diplomacy_modding#Data_Structure_7|Federation Laws]] || modifier = {..} || Federation || none
|- 
| rowspan=3 | [[Diplomacy_modding#Data_Structure_5|Federation Perks]] || federation_modifier = {..} || Federation || none
|-
|| members_modifier = {..} || country
|-
|| leader_modifier = {..} || country
|-
| [[Government_modding#Authorities|Authorities]] || country_modifier = {..} || country || none
|-
| [[Government_modding#Data_Structure_3|Civics & Origins]] || modifier = {..} || country || none
|-
| rowspan=3 | [[Megastructure_modding|Megastructures]] || country_modifier = {..} || country || none
|-
|| station_modifier = {..} || megastructure || none
|-
|| ship_modifier = {..} || ship || none
|-
| Menace Perks || modifier = {..} || country || none
|-
| [[Planet_modding#Planet_rules|Planet Class]] || modifier = {..} || planet || none
|-
| [[Policies_modding|Policy Option]] || modifier = {..} || country || none
|-
| rowspan=2 | [[Pop_Job_modding#Social_Strata|Pop Categories]] || pop_modifier = {..} || pop || rowspan=2 | pop, planet
|-
|| unemployment_penalty = {..} || pop
|-
| rowspan=3 | [[Pop_Job_modding#Jobs|Pop Jobs]] || pop_modifier = {..} || pop || rowspan=3 | pop, planet, country
|-
|| planet_modifier = {..} || planet
|-
|| country_modifier = {..} || country
|-
| [[Ancestral_Relics_modding#Relics|Relics]] || none || - || country
|-
| [[Diplomacy_modding#Resolutions|Galactic Community Resolution]] || modifier = {..} || country || triggered_modifier
|-
| [[Ship_modding#Ship_Sizes|Ship Sizes]] || modifier = {..}<ref>This is a limited field that only accepts a few special modifiers.  See [[Ship modding#Data_Structure|Ship Modding]] for more information</ref><br />ship_modifier = {..} || ship || none
|-
| Species Rights || pop_modifier = {..} || pop || pop
|-
| Star Classes || modifier = {..} || galactic_object || none
|-
| rowspan=5 | [[Starbase_modding#Starbase_Modules|Starbase Buildings<br/>Starbase Modules]] || station_modifier = {..} || ship || rowspan=5 | station, country
|-
|| country_modifier = {..} || country
|-
|| ship_modifier = {..} || ship
|-
|| orbit_modifier = {..} || ship
|-
|| system_modifier = {..} || galactic_object
|-
| '''[[Modifiers#Static_modifiers|Static Modifiers]]''' || (The definition, no special code block) || (Whichever scope the Static Modifier is applied, usually via ''add_modifier = {..}'' effect || none
|-
| Technology || modifier = {..} || country || none
|-
| [[Tradition_modding#Dynamic_Modding|Traditions]] || modifier = {..} || country || tradition_swap = { ... modifier = {...} }
|-
| rowspan=2 | [[Traits_modding|Species Traits]] || modifier = {..} || species || rowspan=2 | pop
|-
|| growing_modifier = {..}<br/>assembling_modifier = {..}<br/>declining_modifier = {..} || planet
|-
| rowspan=2 | [[Traits_modding|Leader Traits]] || modifier = {..} || ruler: country<br/>governor: sector<br/>scientist (assigned to research): country (their research category only)<br/>scientist (assigned to a ship): ship<br/>admiral: fleet<br/>general: army || rowspan=2 | none
|-
|| self_modifier = {..} || leader
|}

=== Modifier Effects ===
There are three types of modifiers.
* ''add'' modifiers add/substracts a set amount of a resource or attribute to a scope
* ''mult'' modifiers increase or decrease the amount of a resource or attribute by a percentage
* ''reduction'' modifiers divide an amount of a resource or attribute by a set amount

These affect the resource or attribute amounts in different ways.  For example, if the cost, production, or upkeep of a certain resource is ''x'', then the actual amount of that resource will be:

''((x + (Sum of all '''''add''''' modifiers)) * (1 + (Sum of all '''''mult''''' modifiers))) * (1 - '''''reduction''''')''

Example:

''planet_buildings_minerals_cost_mult = 1'' would make all the buildings cost twice as much minerals.  So a '''Research Lab''' that normally costs 400 minerals would cost ''400 * (1 + '''1''') = 400 * 2 = 800'' minerals.

''planet_buildings_minerals_cost_add = 1'' would make all the buildings cost one mineral more.  So a '''Research Lab''' that normally costs 400 minerals would cost ''400 + '''1''' = 401'' minerals

''pop_growth_speed_reduction = 0.5'' would make a species grow half as fast.  If a species on planet has a base growth speed of 4, their final growth speed would be: 4 * (-1 * 0.5) = 4 * -0.5 = 2

There can be multiple modifiers effecting a single resource cost, production, or upkeep.  For instance, if the empire has a civic that applies ''planet_buildings_minerals_cost_mult = -0.1'', but the planet has a modifer that applies ''planet_buildings_minerals_cost_mult = 0.20'', then the buildings on that planet will cost 10% more: ''(400 * (1 + '''0.20''' + '''-0.1''') = 400 * (1.1) = 440'' minerals.

''Reduction'' modifiers have a larger effect than ''mult'' modifiers.  Let's say a species has a base growth speed of 3.  They have a trait with ''pop_growth_speed = 0.25'' increasing growth speed by 25%.  Their habitability on the planet gives them ''pop_growth_speed = -0.10''  The empire has a temporary modifier giving them ''pop_growth_speed_reduction = 0.25''  There final growth speed is: ''(3 * (1 + 0.25 + -0.1)) * (1 - 0.25) = (3 * 1.15) * 0.75 = 3.45 * 0.75 = 2.5875
A ''Reduction'' modifier of 1 will always result in 0, no matter what ''add'' or ''mult'' modifers are applied as well.

There could also be other modifiers in the hierarchy.  For instance, if the modifer on the planet was ''planet_structures_minerals_cost_mult = 0.20'', then districts on that planet would cost 20% more ''(500 * (1 + '''0.20''') = 500 * 1.2 = 600'' minerals, while the buildings would only be 10% more.  Since ''planet_structures'' is the parent of ''planet_buildings'', the buildings would be effected by both modifiers, but ''planet_districts'' would only be effected by the ''planet_structures_xxxx'' modifier on the planet.  Which modifiers gets applied to a resource depends on where it is in the Economic Category hierarchy, as well as where it is being applied.