Settlements

Bannerlord v1.5.7 · checked 2026-11-12 · updated 2026-11-13

Every game number of towns, castles and villages that a skill, perk, policy, building or cultural feat changes, at full precision for game v1.5.7: prosperity, loyalty, security, militia, food, tax and tariffs, construction, buildings, workshops, village production and hearths, volunteers, garrison food, governor relation rolls and the bribe to enter a keep.

NavalDLC extends (calls the base model first, then adds its own terms) eight of these numbers: security change, militia change, veteran militia chance, workshop production speed, construction power, village hearth change, tariff income and village production. It delegates (base model only) the prosperity change, the boost amount, town project income and village income.

Reading the tables

Each game number has a header table (consumer method, base, combine rule, clamp) and a source table:

• Source: the term, building, policy, feat, skill effect or perk half. Perks are named Perk (Skill, half).
• Value: the perk half's bonus (for a skill effect, its bonus per skill point). bonus in a scaling expression is this value.
• Stage: add adds to the sum, factor adds to the factor sum, multiply multiplies the running value, cap sets an upper limit, override replaces the value.
• Scaling: the amount, as an expression of the variables named in the notes.
• Conditions: what must hold for the term to apply. role=Governor means the half is read from the settlement's governor.
• Verdict: works = does what the tooltip says, or more (broader effects are noted); differs = narrower, different or extra conditions/values than the tooltip; unused = never read by the game; ui_only = only shown in the interface.

Combine rules

explained_number numbers are built by the game's standard modifier sum:

result = clamp( (base + Σ add) · (1 + Σ factor), min, max )

• Σ add: every add term. Σ factor: every factor term, summed and applied once.
• min, max: the at-least and at-most limits. The clamp is lazy: setting a limit only stores it, and the result is clamped when it is read. Terms added after a limit is set are still clamped.

sequential numbers are stored values (prosperity) or integer code paths (village income, forced volunteers) where each step applies to the running value in code order. custom numbers have their own formula, given in the notes.

Governor rules

Most perks here are governor halves. Two helpers read them, and they differ:

• AddPerkBonusForTown / GetPerkValueForTown: the town's governor must hold the perk and be in the settlement; such sites stay works. This is the default unless a note says "no presence check". Since v1.5.7 the caller of AddPerkBonusForTown names the half it applies.
• Direct governor read: no presence check. Sites that read the governor this way: Price of Loyalty (tax), Trickle Down (prosperity), Foreman (prosperity), Clockwork, Relocation and Spring of Gold (boost amount), Forest Kin and Logistician (village income), One of the Family (recruit slots), the garrison food estimate perks, and the Charm relation rolls.

Villages have no governor. A village term reads one of two towns:

• Village.Bound: the town or castle the village belongs to. Used by hearth growth (Energetic, Bush Doctor, Aid Corps), the bound-settlement buildings, and income.
• Trade-bound town: the town the village trades with. Used by village production perks (Steady, Perfect Health, Breeder, Shepherd, Granary Accountant, Tradeyard Foreman, Blessings of the Sea, Port Authority), Clean Infrastructure raid recovery, and the veteran chance of a village. A castle's governor never applies these to the castle's villages; the governor of the town they trade with does. Each such production and recovery site is differs: the game checks a different governor than the tooltip names.

Prosperity

Prosperity (stored)

Town.Prosperity. Every writer assigns Prosperity + delta; set_Prosperity raises negative values to 0, so additions apply in event order. Traced writers: the daily tick, Foreman on a building level change, and The Helmsman's Shield on a fishing party drop-off. Raid, siege and quest writers are not enumerated.

IL: TaleWorlds.CampaignSystem.Settlements.Town: set_Prosperity, DailyTick; TaleWorlds.CampaignSystem.CampaignBehaviors.BuildingsCampaignBehavior: OnBuildingLevelChanged; NavalDLC.CampaignBehaviors.FishingPartyCampaignBehavior: OnDropOff.

• Foreman: fires on any building level increase (level change > 0); no governor presence check.
• The Helmsman's Shield: governor of the village's Bound town; +1 per fishing-party drop-off.

Daily prosperity change

CalculateProsperityChange starts a standard modifier sum with base 0 and calls CalculateProsperityChangeInternal. No clamp. food_change is the town's daily food change (below). NavalDLC delegates.

IL: TaleWorlds.CampaignSystem.GameComponents.DefaultSettlementProsperityModel: CalculateProsperityChangeInternal, GetSettlementProsperityChangeDueToIssues.

