Home › Dev CE (experimental) › City

City

123 methods (Dev CE test build). this is found with the game's own ICity instance resolver (virtual).

Details

AddCityAllowedImprovement

Arguments: eImprovement — improvement type to allow in this city

Writes - city allowed-improvement list (this+0x1550)

Input checks: No validation (no -1 check, no duplicate check).

Multiplayer: may-desync, writes synchronised city state. Risk: medium (modifies replicated city data; appends without de-duplication). Confidence of the reading: medium.

AddCityHappinessModifier

Arguments: eHappiness — happiness state the modifier applies to; eYield — yield affected; eGreatPersonClass — great person class affected; iYieldChange — yield change; must be >0 unless iGreatPersonChange >0; iGreatPersonChange — great person point change

Writes - 20-byte modifier record appended to the vector held in the city's auto variable at this+0x710

Side effects - may reallocate the vector

Input checks: Silently does nothing unless iYieldChange > 0 or iGreatPersonChange > 0. Enum values are stored unchecked and not deduplicated.

Preconditions - game thread - gameplay state

Multiplayer: safe-deterministic. Risk: low (Append to a synchronised auto variable; no validation of enums.). Confidence of the reading: high.

Verified from the code - Returns without effect when both change values are not positive - Writes through FAutoVariable<VariantMap>::edit at this+0x710 and appends five 4-byte fields - Record type is typed as BeliefYield in symbols but the field is City happiness modifiers

Inferred - Record semantic is 'when city is in this happiness state, add yield/GP'

Open questions - How RemoveCityHappinessModifier matches records (see that function)

AddCityTerrainModifier

Arguments: eTerrain — terrain type the modifier applies to; eAdjacentImprovement — adjacent improvement required; eYield — yield type changed; iYieldChange — yield amount, must be > 0

Writes - city terrain modifier list (this+0x740)

Input checks: Silently ignores non-positive change and improvement -1; terrain and yield unchecked.

Multiplayer: may-desync, writes synchronised city state. Risk: medium (modifies replicated city data; appends without de-duplication). Confidence of the reading: medium.

AddCityValidTerrainImprovement

Arguments: eImprovement — improvement type; eTerrain — terrain type where it becomes valid

Writes - city valid terrain-improvement list (this+0x770)

Input checks: Silently ignores either argument being -1; no duplicate check.

Multiplayer: may-desync, writes synchronised city state. Risk: medium (modifies replicated city data; appends without de-duplication). Confidence of the reading: medium.

AddYieldPerTerrainClassCitiesImprovement

Arguments: eYield — yield type; eImprovement — improvement type; iDelta — yield amount added (inferred)

Writes - city yield-per-terrain-class list (this+0x7a0)

Input checks: Silently ignores -1 improvement or yield; delta unchecked.

Multiplayer: may-desync, writes synchronised city state. Risk: medium (modifies replicated city data; appends without de-duplication). Confidence of the reading: medium.

AddYieldPerTerrainType

Arguments: eTerrain — terrain type; eYield — yield type; xValue — fixed-point yield per matching plot (passed by pointer)

Writes - city yield-per-terrain-type list (this+0x830)

Input checks: No validation at all (no -1 or range check).

Multiplayer: may-desync, writes synchronised city state. Risk: medium (modifies replicated city data; appends without de-duplication). Confidence of the reading: medium.

ApplyOuterDefenseHealing

Arguments: iHPHealed — Fixed-point amount of HP to heal

Writes - Outer defense damage of each flagged district (ChangeDamage by negative amount)

Input checks: Skips null districts and those not flagged at offset 0x3f8; amount not validated.

Multiplayer: may-desync, modifies district damage. Risk: medium (Writes district damage). Confidence of the reading: high.

CalculateIdentityPerTurn

Arguments: eIdentityPlayer — Player whose identity per turn is calculated

Input checks: Returns 0 for NO_PLAYER; rest truncated.

Multiplayer: read-only, pure query. Risk: low (pure getter). Confidence of the reading: medium.

CalculateLoyaltyPerTurn

Input checks: No inputs.

Multiplayer: read-only, pure query. Risk: low (pure getter). Confidence of the reading: high.

CalculateYieldFromOwnedBuilding

Arguments: eBuildingType — building type to evaluate (inferred); eYield — yield type to compute (inferred)

Input checks: Checks HasBuilding, pillaged state and null definition; argument mapping in the decompilation is register-shifted, so which argument is which is uncertain.

Multiplayer: read-only, computation (flagged writes are local temporaries). Risk: low (pure getter). Confidence of the reading: low.

CalculateYieldPerTerrainType

Arguments: eYield — yield type to compute

Input checks: Skips null plots and plots worked by another city.

Multiplayer: read-only, pure computation. Risk: low (pure getter). Confidence of the reading: high.

CanBuildUnitsOfDomain

Arguments: domain — domain type (numeric)

Input checks: No range check on domain; domain 2 short-circuits to true.

Multiplayer: read-only, pure computation. Risk: low (pure getter). Confidence of the reading: medium.

CanPlaceUnit

Arguments: eUnit — unit type to place

Input checks: Null city returns false; an out-of-range unit index gives a null definition that is dereferenced unchecked; plot coordinates below -9999 treated as invalid.

Multiplayer: read-only, placement query. Risk: low (pure getter). Confidence of the reading: medium.

ChangeAccumulatedIdentity

Arguments: ePlayer — major player whose identity changes; xIdentityChange — identity delta (raw/256)

Writes - per-player identity presence list at this+0xc8 (new entry appended or existing amount changed)

Side effects - may grow the presence vector

Input checks: Does nothing unless the city's owner is Free Cities and ePlayer is major. New entries only created for positive deltas; existing entries below 0 clamp to 0; entries with the flag byte set are not changed.

