effect · add_unit_medal_to_latest_entry

实战用法

add_unit_medal_to_latest_entry 用于在师级战斗日志（unit journal entry）的最新条目上附加勋章，常见于自定义战役事件或成就系统中，当玩家的部队完成特定任务时自动颁发荣誉。例如在一个关卡事件中，当某支精锐师完成包围战后触发：

# 在事件的 immediate 块中，对最新日志条目追加勋章
immediate = {
    add_unit_medal_to_latest_entry = {
        unit_medals = my_mod_iron_cross
    }
}

配合关系

由于当前 scope 白名单中暂无其他已收录的配套 effect 或 trigger 命令，无法列出合规的交叉引用条目。在实际工程中，该指令通常出现在专门管理师级日志的脚本链路里，建议结合日志条目创建类指令一并使用，确保"最新条目"确实存在再执行本指令。

常见坑

1. 条目不存在即调用：本指令作用于"最新条目"，若在调用时尚未通过对应指令创建任何日志条目，勋章将无处附加，效果静默失败且不报错，导致勋章丢失。务必确认日志条目已先行创建。
2. unit_medals 键名拼写错误：key 必须与 common/unit_medals/ 下定义的标识符完全一致（区分大小写），若键名不匹配，游戏不会崩溃但勋章不会显示，排查时容易被忽视。