• Housing costs (towns only): prosperity < 250: +6, < 500: +5, < 750: +4, < 1000: +3, < 1250: +2, < 1500: +1; > 21000: -6, > 18000: -5, > 15000: -4, > 12000: -3, > 9000: -2, > 6000: -1.
• Food shortage: while the town is starving, a local number with base truncated food_change (0 when the change is not negative) gets Helping Hands' factor, and half of it is added. The truncation is toward zero.
• Surplus food: trunc(food_stocks + food_change) - food_stocks_upper_limit, ×0.1, when positive.
• High loyalty: loyalty > 75 and food_change > 0 → +0.5. Otherwise loyalty ≤ 25 → -1.
• Policies (Road Tolls, Imperial Towns, Crown Duty, War Tax) run only for towns of a kingdom. War Tax applies whether or not the kingdom is at war, as its text says.
• Apprenticeship: projects = buildings that are not daily projects with level > 0. The factor is added only when the sum is > 0 and the running prosperity change is > 0: it scales gains only.
• Clean Infrastructure (primary): +1 per civilian building (level > 0, not military, not a daily project).
• Trickle Down: town or castle whose current building is not the default daily project; no governor presence check.
• Housing (daily project) is the only building with a Prosperity effect.

Loyalty

Daily loyalty change

Standard modifier sum with base 0, every term an add except the governor's Honor trait factor, no clamp in the model. Code order: food stocks, owner culture, policies, projects, issues, security, notable relations, governor perks, drift, then the Honor factor. Town::DailyTick adds the result to the town's loyalty; the stored value is clamped to 0-100. Model constants: security threshold 60, maximum loyalty 100, high/low security effect 1 / -2.5, owner different culture -3, drift medium 50. No sandbox_campaign override.

IL: TaleWorlds.CampaignSystem.GameComponents.DefaultSettlementLoyaltyModel: CalculateLoyaltyChangeInternal, GetSettlementLoyaltyChangeDueToIssues, GetSettlementLoyaltyChangeDueToLoyaltyDrift, GetSettlementLoyaltyChangeDueToSecurity, GetSettlementLoyaltyChangeDueToNotableRelations, GetSettlementLoyaltyChangeDueToOwnerCulture, GetSettlementLoyaltyChangeDueToFoodStocks, GetSettlementLoyaltyChangeDueToProjects, GetSettlementLoyaltyChangeDueToPolicies, GetSettlementLoyaltyChangeDueToGovernorPerks.

• Starvation: -1, one more -1 after 14 days starving.
• Security effect: security ≤ 60 maps 0..60 to -2.5..0; above 60 maps 60..100 to 0..1.
• Honor trait: trait_effect is +0.1 at Honor +1 and +0.2 at +2 for a governor who is in the town, applied only when the change is positive. The governor culture term (+1 same culture, -1 different) no longer exists.
• Notable supporters: +0.5 per notable supporting the owner clan, -0.5 per notable supporting a clan at war with the settlement's faction.
• Courthouse: 0.3 / 0.6 / 1.0 at levels 1-3. Festival and Games: +3, only while it is the current daily project.
• Hunting Rights: the tooltip says town loyalty; the code applies to every fortification, broader than the tooltip.
• Imperial Towns: +1 in a town owned by the ruling clan, -0.3 otherwise. Citizenship: +0.5 when the owner clan's culture matches the settlement's, -0.5 otherwise.
• Parade (differs): only parties in the town whose clan is the town's owner clan, and party-less heroes of the owner clan in the town, count, so it never applies in another clan's town; it stacks per holder (every hero in the main party with the perk adds 5).

Security

Daily security change

The base model builds a standard modifier sum with base 0 and adds, in order: hideouts, looted villages, siege, prosperity, garrison, policies, governor (empty body), projects (empty body), issues, perks, drift, daily security buildings, patrol parties. No factor on the main number, no clamp; the stored security is clamped to 0-100. NavalDLC extends it: after the base result, Writs of Reprisal adds -1 per lord party in the settlement.

IL: NavalDLC.GameComponents.NavalDLCSettlementSecurityModel: CalculateSecurityChange; TaleWorlds.CampaignSystem.GameComponents.DefaultSettlementSecurityModel: CalculateGarrisonEffectsOnSecurity, CalculateIssueEffectsOnSecurity, CalculateRaidedVillageEffectsOnSecurity, CalculateInfestedHideoutEffectsOnSecurity, CalculateProsperityEffectOnSecurity, CalculateSecurityDrift, CalculateUnderSiegeEffectsOnSecurity, CalculateSettlementPatrolPartiesBonuses, CalculatePolicyEffectsOnSecurity, CalculatePerkEffectsOnSecurity.