Preconditions - city owned by Free Cities - valid player id - game thread

Multiplayer: may-desync: direct state edit; run on all clients. Risk: medium (EditPlayer on unchecked player id). Confidence of the reading: medium.

Verified from the code - gates on owner IsFreeCities and param IsMajor - entries are 12 bytes (player, amount, flag byte) - negative result clamped to 0; positive new entry appended

Inferred - flag byte probably marks a locked/loyal entry

Open questions - flag byte meaning - behaviour when entry search runs to end pointer is partially garbled in decompile

ChangeAllowIncomingRegionalStackingCount

Arguments: eYield — yield type; iDelta — amount added to the counter

Writes - per-yield int at array in auto variable this+0x6b0 (added to), or a fallback int at +0x18 of the container if index beyond its size

Input checks: Silent no-op if eYield is -1 or >= number of yield types. If the index is within the type range but beyond the container length, the delta goes into a fallback field instead.

Preconditions - game thread

Multiplayer: safe-deterministic. Risk: low (Bounds checked counter change.). Confidence of the reading: medium.

Verified from the code - Range check against NUM_YIELD_TYPES - Edits the auto variable at this+0x6b0 and adds iDelta to int[eYield] - Fallback add to container+0x18 when index >= container length at +0x10

Inferred - It is a reference-counted flag for regional (per-region) stacking of yields

Open questions - Purpose of the fallback field at container+0x18

ChangeCountAlwaysLoyalFlags

Arguments: iDelta — change in the number of always-loyal flags

Writes - always-loyal flag count at this+0x1a0 (value at +0x1b0)

Side effects - calls RecalculateConversionTrends

Input checks: None; count can go negative.

Preconditions - valid city - game thread

Multiplayer: may-desync: edits synchronized state. Risk: low (simple counter). Confidence of the reading: medium.

Verified from the code - new value = old + delta stored via the variable's move assignment - then RecalculateConversionTrends

Inferred - flag count above zero means city is always loyal

Open questions - how the count is consumed

ChangeExtraIdentityPerTurnPerCitizen

Arguments: xDelta — amount to add (raw/256)

Writes - extra identity per turn per citizen at this+0x1e8 (value at +0x1f8)

Side effects - none

Input checks: None; unclamped.

Preconditions - valid city - game thread

Multiplayer: may-desync: edits synchronized state. Risk: low (simple value add). Confidence of the reading: high.

Verified from the code - reads old value, adds delta from reference, stores via the variable's move assignment

Inferred - does not recompute trends here

ChangeFlatYieldBonusForDomestic

Arguments: eYield — yield type used as array index; xDelta — fixed-point amount to add

Writes - flat yield bonus for domestic routes (offset 0x68)

Input checks: ignores out-of-range yield index; no other checks

Multiplayer: may-desync, modifies synchronised city state. Risk: medium (modifies synchronised city state). Confidence of the reading: high.

ChangeFlatYieldBonusForInternational

Arguments: eYield — yield index; xDelta — amount to add (raw/256)

Writes - per-yield FixedPoint array at this+0x88 (flat bonus, international routes)

Input checks: Bounds checked: index >= array size is silently ignored.

Preconditions - valid city Trade object - yield index within yield count

Multiplayer: may-desync: direct state change without events; must run on all clients. Risk: low (bounds-checked simple add; no recalculation of displayed yields triggered). Confidence of the reading: high.

Verified from the code - unsigned bounds check against vector length - adds raw delta to element

Inferred - array is the international flat bonus table by name

Open questions - whether city yields are refreshed elsewhere

ChangeFlatYieldBonusFromOthers

Arguments: eYield — yield type used as array index; xDelta — fixed-point amount to add

Writes - flat yield bonus from other routes (offset 0x48)

Input checks: ignores out-of-range yield index; no other checks

Multiplayer: may-desync, modifies synchronised city state. Risk: medium (modifies synchronised city state). Confidence of the reading: high.

ChangeFlatYieldBonusToOthers

Arguments: eYield — yield type used as array index; xDelta — fixed-point amount to add

Writes - flat yield bonus given to others (offset 0x28)

Input checks: ignores out-of-range yield index; no other checks

Multiplayer: may-desync, modifies synchronised city state. Risk: medium (modifies synchronised city state). Confidence of the reading: high.

ChangeFlatYieldBonusToOthersForDomestic

Arguments: eYield — yield type used as array index; xDelta — fixed-point amount to add

Writes - flat yield bonus to others for domestic routes (offset 0x8)

Input checks: ignores out-of-range yield index; no other checks

Multiplayer: may-desync, modifies synchronised city state. Risk: medium (modifies synchronised city state). Confidence of the reading: high.

ChangeFollowerYieldModifier

Arguments: eYield — yield type; iDelta — amount to add

Writes - per-yield array at this+0x4d0 (element += iDelta); out-of-range yield writes to a dummy slot

Side effects - sends Reporting::Event 0xef1e2348 with city id and yield

Input checks: Out-of-range yield hits a dummy slot rather than crashing.

Preconditions - gameplay state

Multiplayer: safe-deterministic. Risk: low (Bounds handled additive change). Confidence of the reading: high.

Verified from the code - bounds checked with dummy slot - edit() before write - same event as ChangeYieldChange

Inferred - 'Follower' semantics come from the function name

Open questions - unit of the modifier (percent assumed)

ChangeGreatWorkYieldModifier

Arguments: eObjectType — great work object type; eYield — yield type affected; iYieldChange — flat yield change; iScalingFactor — scaling factor

Writes - modifier vector at this+0x68 (entry of 16 bytes appended or removed)

Side effects - may reallocate the vector

