effect · set_faction_military_unlocked

实战用法

在 mod 中若你为某个阵营增添了自定义的"军事研究"面板，可用此 effect 在特定事件或决议触发后解锁对应的操作权限，例如当玩家的国家完成某个国策后才允许修改阵营研究设置。下面是一个典型的国策完成触发场景：

focus = {
    id = MY_FOCUS_UNLOCK_FACTION_RESEARCH
    ...
    completion_reward = {
        set_faction_military_unlocked = yes
    }
}

配合关系

• [set_faction_research_unlocked](/wiki/effect/set_faction_research_unlocked)：两者功能高度相关，通常同时调用以确保阵营研究面板的显示与编辑权限同步开放。
• [hidden_effect](/wiki/effect/hidden_effect)：将本 effect 包裹在隐藏块中，避免玩家在事件选项里看到无意义的解锁提示文本。
• [custom_effect_tooltip](/wiki/effect/custom_effect_tooltip)：与 hidden_effect 搭配使用，用自定义文本替代默认的效果说明，向玩家清晰传达"已解锁阵营研究权限"的信息。
• [has_game_rule](/wiki/trigger/has_game_rule)：在执行解锁前先判断当前游戏规则，确保只有特定规则模式下才触发此 effect，避免破坏平衡。

常见坑

1. Scope 使用错误：此 effect 需在国家 scope（country scope）下调用，若误写在 state 或 province 等其他 scope 的执行块中将导致脚本报错或静默失效，务必确认外层 scope 是目标国家标签。
2. 只解锁不检查派系归属：直接对一个不属于任何派系的国家调用此 effect 时，效果可能不生效或产生未定义行为，建议在调用前先通过相关 trigger 确认该国家确实存在并隶属于某一派系。