• garrison_security = total_strength · coefficient. total_strength = Σ over the garrison roster of (troop count - wounded count) · troop power; the coefficient is a local number with base 0.0075 (0.01 in v1.4.8) that Stand United multiplies (factor +0.3 → 0.00975). Stand United therefore scales the garrison term only, not the whole security change. All garrison terms need a garrison with healthy troops.
• Authority adds bonus · garrison_security. Mounted Archery and Ranger's Swiftness (stacking) and Renowned Marksmen add garrison_security · ranged share · bonus; ranged troops include crossbow troops. Relief Force uses the mounted share.
• Presence: +5 per party in the town whose clan is not at war with the town's faction and whose leader has the perk, not only while waiting, broader than the tooltip.
• Looted bound village and nearby infested hideout: -2 once each, not per village or hideout. A hideout counts within EstimatedAverageBanditPartySpeed · 24 · 0.5 map distance.
• Guard House (town): needs a patrol party; reads the building level directly, not a building effect.
• Inert: the daily security building effect is read, but no building carries it.

Worked example. A town at security 40 and prosperity 6000 with a garrison worth 3 security, Serfdom, and a governor in the town holding Authority, To Be Blunt and Skewer:

A town with security 40 and prosperity 6000, a garrison worth 3 security, Serfdom, and a governor in the town with Authority, To Be Blunt and Skewer.

With these inputs, daily security change of a town or castle is 3.7667.

The prosperity term is max(-5, -0.0005 · 6000) = -3.0000 and the drift is -(40 - 50) / 15 = +0.6667; security rises by 3.7667 a day.

Militia

Daily militia change

The base model returns 0 for a village whose state is not Normal; militia_base adds 2 for fortifications and 0.5 for villages. No factor and no clamp in the base model. Policies, perks, issues and buildings apply only to towns and castles. NavalDLC extends it: after the base result, Accuracy Training (port towns, or villages whose bound town has a port) and factor +0.25 for Bolster the Militia. Town::DailyTick adds the result to Settlement.Militia.

IL: NavalDLC.GameComponents.NavalDLCSettlementMilitiaModel: CalculateMilitiaChange; TaleWorlds.CampaignSystem.GameComponents.DefaultSettlementMilitiaModel: GetSettlementMilitiaChangeDueToIssues, CalculateMilitiaChangeInternal, GetSettlementMilitiaChangeDueToPolicies, GetSettlementMilitiaChangeDueToPerks.

• Retired militia: -0.025 · militia every day.
• Rebellious boost: in a rebellious town, prosperity / 1000 × a factor that maps loyalty 0..rebellious_threshold to 200%..0%. rebellious_threshold is 35, or 60 with the high-rebellion campaign option (25 in v1.4.8).
• Bolster the Militia: no port check, any settlement kind. A factor on a negative daily change makes it more negative.
• Accuracy Training on a village: the bound town's governor, who must be in that town.
• Cantons (differs): towns only; the policy text says daily militia production with no restriction.
• Citizenship (differs): the policy method runs only for towns and castles, so villages get nothing; the text says settlement militia with no restriction.
• Battanian militia feat (differs): adds +0.2 daily militia in towns; the feat text mentions only the veteran chance.
• Arms Dealer (differs): a flat +2 militia per day, not +2%.
• Seven Veterans (differs): its secondary also adds +0.1 to daily militia, which the tooltip does not describe.
• Inert: the militia reduction building effect is read for rebellious castles, but no building carries it.

Veteran militia chance

A 0-1 probability. Settlement::AddTroopToMilitiaParty reads the result once and, per spawned troop, spawns the veteran troop when a random roll is below chance; values ≥ 1 make every spawned militia a veteran. The base model starts from a default standard modifier sum (base 0, no limits). The governor read is the fortification's governor, or for a village the governor of the town it is bound to for trade. NavalDLC extends it with Naval Fighting Training for port towns and for villages whose bound settlement has a port.

IL: NavalDLC.GameComponents.NavalDLCSettlementMilitiaModel: CalculateVeteranMilitiaSpawnChance; TaleWorlds.CampaignSystem.GameComponents.DefaultSettlementMilitiaModel: CalculateVeteranMilitiaSpawnChance.

• Citizen Militia (differs): +0.2 on a 0-1 scale, i.e. +20 percentage points; since v1.5.7 the half is an Add and the tooltip shows +0.2%.
• Drills (differs): +1.0 on a 0-1 scale guarantees every militia is a veteran; the tooltip says +1%.
• Seven Veterans (differs): +0.1 on a 0-1 scale, i.e. +10 percentage points; the tooltip says +0.1%.
• Citizen Militia, Drills and Seven Veterans read the governor through AddPerkBonusForTown: the governor must be in the town.
• Land Grants for Veterans: factor 0.1, +10% of the summed chance, not +0.1 absolute.
• Battanian militia feat: +0.2 in any settlement whose owner clan has the feat, not only towns, broader than the feat text.
• Naval Fighting Training: castles are not covered (town-only test).

Worked example. A town with Training Fields at level 2 and a governor holding Citizen Militia and Drills, in a kingdom with Land Grants for Veterans:

A town with Training Fields at level 2, a governor with Citizen Militia and Drills, in a kingdom with Land Grants for Veterans. The chance is a 0-1 probability; anything at or above 1 makes every spawned militia a veteran.

