Unciv游戏中单位晋升奖励重复触发问题分析

问题现象

在Unciv游戏项目中，当通过UnitPromotions.json文件为单位添加带有"Instantly gain [500] [Gold]"效果的晋升时，实际游戏中单位会获得双倍奖励（1000金币）。该问题不受游戏速度设置影响，在快速、标准、马拉松等不同速度下均会出现相同的双倍奖励现象。

技术分析

经过对游戏引擎代码的深入分析，发现该问题源于游戏引擎中两套独立系统的叠加触发机制：

1. 晋升添加触发系统：当单位获得新晋升时，会自动执行该晋升中定义的所有触发器效果
2. 单位创建触发系统：当新单位被创建时，会执行该单位所有晋升中的触发器效果

当玩家在单位创建时就为其添加特定晋升时，这两套系统会同时工作，导致晋升中的奖励效果被重复触发。具体流程如下：

1. 游戏创建新单位
2. 单位创建系统为新单位添加指定晋升
3. 晋升添加系统检测到新晋升，触发奖励效果（第一次）
4. 单位创建系统继续检查单位的所有晋升，再次触发奖励效果（第二次）

解决方案建议

针对这一问题，开发者可以考虑以下几种解决方案：

1. 条件触发机制：在触发器效果中添加执行条件判断，确保同一效果在同一回合内不会重复触发
2. 触发器标记系统：为每个触发器添加唯一标识，在效果执行后标记为已触发，防止重复执行
3. 事件合并机制：在单位创建流程中合并同类触发事件，确保每个效果只执行一次

影响范围评估

该问题不仅影响金币奖励，理论上会影响所有通过晋升添加的即时效果，包括但不限于：

• 资源获取（金币、信仰值等）
• 单位属性修改（生命值恢复、经验值获取等）
• 特殊状态添加（增益效果、减益效果等）

最佳实践建议

对于mod开发者，在当前版本中可以采取以下临时解决方案：

1. 将奖励数值减半设置（如需要500金币效果则设置为250）
2. 避免在单位创建时添加会产生即时效果的晋升
3. 考虑使用其他机制替代即时效果（如通过Lua脚本控制奖励发放时机）

该问题反映了游戏事件系统设计中需要注意的触发时序和条件判断问题，对于类似游戏引擎开发具有普遍的参考价值。