Input checks: If both values are positive an entry is appended; if either is negative, all entries matching type, yield and the negated values are removed (copying the vector); if both are zero nothing happens. No check on type/yield validity.

Preconditions - valid city - game thread

Multiplayer: may-desync: edits synchronized state; run on all clients. Risk: low (contained list edit). Confidence of the reading: medium.

Verified from the code - zero/both-nonpositive-with-a-negative triggers a rebuild of the vector without the entry equal to (type,yield,-change,-scaling) - positive case appends the 4-field entry - mixed positive and negative: positive branch tested first only if both >0

Inferred - note a mixed-sign call (one positive, one negative) is appended, not removed - removal rebuilds by copy and drops all matches

Open questions - whether the mixed-sign case is intended - consumer of the list

ChangeIdentityPerTurnFromModifiers

Arguments: xDelta — Fixed-point amount added to the modifier identity value

Writes - Identity-per-turn-from-modifiers value (this+0x1b8/0x1c8)

Side effects - Reporting::Event::Send for the city and player

Input checks: No validation of the delta.

Multiplayer: may-desync, changes synchronised city state. Risk: medium (Alters loyalty modifier). Confidence of the reading: high.

ChangeIdentityPressureFromAges

Arguments: xChange — amount to add (raw/256)

Writes - identity pressure from ages at this+0xf8 (value at +0x108)

Side effects - none

Input checks: None; unclamped.

Preconditions - valid city - game thread

Multiplayer: may-desync: edits synchronized state. Risk: low (simple value add). Confidence of the reading: high.

Verified from the code - reads old value, adds delta from reference, stores via the variable's move assignment

ChangeIdentityPressureFromModifiers

Arguments: xChange — amount to add (raw/256)

Writes - identity pressure from modifiers at this+0x140 (value at +0x150)

Side effects - none

Input checks: None; unclamped.

Preconditions - valid city - game thread

Multiplayer: may-desync: edits synchronized state. Risk: low (simple value add). Confidence of the reading: high.

Verified from the code - reads old value, adds delta from reference, stores via the variable's move assignment

ChangeNumForeignRoutesPassingThrough

Arguments: iChange — signed change to the count

Writes - foreign routes passing through count (0x230)

Input checks: clamps at 0

Multiplayer: may-desync, modifies synchronised city state. Risk: medium (modifies synchronised city state). Confidence of the reading: high.

ChangeRequiredPower

Arguments: xRequiredPower — fixed-point change in required power; eBuilding — building type the requirement belongs to; eProject — project type the requirement belongs to

Writes - total required power (0x58) - per building/project requirement list (0x60..0x70)

Input checks: does nothing unless (eBuilding == -1 or eProject == -1) and amount non-zero; clamps results at 0

Multiplayer: may-desync, modifies synchronised city state. Risk: medium (modifies synchronised city state). Confidence of the reading: medium.

ChangeRequiredPowerFromModifiers

Arguments: xRequiredPower — fixed-point change in required power from modifiers

Writes - required power from modifiers (0x5c) - fields updated by RecalculatePower

Side effects - calls RecalculatePower

Input checks: does nothing for zero; clamps at 0

Multiplayer: may-desync, modifies synchronised city state. Risk: medium (modifies synchronised city state). Confidence of the reading: high.

ChangeTourism

Arguments: eImprovement — improvement type; eObjectType — great work object type; bAffectsWonders — whether it applies to wonders; bAffectsReligiousTourism — whether it applies to religious tourism; iScalingFactor — scaling factor (positive adds, negative removes); iModifierID — modifier id the entry belongs to

Writes - tourism modifier vector at this+0x30 (20-byte entries appended or removed)

Side effects - may reallocate the vector

Input checks: Positive factor appends; negative removes all entries with the same improvement, object type, both flags and modifier id (the stored factor is not compared); zero does nothing.

Preconditions - valid city - game thread

Multiplayer: may-desync: edits synchronized state. Risk: low (contained list edit). Confidence of the reading: medium.

Verified from the code - removal path copies the vector and skips entries matching improvement, type, both flags and modifier id - append path stores the 20-byte entry

Inferred - vector element type shown as BeliefYield is probably a mislabel

Open questions - the consumer of this list

ChangeYieldChange

Arguments: eYield — yield type; iDelta — amount to add

Writes - per-yield array at this+0x530 (element += iDelta); out-of-range yield writes to a fallback slot

Side effects - sends Reporting::Event 0xef1e2348 with city id and yield (shared event with the modifier setters)

Input checks: Out-of-range or negative yield does not crash: it writes to a dummy slot at offset 0x18 of the map object.

Preconditions - gameplay state

Multiplayer: safe-deterministic. Risk: low (Bounds handled, additive change). Confidence of the reading: high.

Verified from the code - bounds check with dummy slot fallback - event always sent - edit() on the variant map

Inferred - offset +0x530 is a flat yield bonus vs +0x4a0 multiplier

Open questions - which yield calculation reads this array

ChangeYieldFromForeignRoutesPassingThrough

Arguments: eYield — yield index; xDelta — amount to add (raw/256)

Writes - per-yield FixedPoint array at this+0x148

Input checks: Bounds checked: out-of-range yield silently ignored.

Preconditions - valid city Trade object

Multiplayer: may-desync: direct state change; must run on all clients. Risk: low (bounds-checked simple add). Confidence of the reading: high.

Verified from the code - bounds check then raw add to array element

Inferred - meaning taken from the function name

ChangeYieldModifier

Arguments: eYield — yield type; iDelta — amount to add

Writes - per-yield array at this+0x4a0 (element += iDelta); out-of-range yield writes to a dummy slot

Side effects - sends Reporting::Event 0xef1e2348 with city id and yield

Input checks: Out-of-range yield hits a dummy slot rather than crashing.

Preconditions - gameplay state