With these inputs, chance that a spawned militia troop is a veteran is 1.4850.

The chance is 1.4850, above 1, so every spawned militia is a veteran. Drills alone gets there.

Food

Daily food change

An income number (base 0, add only) and the consumption number are built separately, then combined in a new standard modifier sum with base 0: the income is added and the consumption subtracted, then issue effects. No clamp. Town::DailyTick adds the change to the food stocks and clamps the stocks to 0..the food stock upper limit. No sandbox_campaign override.

IL: TaleWorlds.CampaignSystem.GameComponents.DefaultSettlementFoodModel: CalculateTownFoodChangeInternal, GetSettlementFoodChangeDueToIssues.

• Lands around the settlement: +15 town, +10 castle, when not under siege.
• Bound villages: (hearth level + 1) · 6 per bound village in the Normal state.
• Farmlands (castle): 6 / 12 / 18; no town building carries the food production effect.
• Food stores sold in the market: only when market stocks are included.
• Hunting Rights: +2, also under siege.
• Dirty Fighting (differs): adds +2 to the besieged town's daily food change; no food items are smuggled. The siege branch replaces the land and bound-village terms.

Food consumption

IL: TaleWorlds.CampaignSystem.GameComponents.DefaultSettlementFoodModel: CalculateTownFoodChangeInternal.

Waterworks: -0.05 / -0.1 / -0.15. Triage Tent applies to the whole consumption number, population and garrison.

Population food

IL: TaleWorlds.CampaignSystem.GameComponents.DefaultSettlementFoodModel: CalculateTownFoodChangeInternal.

Only Master of Warcraft changes it.

Garrison food

IL: TaleWorlds.CampaignSystem.GameComponents.DefaultSettlementFoodModel: CalculateTownFoodChangeInternal.

garrison_members is the garrison party's total member count (0 without a garrison). Generosity trait: trait_effect is +0.1 at Generosity +1 and +2 for a governor who is in the town.

Tax and tariffs

Daily tax

CalculateTownTax starts a standard modifier sum with base 0. CalculateDailyTax adds base_tax = Prosperity · 0.35 · (1 - 0.05 with Council of the Commons); then policy gold cuts (add, proportional to base_tax), perks, the Khuzait feat, issues, security, loyalty and buildings; clamp to 0 at the lower end, no upper limit. AddSettlementIncome adds the truncated result per fief to clan income. No override.

IL: TaleWorlds.CampaignSystem.GameComponents.DefaultSettlementTaxModel: CalculateDailyTaxInternal, GetSettlementTaxChangeDueToIssues, CalculateSettlementTaxDueToLoyalty, CalculateSettlementTaxDueToBuildings, CalculatePolicyGoldCut, CalculateDailyTax; TaleWorlds.CampaignSystem.GameComponents.DefaultSettlementLoyaltyModel: CalculateGoldGainDueToHighLoyalty, CalculateGoldCutDueToLowLoyalty; TaleWorlds.CampaignSystem.GameComponents.DefaultSettlementSecurityModel: CalculateGoldGainDueToHighSecurity, CalculateGoldCutDueToLowSecurity.

• High loyalty (≥ 75): factor maps loyalty 75..100 to 0..0.2. Low loyalty (25-50): maps 25..50 to -0.5..0. Below 25: factor -1; positive factors still apply on top, so the tax is not forced to 0.
• High security (≥ 75): maps 75..100 to 0..0.05. Low security (< 50): -0.1 at security 0, rising to 0 at 50.
• Price of Loyalty: bonus · (Steward - 200), only when the governor's Steward is above 200 (the perk itself needs 275); no presence check.
• Craftsman's Quarters (castle): 0.2 / 0.4 / 0.6 per bound village hearth; the same building also adds to town project income.
• Cantons cuts castles as well as towns.
• Tribunes of the People (differs): the text says town taxes paid to the ruler are reduced by 5%; the code cuts 5% of every kingdom town's tax for its owner clan, ruler or not.

Tariff income

Base: the truncated accumulated trade tax / 5. With withdrawals the rounded base is subtracted from the accumulator. NavalDLC extends it: after the base result, factor -0.1 for Arsenals of State. AddSettlementIncome adds the truncated result.

IL: NavalDLC.GameComponents.NavalDLCClanFinanceModel: CalculateTownIncomeFromTariffs; TaleWorlds.CampaignSystem.GameComponents.DefaultClanFinanceModel: CalculateSettlementProjectTariffBonuses, CalculateTownIncomeFromTariffs.

Town project income

Default standard modifier sum (base 0); returns the truncated result. NavalDLC delegates.

IL: TaleWorlds.CampaignSystem.GameComponents.DefaultClanFinanceModel: CalculateTownIncomeFromProjects.

Architectural Commissions: needs a current default (daily) building and, since v1.5.7, the governor in the town.

Village income

