effect · `start_peace_conference`

Definition

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

Description

Starts a limited peace conference between the two countries if at war. Only the specified loser country and their potential subjects are included as losers in the conference. ROOT is the winner while the target tag is the loser.
Example:
SOV = {
  start_peace_conference = {
    tag = FIN  # main loser
    score_factor = 0.2  # 0-1, the fraction of conference score allocated to winners. Can use a variable like eg PREV.surrender_progress. 0.0 implies a white peace.
    
    # winner_scope and loser_scope can be ALL (all relevant countries), FACTION (members of main country's faction and overlordship), LIMITED_FACTION (faction members if main country is faction leader, and subjects if main country is overlord), and LIMITED (main country and their subjects)
    winner_scope = FACTION  # optional, default is LIMITED_FACTION
    loser_scope = FACTION  # optional, default is LIMITED_FACTION
    message = FIN_agree_peace  # optional, custom message to display in post-conference popup
  }
}

实战 · 配合 · 坑

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

实战用法

start_peace_conference 最适合在"停战事件"或"外交谈判"类 mod 中使用，例如让某国在特定条件满足后主动触发一场有限和平会议，而不必等待标准投降流程。常见场景包括历史和议（如苏芬冬季战争的和谈）或玩家决策驱动的妥协外交。

# 苏联主动与芬兰和谈，双方势力范围有限，给予较低的会议分配比例
SOV = {
    start_peace_conference = {
        tag = FIN
        score_factor = 0.35
        winner_scope = LIMITED_FACTION
        loser_scope = LIMITED
        message = sov_fin_winter_war_peace
    }
}

配合关系

[has_war_with](/wiki/trigger/has_war_with)（注：白名单中无此条，见坑）→ 实际可用 [has_defensive_war_with](/wiki/trigger/has_defensive_war_with) 在触发前校验是否与目标国处于战争状态，避免对非交战国调用。
[country_event](/wiki/effect/country_event)：和平会议结束后，通常紧接着发送事件通知玩家或触发后续剧情，与本 effect 搭配构成完整的外交事件链。
[has_capitulated](/wiki/trigger/has_capitulated)：在触发和平会议前判断目标国是否已投降，防止在目标尚未屈服时过早强制结束战争。
[create_wargoal](/wiki/effect/create_wargoal)：在和平会议前创建具体战争目标，使会议中可分配的战果更明确，避免空白和议。

常见坑

忘记检验交战状态就调用：若调用时两国并不处于同一场战争，start_peace_conference 会静默失败而不报错，导致脚本逻辑断链。务必在 trigger 块中先确认双方处于交战状态再执行。
score_factor 与白和平的混淆：将 score_factor 设为 0.0 意味着强制白和平（双方均不得索取领土），但很多新手以为只是"分数很低"仍可瓜分领土，实际上为零时赢家侧完全无法获得任何战争目标，需谨慎设置。

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

start_peace_conference is best suited for use in "armistice event" or "diplomatic negotiation" type mods, such as allowing a certain nation to actively trigger a limited peace conference after specific conditions are met, rather than waiting for the standard surrender process. Common scenarios include historical peace talks (such as negotiations during the Soviet-Finnish Winter War) or player decision-driven compromise diplomacy.

# The Soviet Union actively negotiates peace with Finland; both sides have limited faction scope, granting lower conference allocation ratios
SOV = {
    start_peace_conference = {
        tag = FIN
        score_factor = 0.35
        winner_scope = LIMITED_FACTION
        loser_scope = LIMITED
        message = sov_fin_winter_war_peace
    }
}

Synergy

[has_war_with](/wiki/trigger/has_war_with) (Note: this condition is not in the whitelist; see pitfalls below) → In practice, use [has_defensive_war_with](/wiki/trigger/has_defensive_war_with) to verify whether the target nation is in a state of war before triggering, avoiding invocation against non-belligerent countries.
[country_event](/wiki/effect/country_event): After the peace conference concludes, typically follow immediately with an event to notify the player or trigger subsequent storylines, working in tandem with this effect to form a complete diplomatic event chain.
[has_capitulated](/wiki/trigger/has_capitulated): Before triggering the peace conference, determine whether the target nation has already capitulated, preventing premature forced end to war while the target still resists.
[create_wargoal](/wiki/effect/create_wargoal): Create specific war goals before the peace conference, making the war results available for distribution in the conference more explicit, avoiding blank peace agreements.

Common Pitfalls

Calling without verifying belligerent status first: If invoked when the two nations are not in the same war, start_peace_conference will fail silently without error, causing script logic to break. Always confirm both parties are in an active war within the trigger block before execution.
Confusion between score_factor and white peace: Setting score_factor to 0.0 enforces white peace (neither side may claim territory), but many newcomers mistakenly think it merely means "very low score" and territories can still be divided. In reality, when set to zero, the winning side cannot obtain any war goals whatsoever; this requires careful configuration.

effect · start_peace_conference