Multiplayer: safe-deterministic. Risk: low (Bounds handled additive change). Confidence of the reading: high.

Verified from the code - bounds checked with dummy slot - edit() before write - event identical to the other two yield setters

Inferred - modifier is likely a percentage

Open questions - whether yields are recalculated automatically afterwards

ChangeYieldModifierPerGovernorTitle

Arguments: eYield — yield; xDelta — amount to add (raw/256)

Writes - array at this+0x500 element for yield

Side effects - Reporting::Event 0xef1e2348

Input checks: Out-of-range yield index writes to a fallback slot instead of crashing.

Preconditions - gameplay state

Multiplayer: may-desync: must be applied everywhere. Risk: low (bounded fallback). Confidence of the reading: high.

Verified from the code - bounds check with fallback slot - event includes yield

ChangeYieldPerDestinationLuxuryResourceForInternational

Arguments: eYield — yield index; xDelta — amount to add (raw/256)

Writes - per-yield FixedPoint array at this+0xe8

Input checks: Bounds checked: out-of-range yield silently ignored.

Preconditions - valid city Trade object

Multiplayer: may-desync: direct state change; must run on all clients. Risk: low (bounds-checked simple add). Confidence of the reading: high.

Verified from the code - bounds check then raw add to array element

Inferred - meaning taken from the function name

ChangeYieldPerDestinationStrategicResourceForDomestic

Arguments: eYield — yield index; xDelta — amount to add (raw/256)

Writes - per-yield FixedPoint array at this+0x108

Input checks: Bounds checked: out-of-range yield silently ignored.

Preconditions - valid city Trade object

Multiplayer: may-desync: direct state change; must run on all clients. Risk: low (bounds-checked simple add). Confidence of the reading: high.

Verified from the code - bounds check then raw add to array element

Inferred - meaning taken from the function name

ChangeYieldPerDestinationStrategicResourceForInternational

Arguments: eYield — yield index; xDelta — amount to add (raw/256)

Writes - per-yield FixedPoint array at this+0x128

Input checks: Bounds checked: out-of-range yield silently ignored.

Preconditions - valid city Trade object

Multiplayer: may-desync: direct state change; must run on all clients. Risk: low (bounds-checked simple add). Confidence of the reading: high.

Verified from the code - bounds check then raw add to array element

Inferred - meaning taken from the function name

ChangeYieldPerLocalBonusResourceForDomestic

Arguments: eYield — yield index; xDelta — amount to add (raw/256)

Writes - per-yield FixedPoint array at this+0xa8

Input checks: Bounds checked: out-of-range yield silently ignored.

Preconditions - valid city Trade object

Multiplayer: may-desync: direct state change; must run on all clients. Risk: low (bounds-checked simple add). Confidence of the reading: high.

Verified from the code - bounds check then raw add to array element

Inferred - meaning taken from the function name

ChangeYieldPerLocalBonusResourceForInternational

Arguments: eYield — yield index; xDelta — amount to add (raw/256)

Writes - per-yield FixedPoint array at this+0xc8

Input checks: Bounds checked: out-of-range yield silently ignored.

Preconditions - valid city Trade object

Multiplayer: may-desync: direct state change; must run on all clients. Risk: low (bounds-checked simple add). Confidence of the reading: high.

Verified from the code - bounds check then raw add to array element

Inferred - meaning taken from the function name

ChangeYieldPerLocalLuxuryResourceForInternational

Arguments: eYield — yield index; xDelta — amount to add (raw/256)

Writes - per-yield FixedPoint array at this+0x168

Input checks: Bounds checked: out-of-range yield silently ignored.

Preconditions - valid city Trade object

Multiplayer: may-desync: direct state change; must run on all clients. Risk: low (bounds-checked simple add). Confidence of the reading: high.

Verified from the code - bounds check then raw add to array element

Inferred - meaning taken from the function name

ChangeYieldPerLocalStrategicResourceForInternational

Arguments: eYield — yield index; xDelta — amount to add (raw/256)

Writes - per-yield FixedPoint array at this+0x188

Input checks: Bounds checked: out-of-range yield silently ignored.

Preconditions - valid city Trade object

Multiplayer: may-desync: direct state change; must run on all clients. Risk: low (bounds-checked simple add). Confidence of the reading: high.

Verified from the code - bounds check then raw add to array element

Inferred - meaning taken from the function name

ChangeYieldPerMajorTradePartner

Arguments: eYield — yield index; xDelta — amount to add (raw/256)

Writes - per-yield FixedPoint array at this+0x1a8

Input checks: Bounds checked: out-of-range yield silently ignored.

Preconditions - valid city Trade object

Multiplayer: may-desync: direct state change; must run on all clients. Risk: low (bounds-checked simple add). Confidence of the reading: high.

Verified from the code - bounds check then raw add to array element

Inferred - meaning taken from the function name

CheckNotifications

Writes - last notification turn (0xa4)

Side effects - sends a notification with localized text (power required vs available) - reads current game turn

Input checks: checks game pointer non-null; no input

Multiplayer: may-desync, sends notification and writes last-notified turn. Risk: medium (sends notification and writes city state; uses turn). Confidence of the reading: medium.

CountIncomingRoutes

Input checks: returns 0 if no current game

Multiplayer: read-only, pure getter. Risk: low (pure getter). Confidence of the reading: high.

CountOutgoingRoutes

Input checks: returns 0 if no current game

Multiplayer: read-only, pure getter. Risk: low (pure getter). Confidence of the reading: high.

DoBorderExpansion

Writes - stored culture accumulator (this+0x8) - plots-acquired count (this+0x10) - queued next-plot index (this+0x1c) - plot ownership via AnnexPlot

Side effects - annexes a plot to the city (AnnexPlot)