Integer arithmetic in code order: income = trunc(accumulated trade tax / 5), 0 when Looted or BeingRaided; Land Tax income -= trunc(0.05 · income); Forest Kin income += round(income · bonus); Logistician income += round(income · bonus). With withdrawals the pre-modifier value is subtracted from the accumulator. NavalDLC delegates.

IL: TaleWorlds.CampaignSystem.GameComponents.DefaultClanFinanceModel: CalculateVillageIncome.

Forest Kin and Logistician read the village's Bound town governor with no presence check. Land Tax applies to clans in a kingdom that are not its ruling clan.

Clan daily income

Eliminated clans return 0. Sub-methods add into one standard modifier sum (base 0) in order: ruling clan policy income, minor clan tier income, mercenary income, settlement income, the clan leader's workshops, parties, player alleys, tribute, call-to-war agreements, trade agreements, kingdom budget, Spring of Gold. All terms are add; no clamp. NavalDLC extends CalculateClanGoldChange and CalculateClanExpenses (expense side).

IL: TaleWorlds.CampaignSystem.GameComponents.DefaultClanFinanceModel: CalculateClanIncomeInternal, AddPlayerClanIncomeFromOwnedAlleys, AddIncomeFromCallToWarAgrements, AddIncomeFromKingdomBudget, AddMercenaryIncome, AddIncomeFromParties, AddSettlementIncome, AddIncomeFromTradeAgreements, AddIncomeFromTribute, CalculateHeroIncomeFromWorkshops, AddRulingClanIncome.

• Settlement income: Σ over the clan's fiefs of trunc(tax) + trunc(tariffs) + project income + Σ village income.
• Party income: (party trade gold - 10000) / 10 per caravan or party holding more than 10000 trade gold.
• Debasement of the Currency counts towns and castles; the text says towns, so it is broader.
• Mercenary, alley, tribute, call-to-war, trade agreement and kingdom budget terms are not broken down further.
• Road Tolls (differs): the text says trade tax paid to the town owner rises by 3%; the code pays only the ruling clan, TradeTaxAccumulated / 30 (about 3.3%) of each town it owns, withdrawn from the accumulator.

Clan renown

Clan.Renown += amount when the amount is > 0, after which the clan tier may rise. Each caller passes its own amount; callers do not combine.

IL: TaleWorlds.CampaignSystem.Clan: AddRenown; TaleWorlds.CampaignSystem.GameComponents.DefaultClanFinanceModel: CalculateHeroIncomeFromWorkshops, AddIncomeFromParty.

Both run only when withdrawals are applied. A profiting caravan holds more than 10000 trade gold at the daily tick.

Construction

Daily construction power

The base model starts a standard modifier sum with base 0 and CalculateDailyConstructionPowerInternal adds Prosperity · 0.01, the boost, governor skill and perks, market goods, buildings, loyalty factors and the Battanian feat, then an at-least-0 limit; the result is returned truncated. Loyalty ≤ 25 sets an at-most-0 limit. The clamp is lazy, so every later add and factor, including NavalDLC's, is still clamped: at loyalty ≤ 25 construction is 0. The no-boost variant uses the same method without the boost term. NavalDLC extends it: after the base result, factor +0.2 for Maritime Weal Edict when the settlement has no port.

IL: NavalDLC.GameComponents.NavalDLCBuildingConstructionModel: CalculateDailyConstructionPower; TaleWorlds.CampaignSystem.GameComponents.DefaultBuildingConstructionModel: CalculateDailyConstructionPowerInternal; Helpers.PerkHelper: GetGovernorEngineeringSkillEffectForHero.

• Engineering skill effect: governor's Engineering × 0.0025, governor in the town; towns and castles. A second reader builds only the tooltip text (ui_only).
• Carpenters, Military Planner and Stonecutters need the governor in the settlement and a project in progress.
• Confidence: the first building in progress must be a military project.
• High loyalty (≥ 75): factor maps 75..100 to 0..0.2. Low loyalty (25 < loyalty ≤ 50): maps 25..50 to -0.5..0.
• Battanian feat: -0.1, only when loyalty > 25.
• Production goods sold in the market: 0.25 per item sold.
• Boost: construction_boost_amount · min(1, boost_progress / boost_cost); boost_cost is the boost cost below.
• Maritime Weal Edict (differs): the text says project building speed in non-coastal towns decreases by 20%; the code adds factor +0.2 for settlements without a port, an increase.
• Stonecutters (differs): aqueducts are not included: the current project must be Fortifications or Barracks (town or castle).
• Self-made Man (differs): only Marketplace is tested; kiln and aqueduct never are.
• Forced Labor (differs): a flat factor of bonus whenever the governor is present (not in the tooltip), plus min(0.3, prisoners / 3 · bonus) with no flooring to whole groups of 3, capped at +30%.

