effect · ai_message

实战用法

ai_message 主要用于在 mod 中向 AI 国家传递某种内部消息或提示信号，常见于需要触发 AI 特定行为响应的场景，例如当玩家完成某项国策后通知 AI 盟友调整策略。由于官方文档对其参数描述极为有限，实际使用中多作为调试或实验性功能出现。

country_event = {
    id = my_mod.1
    hidden = yes
    immediate = {
        ai_message = {
            # 具体参数视实际游戏版本测试为准
        }
    }
}

配合关系

• [add_ai_strategy](/wiki/effect/add_ai_strategy) — 两者常组合使用，在发送 ai_message 的同时通过 add_ai_strategy 给 AI 国家补充具体的策略权重，使 AI 行为调整更加完整。
• [has_country_flag](/wiki/trigger/has_country_flag) — 用于在执行 ai_message 前检查特定标志位是否已设置，防止重复触发或在错误时机发送消息。
• [country_event](/wiki/effect/country_event) — 常与 ai_message 搭配，在消息发送的同一执行块中同时触发一个隐藏事件，借助事件链实现更复杂的 AI 响应逻辑。
• [clr_country_flag](/wiki/effect/clr_country_flag) — 发送消息后及时清除标志位，配合标志控制确保消息仅在预期条件下发送一次。

常见坑

1. 参数不明导致静默失败：由于官方描述极度缺失，新手往往直接空写或随意填写参数，导致 effect 静默跳过却不报错，难以排查；建议在游戏日志和控制台中反复验证实际效果，不要假设其行为与字面含义完全吻合。
2. 误以为可在非 COUNTRY scope 下使用：该 effect 仅支持 COUNTRY scope，若误写在 STATE 或 CHARACTER 等 scope 的执行块中会直接报错或被忽略，新手在嵌套 scope 时需格外注意当前 scope 归属。