Input checks: Checks capability hash 0xc7331068, a block flag at this+0x28, null city and null civilization-level definition; does not otherwise validate the queued plot.

Multiplayer: may-desync, changes plot ownership and culture state. Risk: high (writes city culture and plot ownership). Confidence of the reading: medium.

DoFoundCity

Writes - city plot ownership (via AcquirePlots) - culture-side influence-token bookkeeping (via OnPlayerGaveInfluenceToken)

Side effects - acquires plots for the city

Input checks: Clamps a negative starting-plot count to 0; dereferences the owning city without a null check.

Multiplayer: may-desync, acquires plots and changes city state. Risk: high (assigns plot ownership; calling on an established city re-runs founding logic). Confidence of the reading: medium.

DoRejectedByPlayer

Arguments: ePlayer — Player that rejected the city

Writes - Identity presence list entry for ePlayer (amount zeroed, rejected flag set)

Side effects - RecalculateConversionTrends

Input checks: No check of the ePlayer value.

Multiplayer: may-desync, changes city identity state. Risk: medium (Writes presence list). Confidence of the reading: high.

DoTurnActivate

Writes - Accumulated identity per player - Other city identity fields (truncated)

Side effects - Notification (per facts) - Several internal lambdas run

Input checks: Checks free-cities status and player validity; rest truncated.

Multiplayer: may-desync, per-turn city state change. Risk: high (Changes accumulated identity). Confidence of the reading: low.

GetAccumulatedIdentityPercent

Arguments: ePlayer — Player whose share is returned

Input checks: Handles empty or zero total; ePlayer not validated.

Multiplayer: read-only, pure query. Risk: low (pure getter). Confidence of the reading: high.

GetBuildingPurchaseCost

Arguments: ePurchaseYield — yield used to pay (gold branch vs other, e.g. faith); eBuilding — building type to price

Input checks: Null building definition returns 0; no range check on the yield type.

Multiplayer: read-only, cost computation. Risk: low (pure getter). Confidence of the reading: high.

GetCityHappinessYieldModifier

Arguments: eHappiness — happiness type to match (inferred); eYield — yield type to match (inferred)

Input checks: No range checks.

Multiplayer: read-only, pure computation. Risk: low (pure getter). Confidence of the reading: medium.

GetCityTerrainAdjacentImprovementModifier

Arguments: eTerrain — terrain type to match (inferred); eAdjacentImprovement — adjacent improvement to match (inferred); eYield — yield type to match (inferred)

Input checks: No range checks.

Multiplayer: read-only, pure computation. Risk: low (pure getter). Confidence of the reading: low.

GetCultureCostNextPlot

Input checks: None; no parameters.

Multiplayer: read-only, pure computation. Risk: low (pure getter). Confidence of the reading: high.

GetCultureYield

Input checks: Relies on the owning city pointer being non-null; no checks.

Multiplayer: read-only, pure computation. Risk: low (pure getter). Confidence of the reading: medium.

GetDistrictPurchaseCost

Arguments: ePurchaseYield — yield used to pay (gold vs other); eDistrict — district type to price

Input checks: Null district definition returns 0; no range check on the yield type.

Multiplayer: read-only, cost computation. Risk: low (pure getter). Confidence of the reading: high.

GetFreePower

Input checks: none

Multiplayer: read-only, pure getter. Risk: low (pure getter). Confidence of the reading: high.

GetGoldFromCitizens

Input checks: Counter must be positive; the city pointer is not null-checked.

Multiplayer: read-only, pure computation. Risk: low (pure getter). Confidence of the reading: medium.

GetGreatWorkTourismModifier

Arguments: eObject — great work object type to match

Input checks: No range check; unmatched type returns 100.

Multiplayer: read-only, pure computation. Risk: low (pure getter). Confidence of the reading: high.

GetGreatWorkYieldChange

Arguments: eObject — great work object type to match; eYield — yield type to match

Input checks: No range check; only positive entries count and only the first match is returned.

Multiplayer: read-only, pure computation. Risk: low (pure getter). Confidence of the reading: high.

GetGreatWorkYieldModifier

Arguments: eObject — great work object type to match; eYield — yield type to match

Input checks: No range check; non-positive entries are skipped.

Multiplayer: read-only, pure computation. Risk: low (pure getter). Confidence of the reading: high.

GetHighestOuterDefenseDamage

Input checks: Skips null or unflagged districts.

Multiplayer: read-only, pure query. Risk: low (pure getter). Confidence of the reading: high.

GetIdentityPerTurnFromGovernor

Input checks: Null-checks governor.

Multiplayer: read-only, pure query. Risk: low (pure getter). Confidence of the reading: high.

GetIdentityPerTurnFromHappiness

Input checks: Free-city check only.

Multiplayer: read-only, pure query. Risk: low (pure getter). Confidence of the reading: high.

GetIdentityPerTurnFromInfluenceTokens

Input checks: Only for city states and a non-zero parameter.

Multiplayer: read-only, pure query. Risk: low (pure getter). Confidence of the reading: high.

GetIdentityPerTurnFromMartialLaw

Input checks: Checks occupied state and garrison.

Multiplayer: read-only, pure query. Risk: low (pure getter). Confidence of the reading: high.

GetIdentityPerTurnFromOccupation

Input checks: Checks the original owner is alive and different.

Multiplayer: read-only, pure query. Risk: low (pure getter). Confidence of the reading: high.

GetIdentityPerTurnFromOriginalOwnership

Input checks: Free-city check only.

Multiplayer: read-only, pure query. Risk: low (pure getter). Confidence of the reading: high.

GetIdentityPerTurnFromOwnershipBeforeOccupation

Input checks: Free-city check only.

Multiplayer: read-only, pure query. Risk: low (pure getter). Confidence of the reading: high.

