trigger · `foreign_manpower`

Definition

Supported scope:COUNTRY
Supported target:THIS, ROOT, PREV, FROM, OWNER, CONTROLLER, OCCUPIED, CAPITAL

Description

check the amount of foreign garrison manpower we have

实战 · 配合 · 坑

实战内容由 AI 生成,并已对照 vanilla 命令词表校验 —— 请当作起点而非权威依据。上方的定义节才是游戏自带文档原文。

实战用法

foreign_manpower 常见于殖民地或傀儡国机制的 mod 中，用来检查本国从外国驻军中获得的兵力是否达到某一阈值，以触发相关事件或决议（例如"当外国驻军兵力充足时才允许扩张殖民军"）。也可用于动态修正的激活条件，当外国驻军人力不足时给出警告事件。

# 当外国驻军人力高于某值时才允许激活某决议
available = {
    foreign_manpower > 10000
}

配合关系

[garrison_manpower_need](/wiki/trigger/garrison_manpower_need)：两者常组合使用，一个检查当前拥有的外国驻军人力，另一个检查实际驻军需求缺口，可做"供需对比"判断。
[has_army_manpower](/wiki/trigger/has_army_manpower)：在同一条件块中与 foreign_manpower 并列使用，区分本国总兵力与外来驻军兵力来源，避免混淆。
[add_manpower](/wiki/effect/add_manpower)：在 foreign_manpower 满足条件后，通过 effect 补充本国人力池，形成"驻军充足 → 奖励人力"的逻辑闭环。
[controls_state](/wiki/trigger/controls_state)：外国驻军通常存在于被控制但非本国核心的州，配合此 trigger 可进一步限定检查范围的合理性。

常见坑

Scope 混用：foreign_manpower 只在 COUNTRY scope 下有效，新手有时误将其写在 STATE 块内，导致脚本报错或静默返回 false，务必确认外层是国家 scope。
误以为可检查具体州的驻军：该 trigger 返回的是全国层面的外国驻军人力总量，无法直接用它来判断某个特定州的驻军情况；若需州级判断，应配合 [army_manpower_in_state](/wiki/trigger/army_manpower_in_state) 等针对州的 trigger 使用。

Hands-On Notes

Hands-on notes are AI-generated and checked against the vanilla command vocabulary — treat them as a starting point, not authoritative reference. The definition above is the game's own documentation.

Hands-On Usage

foreign_manpower is commonly found in mods dealing with colonial or puppet state mechanics. It checks whether the manpower gained from foreign garrisons in your territory meets a certain threshold, triggering related events or decisions (for example, "only allow colonial army expansion when foreign garrison strength is sufficient"). It can also be used as an activation condition for dynamic modifiers, issuing warning events when foreign garrison manpower falls short.

# Allow decision activation only when foreign garrison manpower exceeds a threshold
available = {
    foreign_manpower > 10000
}

Synergy

[garrison_manpower_need](/wiki/trigger/garrison_manpower_need): These two are often used together—one checks the foreign garrison manpower currently owned, while the other checks the actual garrison requirement deficit, enabling "supply vs. demand" comparisons.
[has_army_manpower](/wiki/trigger/has_army_manpower): Use alongside foreign_manpower within the same condition block to distinguish between total national manpower and foreign garrison manpower sources, avoiding confusion.
[add_manpower](/wiki/effect/add_manpower): Once foreign_manpower meets its condition, use effects to replenish national manpower pools, creating a closed feedback loop of "sufficient garrison → manpower reward".
[controls_state](/wiki/trigger/controls_state): Foreign garrisons typically exist in controlled but non-core states, and pairing this trigger further validates the rationality of your check scope.

Common Pitfalls

Scope Mixing: foreign_manpower only works within COUNTRY scope. Beginners sometimes mistakenly place it within STATE blocks, causing script errors or silent false returns. Always confirm the outer scope is at country level.
Mistaking It for State-Specific Garrison Checks: This trigger returns total foreign garrison manpower at the national level and cannot directly judge garrison situations in specific states. If state-level checks are needed, pair it with state-specific triggers like [army_manpower_in_state](/wiki/trigger/army_manpower_in_state).

trigger · foreign_manpower