Worked example. A town with prosperity 5000, Mason at level 2 and loyalty 85, with an Engineering 100 governor holding Carpenters in the town, in a kingdom with Maritime Weal Edict and no port:

A town with prosperity 5000, Mason at level 2, loyalty 85, an Engineering 100 governor with Carpenters in the town, in a kingdom with Maritime Weal Edict and no port. Inputs: prosperity 5000.

With these inputs, daily construction power of a town or castle is 92.4000.

The four factors are summed (+12%, +20%, +25%, +8%) and applied once to 56.0000. Maritime Weal Edict raises construction power by 11.2000; by its text it should lower it.

Worked example. The same town at loyalty 20. The high loyalty factor is gone and the at-most-0 limit caps the result; the NavalDLC factor added after the cap is still capped:

The town of the first example at loyalty 20, so the high loyalty bonus is gone and construction power is capped at 0; the later Maritime Weal Edict factor is still capped. Inputs: prosperity 5000.

With these inputs, daily construction power of a town or castle is 0.0000 (limited from 87.9200).

Boost amount

boost = boost_bonus + trunc(boost_bonus · (relocation + spring_of_gold)), where boost_bonus is 50 for a town and 20 for a castle, and relocation / spring_of_gold are the secondary bonuses of Relocation and Spring of Gold when the governor has them (summed before one multiply). For towns, CalculateDailyConstructionPowerInternal then sets boost = boost + Round(boost · clockwork). NavalDLC delegates.

IL: TaleWorlds.CampaignSystem.GameComponents.DefaultBuildingConstructionModel: GetBoostAmount, CalculateDailyConstructionPowerInternal.

None of the three checks governor presence. Clockwork applies to towns only.

Boost cost

The boost reserve one boost spends, which also divides the boost progress in construction power. Starts at 500 for a town and 250 for a castle, then the Generosity factor, then rounded. NavalDLC delegates.

IL: TaleWorlds.CampaignSystem.GameComponents.DefaultBuildingConstructionModel: GetBoostCost.

• Generosity trait: the governor must be in the town; trait_effect is 0.2 at Generosity -2 and 0.1 at -1.

Buildings

Building effect

level_amount is the building type's base effect amount at the building's current level. Every building's effect skips level 0 and daily projects that are not the town's current default building, then applies the result to the consumer number as add or factor.

IL: TaleWorlds.CampaignSystem.GameComponents.DefaultBuildingEffectModel: GetBuildingEffect.

• Public Speaker: Marketplace and Festival and Games; "forums" has no building type in v1.5.7 (the legacy forum id maps to marketplace), so those two are the whole set.
• Contractors: every building of the town or castle. Master of Planning: daily projects only.
• Bound village hearths: for the Denar by bound village hearth building effect, the number is recreated with base bound_village_hearths · level_amount.
• Battlements (differs): adds to the food stock effect of a Granary (castle) or Warehouse, and both start at level 0, so it does nothing until one is built to level ≥ 1.

Building amounts (levels 1 / 2 / 3, or a single value for a daily project):

Inert building effects: the daily security effect (read by the security change) and the militia reduction effect (read for rebellious castles) are carried by no building.

Workshops

Production speed

The base model starts from the production's conversion speed and adds factors from policies of the settlement owner's kingdom, Warehouse, Mercenary Connections (town governor) and Sweatshops (workshop owner). No clamp. NavalDLC extends it: after the base result, factors from policies of the workshop owner clan's kingdom.

IL: NavalDLC.GameComponents.NavalDLCWorkshopModel: GetEffectiveConversionSpeedOfProduction; TaleWorlds.CampaignSystem.GameComponents.DefaultWorkshopModel: GetEffectiveConversionSpeedOfProduction.

Maritime Weal Edict needs the workshop's settlement to have a port. Royal Navy Prerogative applies to smithies and wood workshops. Calculating trait: trait_effect is +0.1 at Calculating +1 and +0.2 at +2 for a governor who is in the town.

Capture refund

Per workshop whose owner's faction is at war with the town's new owner, the owner receives Round(bonus) gold. No other source.

IL: TaleWorlds.CampaignSystem.CampaignBehaviors.WorkshopsCampaignBehavior: OnSettlementOwnerChanged.

Rapid Development (differs): the holder is each workshop owner, not the clan leader (game_role ClanLeader).

Villages

Daily hearth change

The base model (base 0) recreates the number for a village in the Normal state with base 4 (hearth < 300), 1.2 (< 600) or 0.2; other states keep 0. Perks, buildings and the bound settlement terms need a bound settlement and the Normal state. The Empire feat factor is added only when the result so far is ≥ 0. No clamp. NavalDLC extends it: after the base result, Fair Winds when the bound settlement has a port and is a fortification.

IL: NavalDLC.GameComponents.NavalDLCSettlementProsperityModel: CalculateHearthChange; TaleWorlds.CampaignSystem.GameComponents.DefaultSettlementProsperityModel: CalculateHearthChangeInternal.