GetIdentityPerTurnFromReligion

Input checks: Checks both religion values for none.

Multiplayer: read-only, pure query. Risk: low (pure getter). Confidence of the reading: high.

GetIdentityPerTurnFromStarvation

Input checks: Free-city check only.

Multiplayer: read-only, pure query. Risk: low (pure getter). Confidence of the reading: high.

GetIdentityPerTurnFromTradeRoutes

Input checks: Only iterates routes when the per-route value is non-zero.

Multiplayer: read-only, pure query. Risk: low (pure getter). Confidence of the reading: medium.

GetIdentityPerTurnPerCitizen

Input checks: Null-checks capital and project definitions.

Multiplayer: read-only, pure query. Risk: low (pure getter). Confidence of the reading: medium.

GetIdentityPressureFromOwnership

Arguments: eToPlayer — Player the pressure applies to

Input checks: Returns 0 for NO_PLAYER; clamps to non-negative.

Multiplayer: read-only, pure query. Risk: low (pure getter). Confidence of the reading: high.

GetImprovementTourismModifier

Arguments: eImprovement — improvement type to match

Input checks: No range check; unmatched type returns 100.

Multiplayer: read-only, pure computation. Risk: low (pure getter). Confidence of the reading: high.

GetLastTurnAnyDistrictDamaged

Input checks: Skips null or unflagged districts.

Multiplayer: read-only, pure query. Risk: low (pure getter). Confidence of the reading: high.

GetLoyaltyLevel

Input checks: Iterates definitions, skips null.

Multiplayer: read-only, pure query. Risk: low (pure getter). Confidence of the reading: high.

GetNonreligiousTourism

Input checks: Reads the owner via the player manager without checking the player index.

Multiplayer: read-only, pure computation. Risk: low (pure getter). Confidence of the reading: high.

GetNumStartingPlots

Input checks: Checks null city and player index -1; a null definition falls back to 0.

Multiplayer: read-only, pure computation. Risk: low (pure getter). Confidence of the reading: high.

GetReligiousTourism

Input checks: Handles a missing holy city (base 0); does not null-check the owner.

Multiplayer: read-only, pure computation. Risk: low (pure getter). Confidence of the reading: high.

GetReligiousTourismModifier

Input checks: None; no parameters.

Multiplayer: read-only, pure computation. Risk: low (pure getter). Confidence of the reading: high.

GetTourism

Input checks: None; no parameters.

Multiplayer: read-only, pure computation. Risk: low (pure getter). Confidence of the reading: high.

GetTourismFromDistricts

Input checks: Skips null district lookups.

Multiplayer: read-only, pure computation. Risk: low (pure getter). Confidence of the reading: high.

GetTourismFromFeatures

Input checks: Skips null plots and plots owned by another player or worked by another city.

Multiplayer: read-only, pure computation. Risk: low (pure getter). Confidence of the reading: high.

GetTourismFromImprovements

Input checks: Checks plot ownership, null improvement, null tourism definition, civic and tech requirements.

Multiplayer: read-only, pure computation. Risk: low (pure getter). Confidence of the reading: high.

GetTurnsLeft

Input checks: None; no parameters. The flagged writes are only local temporaries.

Multiplayer: read-only, pure computation. Risk: low (pure getter). Confidence of the reading: high.

GetUnitPurchaseCost

Arguments: ePurchaseYield — yield used to pay; eUnit — unit type to price; eFormation — formation (normal, corps, army) used for the production cost

Input checks: Checks unit index range and null definition (returns 0); no range check on yield or formation.

Multiplayer: read-only, cost computation. Risk: low (pure getter). Confidence of the reading: high.

GetWonderTourismModifier

Input checks: None; no parameters.

Multiplayer: read-only, pure computation. Risk: low (pure getter). Confidence of the reading: high.

GetYieldFromBuildings

Arguments: eYield — yield type

Input checks: None visible; cleans up a temporary breakdown vector.

Multiplayer: read-only, pure computation. Risk: low (pure getter). Confidence of the reading: medium.

GetYieldFromForeignRoutesPassingThrough

Arguments: eYield — yield type used as array index

Input checks: out-of-range index returns 0

Multiplayer: read-only, pure getter. Risk: low (pure getter). Confidence of the reading: medium.

GetYieldFromMajorTradePartners

Arguments: eYield — yield type

Input checks: Returns 0 when the per-partner yield is not positive.

Multiplayer: read-only, pure computation. Risk: low (pure getter). Confidence of the reading: medium.

GetYieldFromOutgoingTradeRoutes

Arguments: eYield — yield type

Input checks: None; delegates entirely to Trade::Manager.

Multiplayer: read-only, pure computation. Risk: low (pure getter). Confidence of the reading: medium.

GetYieldFromPopulation

Arguments: eYield — yield type

Input checks: Bounds-checks the yield index against the array, otherwise uses a default slot.

Multiplayer: read-only, pure computation. Risk: low (pure getter). Confidence of the reading: medium.

GetYieldFromTiles

Arguments: eYield — yield type

Input checks: Skips null plots and plots without workers.

Multiplayer: read-only, pure computation. Risk: low (pure getter). Confidence of the reading: medium.

GetYieldPerMajorTradePartner

Arguments: eYield — yield type used as array index

Input checks: out-of-range index returns 0

Multiplayer: read-only, pure getter. Risk: low (pure getter). Confidence of the reading: medium.

GetYieldPerTerrainClassCitiesImprovement

Arguments: eYield — yield type to match; eImprovement — improvement type to match

Input checks: No range checks.

Multiplayer: read-only, pure computation. Risk: low (pure getter). Confidence of the reading: high.

HasActiveTradingPost

Arguments: ePlayer — player whose trading post is checked

