effect · `add_legitimacy`

Definition

Supported scope:COUNTRY
Supported target:none

Description

add_legitimacy = 10. Adds legitimacy to Scope country. Value has to be 0-100.

实战 · 配合 · 坑

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

实战用法

add_legitimacy 常用于君主制或帝国体制的 mod 中，当玩家完成某个专注或事件时奖励合法性，或在内战/政变后通过惩罚性事件扣除合法性以模拟政权动荡。例如，一个历史性加冕事件可以通过此命令直接拉满合法性：

country_event = {
    id = monarchy.5
    title = monarchy.5.t
    desc = monarchy.5.d

    option = {
        name = monarchy.5.a
        add_legitimacy = 25
        add_stability = 0.05
    }
    option = {
        name = monarchy.5.b
        add_legitimacy = -15
        add_political_power = 50
    }
}

配合关系

[add_stability](/wiki/effect/add_stability)：合法性与稳定性在叙事逻辑上高度绑定，政权巩固时通常同步提升两者，政变/战败时同步扣除。
[add_political_power](/wiki/effect/add_political_power)：合法性强的政权往往也拥有更高的行政效率，两者常在同一 option 中搭配作为奖励或惩罚包。
[add_popularity](/wiki/effect/add_popularity)：在派系执政的 mod 体系里，合法性上升往往伴随执政党支持度提升，逻辑上相互呼应。
[has_country_flag](/wiki/trigger/has_country_flag)：用来判断某一合法性变动事件是否已触发过，避免同一流程中重复授予合法性奖励。

常见坑

数值越界不报错但静默截断：游戏要求数值区间为 0–100，若计算后传入超出范围的值（如叠加多次后超过 100），游戏会直接截断而不弹出错误，新手往往以为效果没生效，实际是已达上限。
在非君主/帝国政体下使用无效：add_legitimacy 只对拥有合法性机制的政体生效，若 mod 中某国当前政体不支持该机制，命令会被静默忽略，调试时务必先确认目标国家的政体类型。

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

add_legitimacy is commonly used in mods featuring monarchies or imperial government systems. It rewards legitimacy when players complete a focus or trigger an event, or deducts legitimacy via punitive events after civil wars or coups to simulate regime instability. For example, a historical coronation event can max out legitimacy directly through this command:

country_event = {
    id = monarchy.5
    title = monarchy.5.t
    desc = monarchy.5.d

    option = {
        name = monarchy.5.a
        add_legitimacy = 25
        add_stability = 0.05
    }
    option = {
        name = monarchy.5.b
        add_legitimacy = -15
        add_political_power = 50
    }
}

Synergy

[add_stability](/wiki/effect/add_stability): Legitimacy and stability are narratively intertwined—both typically increase together when consolidating power and decrease together after coups or military defeats.
[add_political_power](/wiki/effect/add_political_power): Regimes with high legitimacy often possess greater administrative efficiency; these two effects are commonly paired in the same option as reward or penalty packages.
[add_popularity](/wiki/effect/add_popularity): In faction-based mod systems, rising legitimacy typically correlates with increased ruling party support, creating logical reinforcement.
[has_country_flag](/wiki/trigger/has_country_flag): Used to check whether a legitimacy-altering event has already fired, preventing duplicate legitimacy rewards within the same sequence.

Common Pitfalls

Out-of-range values silently clamp without error: The game enforces a 0–100 range; if stacked effects exceed this limit (e.g., multiple additions totaling over 100), the game silently clamps rather than throw an error. New modders often assume the effect failed when it actually hit the ceiling.
Effect does nothing under non-monarchic/imperial governments: add_legitimacy only functions on government types with legitimacy mechanics. If the target country's current government lacks this system, the command is silently ignored. Always verify the target nation's government type during debugging.

effect · add_legitimacy