• Fair Winds: a factor on a negative hearth change makes it more negative.
• Energetic, Bush Doctor, Aid Corps (differs): skipped unless the village is in the Normal state (not looted or being raided), which the tooltips do not state.
• Bush Doctor reads the governor of the village's bound town or castle; castle-bound villages qualify.
• Mercy trait: trait_effect is +0.05 at Mercy +1 and +0.1 at +2 for the bound town's governor while in that town, applied only when the change so far is not negative.

Daily production

Per item. The base model returns 0 unless the village is Normal. For each production entry of the village type whose item matches, the base add and the perks apply only when the village has a trade-bound town; culture feats and buildings of the bound fortification follow. No clamp. NavalDLC extends it: after the base result, Port Authority and Blessings of the Sea (TradeBound governor), then factors Maritime Weal Edict +0.25 and Bolster the Militia -0.05 of the bound settlement owner's kingdom.

IL: NavalDLC.GameComponents.NavalDLCVillageProductionCalculatorModel: CalculateDailyProductionAmount; TaleWorlds.CampaignSystem.GameComponents.DefaultVillageProductionCalculatorModel: CalculateDailyProductionAmount.

• Base: production_rate · (hearth_level + 1) · 0.5.
• Maritime Weal Edict here has no port check: every village of the kingdom gets +0.25, while the text names villages bound to coastal settlements, so it is broader.
• Steady (Athletics), Perfect Health, Breeder, Granary Accountant, Tradeyard Foreman, Blessings of the Sea, Port Authority (differs): read from the governor of the village's trade-bound town, not the settlement it is bound to. A castle's governor never applies them; a town governor applies them to castle villages that trade with the town. Steady also covers any trade-good output, not only farms, mines, lumber camps and clay pits.
• Shepherd (differs): not tier-2 horses. For a tier-1 mount item, with chance bonus (a random roll below it) the production count of that same item gets +1 before the hearth multiplier. The roll happens on every call of the model.

Raid recovery

Daily settlement hit point recovery, for villages and towns with hit points < 1 and no map event or siege. Base 0.06 + (7000 - min(7000, max(1000, faction_strength))) / 100000, where faction_strength is the faction's current total strength. The result is applied with IncreaseSettlementHealthAction.

IL: TaleWorlds.CampaignSystem.CampaignBehaviors.VillageHealCampaignBehavior: DailyTickSettlement.

• Clean Infrastructure (differs): the trade-bound town's governor, not the bound settlement's.
• In Best Light (secondary): the owner clan's leader; applies to towns as well as villages, broader than the tooltip.

Forced volunteers

count = ceil(Hearth / 30) truncated; In Best Light adds; count culture basic troops are given. Afterwards hit points ×0.2 and hearth falls by count / 2 (integer division).

IL: TaleWorlds.CampaignSystem.CampaignBehaviors.VillageHostileActionCampaignBehavior: village_force_volunteers_ended_successfully_on_consequence.

In Best Light (differs): the perk bonus is never read; the count rises by the village's notable count, one per notable.

Volunteers

Recruit slots

Integer formula. internal = min(6, max(0, 1 + player_recruit_slot_bonus + one_of_the_family)); result = min(6, internal + relation_index + same_faction + ai_recruiter + war_penalty + perk_slots), where perk_slots is the sum of the truncated bonuses of Artisan Community, Combat Tips, Firebrand, Flexible Ethics and Engineering Guilds. Not overridden.

IL: TaleWorlds.CampaignSystem.GameComponents.DefaultVolunteerModel: MaximumIndexHeroCanRecruitFromHero, MaximumIndexCanPartyRecruitFromHeroInternal.

• Relation index: relation ≥ 100: 7, ≥ 80: 6, ≥ 60: 5, ≥ 40: 4, ≥ 20: 3, ≥ 10: 2, ≥ 5: 1, ≥ 0: 0, else -1.
• At war: -1, -2 for AI; 0 when the recruiter is a minor faction hero and the notable is in a village.
• Combat Tips: "troop tiers" in the tooltip is the slot index.
• Engineering Guilds (differs): capped at 6, so the slot is lost at the cap; read from the party's engineer.
• One of the Family (differs): only heroes of the settlement's owner clan get the slot; the town governor (for a village, the bound town's) must have the perk, with no presence check.
• Artisan Community (differs): the holder is the recruiting hero, not the party quartermaster.

Volunteer production probability

A 0-1 probability. faction_fief_score = Σ over the notable's faction fiefs of village count plus, for towns, 1 / 2 / 3 for prosperity < 3000 / < 6000 / higher. The ratio is 1 when the score is ≥ 46, else (score / 46)^2; the 0.2 · (1 - ratio) term is 0 when the notable has no current settlement. Factors follow; no clamp.