Input checks: returns false for ePlayer out of range or missing owner

Multiplayer: read-only, pure getter. Risk: low (pure getter). Confidence of the reading: high.

HasBeenRejectedByPlayer

Arguments: ePlayer — Player to check

Input checks: Not-found returns false.

Multiplayer: read-only, pure query. Risk: low (pure getter). Confidence of the reading: high.

HasCityTerrainAdjacentImprovementModifier

Arguments: eTerrain — terrain to match; eYield — yield to match

Input checks: No range checks.

Multiplayer: read-only, pure computation. Risk: low (pure getter). Confidence of the reading: high.

HasDistrict

Input checks: none needed; no inputs

Multiplayer: read-only, pure getter. Risk: low (pure getter). Confidence of the reading: high.

HasInactiveTradingPost

Arguments: ePlayer — player whose trading post is checked

Input checks: returns false for ePlayer out of range; flag lookup after war check is unguarded when owner missing

Multiplayer: read-only, pure getter. Risk: low (pure getter). Confidence of the reading: medium.

IsAllowIncomingRegionalStacking

Arguments: eYield — yield type index

Input checks: returns false for -1 or index >= NUM_YIELD_TYPES; indices beyond the array use the default field

Multiplayer: read-only, pure getter. Risk: low (pure getter). Confidence of the reading: medium.

IsAlwaysFullyLoyal

Input checks: Delegates to IsAlwaysFullyLoyalAtLocation.

Multiplayer: read-only, pure query. Risk: low (pure getter). Confidence of the reading: high.

IsCityState

Input checks: none; assumes owner id is valid

Multiplayer: read-only, pure getter. Risk: low (pure getter). Confidence of the reading: high.

IsFullyPoweredByActiveProject

Input checks: returns false when no project is in production or definitions are missing

Multiplayer: read-only, pure getter. Risk: low (pure getter). Confidence of the reading: low.

IsOccupied

Arguments: ignoreNoPenalty — if true skip the owner's no-penalty check

Input checks: none; owner lookup unchecked

Multiplayer: read-only, pure getter. Risk: low (pure getter). Confidence of the reading: high.

RecalculatePower

Writes - required power total at this+0x58 (zeroed then rebuilt) - this+0x68 reset from this+0x60 - powered flag at this+0xa0 (set to true when newly powered)

Side effects - city-powered signal dispatch (city, bool) - Reporting::Event 0xd210fbfb when surplus/deficit sign changes - calls ChangeRequiredPower per building/project

Input checks: No inputs. Skips signal if there is no current game. Requirement lookups are null-checked.

Preconditions - gameplay state - city must have an owner

Multiplayer: safe-deterministic. Risk: low (pure recalculation of derived state). Confidence of the reading: medium.

Verified from the code - only major players get building/project requirements added - only buildings that exist and are not pillaged contribute - signal sent with the city and a bool - event sent only when sign of (produced minus required) changes between before and after

Inferred - this+0x30 is power produced, +0x8 is a base amount scaled by a percent modifier - fixed-point 8 fractional bits used for requirements

Open questions - exact semantics of fields 0x5c, 0x60, 0x68 - type confusion in Find template names

RemoveCityAllowedImprovement

Arguments: eImprovement — improvement type to remove

Writes - city allowed-improvements list (offset 0x1550)

Input checks: no range check on eImprovement; if absent the list is rebuilt unchanged

Multiplayer: may-desync, modifies synchronised city state. Risk: medium (modifies synchronised city state). Confidence of the reading: medium.

RemoveCityHappinessModifier

Arguments: eHappiness — happiness type to match; eYield — yield to match; eGreatPersonClass — great person class to match; iYieldChange — yield change (checked for <0 as the trigger); iGreatPersonChange — great person change

Writes - clears and refills the modifier vector in auto variable at this+0x710

Side effects - allocates a temporary copy of the vector and frees it

Input checks: Does nothing unless iYieldChange < 0 or iGreatPersonChange < 0. Unmatched id combinations leave the list rebuilt as copied.

Preconditions - game thread

Multiplayer: safe-deterministic. Risk: medium (Matching logic looks odd (any one field equal counts as a match; after the first match later records are not re-added), so it may drop more than expected.). Confidence of the reading: low.

Verified from the code - Runs only if either amount is negative - Copies the vector, sets the live vector's end to its begin, then re-adds records - A record is considered matching if happiness OR yield OR great person class equals the argument; once matched, a flag stops all later records being re-added - Non-matching records are re-added only when both amounts differ from the arguments

Inferred - Decompilation may have merged conditions; the intended behaviour is probably removing one exact record - Caller likely passes negated amounts

Open questions - Whether the OR/AND logic is a decompiler artefact or a real game quirk - Why the first matching record and everything after is lost

RemoveCityTerrainModifier

Arguments: eTerrain — terrain type of entry; eAdjacentImprovement — adjacent improvement of entry; eYield — yield type (not used in the match shown) (inferred); iYieldChange — yield amount; must be > 0

Writes - city terrain-modifier list (offset 0x740)

Input checks: requires iYieldChange > 0 and improvement != -1; the match uses OR over terrain/improvement/amount so a loosely matching entry may be removed

Multiplayer: may-desync, modifies synchronised city state; loose match may remove wrong entry. Risk: medium (modifies synchronised city state; loose match may remove wrong entry). Confidence of the reading: medium.

RemoveCityValidTerrainImprovement

Arguments: eImprovement — improvement type; eTerrain — terrain type

Writes - city valid terrain-improvement list (offset 0x770)

Input checks: returns early if either type is -1; match uses OR so one equal field removes an entry

Multiplayer: may-desync, modifies synchronised city state. Risk: medium (modifies synchronised city state). Confidence of the reading: medium.

RemoveDynamicAdjacencyBonus

Arguments: eDistrict — district type of the bonus; eTerrain — terrain filter; eFeature — feature filter; bIsRiver — river adjacency; iAppeal — appeal value; bAdjacentDistrict — adjacent district flag; eYield — yield type

Writes - dynamic adjacency bonus vector at this+0x800 (matching elements erased)

Input checks: No validation; non-matches leave list unchanged.

Preconditions - game thread

Multiplayer: may-desync: synced city state. Risk: low (list filter). Confidence of the reading: medium.

Verified from the code - remove-if then erase on vector - match criteria are packed from all 7 parameters

Inferred - matching compares all fields (lambda not shown) - no cache refresh is triggered here

Open questions - exact lambda comparison, whether adjacency yields recalculated elsewhere

RemoveImprovementAdjacencyBonus

Arguments: eDistrict — district type of bonus; eImprovement — improvement type of bonus; eYield — yield type of bonus

Writes - city dynamic adjacency bonus list (offset 0x800)

Input checks: no validation; non-matching input erases nothing

Multiplayer: may-desync, modifies synchronised city state. Risk: medium (modifies synchronised city state). Confidence of the reading: high.

RemoveYieldPerTerrainClassCitiesImprovement

Arguments: eYield — yield type; eImprovement — improvement type; iDelta — amount of the entry

Writes - city yield-per-terrain-class improvement list (offset 0x7a0)

Input checks: returns early if yield or improvement is -1; match uses OR over the three fields

Multiplayer: may-desync, modifies synchronised city state; loose OR match. Risk: medium (modifies synchronised city state; loose OR match). Confidence of the reading: medium.

RemoveYieldPerTerrainType

Arguments: eTerrain — terrain type; eYield — yield type; xValue — fixed-point yield value to match

Writes - city yield-per-terrain-type list (offset 0x830)

Input checks: no validation; unmatched input erases nothing

Multiplayer: may-desync, modifies synchronised city state. Risk: medium (modifies synchronised city state). Confidence of the reading: high.

ResetAccumulatedIdentity

Writes - Accumulated identity per-player list emptied

Input checks: None.

Multiplayer: may-desync, clears synchronised city state. Risk: medium (Wipes city identity data). Confidence of the reading: high.

ResetCache

Writes - per-yield cached value array at this+0x1950 (capacity at +0x1958, count at +0x1960): all entries marked invalid, count set to number of yields

Side effects - may allocate a bigger block

Input checks: None needed. Protected method.

Preconditions - definitions loaded

Multiplayer: safe-deterministic. Risk: low (Only invalidates a cache.). Confidence of the reading: medium.

Verified from the code - Count comes from yield definitions list size - Grows the vector when capacity is smaller - Sets the validity byte of every 8-byte entry (value+flag) to 0 - Updates the stored count

Inferred - Each entry is a CachedValue of fixed-point with a valid flag

Open questions - The value field is written from an uninitialised local so its content is irrelevant

ResetTemporaryPower

Writes - temporary power (0x30) - list at 0x38..0x40 - list at 0x80..0x88 entries

Input checks: none

Multiplayer: may-desync, modifies synchronised city state. Risk: medium (modifies synchronised city state). Confidence of the reading: medium.

SetBuildingFaithPurchaseByDistrict

Arguments: eDistrict — district type whose buildings are affected; bNewValue — true adds one to each counter, false subtracts one

Writes - per-building int counter array at this+0x50 (+1 or -1 per matching building)

Input checks: No validation. Counters are reference counts, so unbalanced false calls go negative. Building index used unchecked into the array.

Preconditions - definitions loaded - counter array sized for all buildings

Multiplayer: safe-deterministic. Risk: low (Simple counter change; the name says Set but it increments/decrements.). Confidence of the reading: high.

Verified from the code - Iterates all building definitions - Matches when the building's district entry equals eDistrict - Adds or subtracts 1 in an int array at this+0x50 indexed by the building type

Inferred - The array is a faith-purchase enable refcount; nonzero likely means purchasable

Open questions - How the counter is later interpreted (>0?)

SetComponentID

Arguments: eOwner — owner player id; id — city id number

Writes - city id field (0xa8) - city owner field (0xd8) - FAutoArchive id (offset 0x8)

Side effects - calls FAutoArchive::SetID

Input checks: no validation

Multiplayer: may-desync, changes city identity used by archive/networking. Risk: high (changes city identity used by archive/networking). Confidence of the reading: medium.

SetOccupied

Arguments: bNewValue — new occupied flag

Writes - bool at this+0x328 (auto-variable at this+0x318)

Side effects - sends Reporting::Event 0xde2d2813 with city id when value changed

Input checks: No input checks; the event compares old and new stored value.

Preconditions - gameplay state

Multiplayer: safe-deterministic. Risk: low (Single flag write). Confidence of the reading: medium.

Verified from the code - writes through an auto-variable - event only when flag changed

Inferred - occupied means city is under foreign/captured occupation

Open questions - effects of the flag are elsewhere (e.g. yields or loyalty)

SetSiegeProtection

Arguments: bProtected — whether the city is protected from siege

Writes - siege-protection byte at this+0x18 - district siege status (via SetSiegeStatus)

Side effects - district SetSiegeStatus may update visuals/combat state

Input checks: None; assumes a valid city pointer at this+0.

Preconditions - valid city - game thread

Multiplayer: may-desync: edits gameplay state; apply on all clients. Risk: low (single flag plus status refresh). Confidence of the reading: medium.

Verified from the code - stores the bool at this+0x18 - reads district IsBesieged then calls SetSiegeStatus on the editable district with the result

Inferred - IsBesieged now takes the new protection flag into account so the status may flip

Open questions - whether SetSiegeStatus triggers notifications