IL: TaleWorlds.CampaignSystem.GameComponents.DefaultVolunteerModel: GetDailyVolunteerProductionProbability.

• Cantons: policy of the notable's clan's kingdom.
• Recruitment rate option: when the campaign option is on, the chance gets a -90% factor after every other term.
• Cavalry Tactics: since v1.5.7 the model calls AddPerkBonusForTown with the secondary half, so the governor's -50% (the mounted-wage half) cuts the cavalry volunteer chance in the town, or for a village in the town it trades with, while the governor is there (differs: not in the secondary tooltip). The +30% primary half is never read (unused).

Garrison

Garrison size the town can feed

The AI's estimate of the largest garrison the town's food supports. food_change is the town's daily food change, garrison the garrison's regular member count, population food Prosperity / 40. With divisor d = 1 + Σ governor perk bonuses (Triage Tent and Gourmet only under siege, Master of Warcraft always; no presence check):

food_change < -prosperity/40:
    newly conquered fortification -> trunc(map(prosperity, 0, 8000, 150, 300))
    otherwise                     -> max(0, garrison - Round(|food_change + prosperity/40| · 20 / d))
otherwise                         -> garrison + Round((prosperity/40 + food_change) · 20 / d)

The perks divide only the food term.

IL: TaleWorlds.CampaignSystem.CampaignBehaviors.GarrisonTroopsCampaignBehavior: CalculateMaxGarrisonSizeTownCanFeed.

Master of Warcraft (differs): in this estimate it is applied to garrison food, while the population term stays unreduced; in the real food model it reduces population food.

Notable relations

Town daily tick

A 0-1 probability per perk. White Lies and Scarface each make a random roll at or below bonus separately; a success gives +1 relation between the governor and a random notable.

IL: TaleWorlds.CampaignSystem.Settlements.Town: DailyTick.

Scarface (differs): only gang leaders are eligible, not any notable.

Governor daily tick

A 0-1 probability per perk; each site is its own roll and the rolls do not sum. A success applies +1 relation between the governor's clan leader (or the owner clan leader) and the chosen notables. Virile rolls in BuildingsCampaignBehavior while a daily project is active. No presence check on any of them.

IL: TaleWorlds.CampaignSystem.CampaignBehaviors.GovernorCampaignBehavior: DailyTickSettlement; TaleWorlds.CampaignSystem.CampaignBehaviors.BuildingsCampaignBehavior: DailyTickSettlement.

• In Bloom / Young And Respectful: a random notable of the opposite / same sex.
• Meaningful Favors: every notable with power ≥ 200 gains relation, with the owner clan's leader, not the governor's clan leader.

The relation itself (notable_relation) is defined with the social numbers.

Trading in disguise

Boolean (1 yes, 0 no). In towns and castles, the main hero cannot trade while disguised unless they have Smuggler Connections. Villages take a separate path. NavalDLC extends the location access and settlement action checks, not this one.

IL: TaleWorlds.CampaignSystem.GameComponents.DefaultSettlementAccessModel: CanMainHeroTrade.

Bribe to enter a keep

The gold the guards ask to let the main hero into a lord's hall or dungeon when access is limited and a bribe solves it. 0 when no bribe is needed. No module overrides the bribe model.

bribe = max(0, floor(bribe_base · skill_factor / 25) · 25 − bribe_paid)
skill_factor = (1 − Roguery / 300) · 0.65 + 0.35

• bribe_base: the faction's base bribe plus its criminal-rating term; when the player clan's renown is below 500, max(50, bribe_base + (500 − renown) · 15 / 10), integer division with renown truncated.
• bribe_paid: what was already paid at this settlement.
• Roguery: the main hero's raw skill. The factor is 1 at 0 and 0.35 at 300; it has no lower limit.

IL: TaleWorlds.CampaignSystem.GameComponents.DefaultBribeCalculationModel: GetSkillFactor, GetBribeInternal.

Tooltip differences at a glance

Related skill guides

Athletics, Boatswain, Bow, Charm, Crossbow, Engineering, Leadership, Mariner, Medicine, One Handed, Polearm, Riding, Roguery, Scouting, Shipmaster, Steward, Tactics, Throwing, Trade, Two Handed.

Changelog

• v1.5.7 (2026-11-12): re-verified against v1.5.7. Security below 60 costs up to -2.5 loyalty; garrison security coefficient 0.0075; governor culture loyalty term removed; rebellious threshold 35; Citizen Militia, Drills and Seven Veterans need the governor present and Seven Veterans adds +0.1; Cavalry Tactics applies its secondary half to volunteers; Architectural Commissions and Accuracy Training on villages need the governor present; personality trait terms (Honor, Generosity, Mercy, Calculating) and the recruitment rate option added.
• v1.4.8 (2026-11-11): Bribe to enter a keep added (raw Roguery skill).
• v1.4.8 (2026-11-11): First version from IL.