VCMI Bonus系统Modding指南为英雄、生物与建筑自定义加成属性的终极秘籍【免费下载链接】vcmiOpen-source engine for Heroes of Might and Magic III项目地址: https://gitcode.com/gh_mirrors/vc/vcmiVCMI 是《英雄无敌 III》Heroes of Might and Magic III的开源重制引擎而Bonus加成系统正是它最强大的 Modding 核心——英雄专长、生物技能、宝物效果、建筑增益几乎全部由 Bonus 实现。本指南带你快速上手用 JSON 配置为英雄、生物与建筑自定义加成属性无需写一行 C 代码。 什么是 VCMI Bonus 系统在 VCMI 中Bonus 是一种可以挂载到各种游戏实体上的效果标签。以下机制都由 Bonus 驱动游戏机制是否由 Bonus 实现全部宝物Artifact效果✅英雄专长Specialty✅二级技能效果✅生物天赋如天使鼓舞士气✅大量魔法效果✅城镇建筑加成✅官方指南明确说明Bonus 虽不如 ERM 脚本灵活但更易上手且 AI 可正确理解这些效果。完整机制说明见 docs/modders/Guides/Bonus_System.md字段格式参考 docs/modders/Bonus_Format.md。 快速上手写出你的第一个 BonusBonus 配置只需指定type其余参数val、subtype、duration等都是可选的。示例 1零参数 Bonus——免射击距离惩罚bonuses : { noPenalty : { type : NO_DISTANCE_PENALTY } }效果英雄队伍中所有远程单位在 10 格以外射击时不再吃距离惩罚。示例 2带数值的 Bonus——提升英雄视野bonuses : { scouting : { type : SIGHT_RADIUS, val : 3 } }英雄视野 3 格。多个同类 Bonus 会自动叠加最终视野等于所有来源数值之和。示例 3带 subtypes 的精确打击——消除沙地移动惩罚bonuses : { noSandPenalty : { type : NO_TERRAIN_PENALTY, subtype : sand } }subtype让你精确指定受影响对象地形、生物、法术学校等还支持用字符串 ID 跨 Mod 引用例如subtype : creature.enchanter直接指向某个生物。 全部可用 Bonus 类型清单含每种类型的val/subtype/addInfo含义都在 docs/modders/Bonus/Bonus_Types.md这是你写 Mod 时的字典。 进阶三件套限制器、传播器、更新器新手最常卡住的是让 Bonus只影响该影响的目标。VCMI 提供了三个高级参数1. Limiters限制器只影响特定对象attack : { type : PRIMARY_SKILL, subtype : primarySkill.attack, val : 3, limiters : { type : CREATURE_TYPE_LIMITER, parameters : [ pixie, true ] } }这个英雄专长只给队伍中的精灵Pixie3 攻击而不波及其他单位。2. Propagators传播器让效果向上扩散生物自带的加成默认只作用于自己。天使要鼓舞全军士气就需要传播器abilities: { raisesMorale : { type : MORALE, val : 1, propagator : HERO } }常用传播器一览完整列表见 docs/modders/Bonus/Bonus_Propagators.md传播器作用范围ARMY生物所在整个军队HERO英雄及其军队BATTLE_WIDE整个战场敌我双方PLAYER/TEAM玩家全部资产 / 含盟友GLOBAL_EFFECT全图所有生物、城镇与英雄3. Updaters更新器让数值随情境变化attack : { type : PRIMARY_SKILL, subtype : primarySkill.attack, val : 1, updater : TIMES_HERO_LEVEL }攻击加成 1 × 英雄等级——20 级英雄就是 20。这类按等级缩放的更新器是英雄专长的标配。Bonus 持续时间控制效果生效多久战斗中的 Buff/Debuff 通过duration字段控制常用取值完整列表见 docs/modders/Bonus/Bonus_Duration_Types.md{ type : STACKS_SPEED, val : -1, duration : N_TURNS, turns : 1 }PERMANENT永久ONE_BATTLE一场战斗结束消失N_TURNS持续 N 个战斗回合UNTIL_BEING_ATTACKED受到攻击后消失 为建筑自定义加成让城镇活起来在城镇建筑配置里加bonuses字段即可让建筑给驻军或到访英雄提供增益。两个经典套路给守军加士气建筑效果传播给驻军bonuses : { moraleToDefenders : { type: MORALE, val : 1, propagator : [ TOWN_AND_VISITOR ] } }给整个阵营加幸运bonuses : { luckToTeam : { type : LUCK, val : 2, propagator : [ TEAM ] } }建筑的其他功能性字段解锁兵营、提供资源、开启行会法术等参考 docs/modders/Building_Bonuses.md。️ 环境准备先让 VCMI 跑起来Mod 改完要进游戏验证。VCMI 本身需要原版《英雄无敌 III》游戏文件才能运行——GOG 用户请下载离线备份安装包而不是 GOG Galaxy 在线安装器需要参与开发或查看配置时克隆仓库即可git clone https://gitcode.com/gh_mirrors/vc/vcmi在 macOS 上首次启动客户端若被系统拦截按提示在隐私与安全性中选择仍要打开 资源地图写 Mod 去哪找资料资料路径Bonus 系统官方指南docs/modders/Guides/Bonus_System.mdBonus 完整字段格式docs/modders/Bonus_Format.mdBonus 类型字典docs/modders/Bonus/Bonus_Types.md传播器列表docs/modders/Bonus/Bonus_Propagators.md建筑加成说明docs/modders/Building_Bonuses.mdBonus 类型注册配置config/bonuses.jsonBonus 系统 C 实现lib/bonuses/⚡ 新手避坑清单只写type就能生效大部分字段可选先跑通最小配置再逐步加参数。同类 Bonus 会自动叠加想防止两个不同来源的效果叠加使用stacking字段写入相同非空字符串。subtype 支持字符串 ID直接引用creature.xxx、spell.xxx等标识符比魔法数字可读得多且天然支持跨 Mod 引用。敌方专属减益如鬼龙降低敌方士气需要三件套组合BATTLE_WIDE传播器 BONUS_OWNER_UPDATEROPPOSITE_SIDE限制器缺一不可。生物窗口想展示自定义天赋在 Bonus 中加description和icon字段不想要显示就设hidden : true。从一条NO_DISTANCE_PENALTY开始逐步解锁限制器、传播器与更新器——掌握这套 Bonus 系统你就能像官方一样用纯 JSON 重构英雄无敌的任意数值与机制。【免费下载链接】vcmiOpen-source engine for Heroes of Might and Magic III项目地址: https://gitcode.com/gh_mirrors/vc/vcmi创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 VCMI Bonus系统Modding指南：为英雄、生物与建筑自定义加成属性的终极秘籍
VCMI Bonus系统Modding指南为英雄、生物与建筑自定义加成属性的终极秘籍【免费下载链接】vcmiOpen-source engine for Heroes of Might and Magic III项目地址: https://gitcode.com/gh_mirrors/vc/vcmiVCMI 是《英雄无敌 III》Heroes of Might and Magic III的开源重制引擎而Bonus加成系统正是它最强大的 Modding 核心——英雄专长、生物技能、宝物效果、建筑增益几乎全部由 Bonus 实现。本指南带你快速上手用 JSON 配置为英雄、生物与建筑自定义加成属性无需写一行 C 代码。 什么是 VCMI Bonus 系统在 VCMI 中Bonus 是一种可以挂载到各种游戏实体上的效果标签。以下机制都由 Bonus 驱动游戏机制是否由 Bonus 实现全部宝物Artifact效果✅英雄专长Specialty✅二级技能效果✅生物天赋如天使鼓舞士气✅大量魔法效果✅城镇建筑加成✅官方指南明确说明Bonus 虽不如 ERM 脚本灵活但更易上手且 AI 可正确理解这些效果。完整机制说明见 docs/modders/Guides/Bonus_System.md字段格式参考 docs/modders/Bonus_Format.md。 快速上手写出你的第一个 BonusBonus 配置只需指定type其余参数val、subtype、duration等都是可选的。示例 1零参数 Bonus——免射击距离惩罚bonuses : { noPenalty : { type : NO_DISTANCE_PENALTY } }效果英雄队伍中所有远程单位在 10 格以外射击时不再吃距离惩罚。示例 2带数值的 Bonus——提升英雄视野bonuses : { scouting : { type : SIGHT_RADIUS, val : 3 } }英雄视野 3 格。多个同类 Bonus 会自动叠加最终视野等于所有来源数值之和。示例 3带 subtypes 的精确打击——消除沙地移动惩罚bonuses : { noSandPenalty : { type : NO_TERRAIN_PENALTY, subtype : sand } }subtype让你精确指定受影响对象地形、生物、法术学校等还支持用字符串 ID 跨 Mod 引用例如subtype : creature.enchanter直接指向某个生物。 全部可用 Bonus 类型清单含每种类型的val/subtype/addInfo含义都在 docs/modders/Bonus/Bonus_Types.md这是你写 Mod 时的字典。 进阶三件套限制器、传播器、更新器新手最常卡住的是让 Bonus只影响该影响的目标。VCMI 提供了三个高级参数1. Limiters限制器只影响特定对象attack : { type : PRIMARY_SKILL, subtype : primarySkill.attack, val : 3, limiters : { type : CREATURE_TYPE_LIMITER, parameters : [ pixie, true ] } }这个英雄专长只给队伍中的精灵Pixie3 攻击而不波及其他单位。2. Propagators传播器让效果向上扩散生物自带的加成默认只作用于自己。天使要鼓舞全军士气就需要传播器abilities: { raisesMorale : { type : MORALE, val : 1, propagator : HERO } }常用传播器一览完整列表见 docs/modders/Bonus/Bonus_Propagators.md传播器作用范围ARMY生物所在整个军队HERO英雄及其军队BATTLE_WIDE整个战场敌我双方PLAYER/TEAM玩家全部资产 / 含盟友GLOBAL_EFFECT全图所有生物、城镇与英雄3. Updaters更新器让数值随情境变化attack : { type : PRIMARY_SKILL, subtype : primarySkill.attack, val : 1, updater : TIMES_HERO_LEVEL }攻击加成 1 × 英雄等级——20 级英雄就是 20。这类按等级缩放的更新器是英雄专长的标配。Bonus 持续时间控制效果生效多久战斗中的 Buff/Debuff 通过duration字段控制常用取值完整列表见 docs/modders/Bonus/Bonus_Duration_Types.md{ type : STACKS_SPEED, val : -1, duration : N_TURNS, turns : 1 }PERMANENT永久ONE_BATTLE一场战斗结束消失N_TURNS持续 N 个战斗回合UNTIL_BEING_ATTACKED受到攻击后消失 为建筑自定义加成让城镇活起来在城镇建筑配置里加bonuses字段即可让建筑给驻军或到访英雄提供增益。两个经典套路给守军加士气建筑效果传播给驻军bonuses : { moraleToDefenders : { type: MORALE, val : 1, propagator : [ TOWN_AND_VISITOR ] } }给整个阵营加幸运bonuses : { luckToTeam : { type : LUCK, val : 2, propagator : [ TEAM ] } }建筑的其他功能性字段解锁兵营、提供资源、开启行会法术等参考 docs/modders/Building_Bonuses.md。️ 环境准备先让 VCMI 跑起来Mod 改完要进游戏验证。VCMI 本身需要原版《英雄无敌 III》游戏文件才能运行——GOG 用户请下载离线备份安装包而不是 GOG Galaxy 在线安装器需要参与开发或查看配置时克隆仓库即可git clone https://gitcode.com/gh_mirrors/vc/vcmi在 macOS 上首次启动客户端若被系统拦截按提示在隐私与安全性中选择仍要打开 资源地图写 Mod 去哪找资料资料路径Bonus 系统官方指南docs/modders/Guides/Bonus_System.mdBonus 完整字段格式docs/modders/Bonus_Format.mdBonus 类型字典docs/modders/Bonus/Bonus_Types.md传播器列表docs/modders/Bonus/Bonus_Propagators.md建筑加成说明docs/modders/Building_Bonuses.mdBonus 类型注册配置config/bonuses.jsonBonus 系统 C 实现lib/bonuses/⚡ 新手避坑清单只写type就能生效大部分字段可选先跑通最小配置再逐步加参数。同类 Bonus 会自动叠加想防止两个不同来源的效果叠加使用stacking字段写入相同非空字符串。subtype 支持字符串 ID直接引用creature.xxx、spell.xxx等标识符比魔法数字可读得多且天然支持跨 Mod 引用。敌方专属减益如鬼龙降低敌方士气需要三件套组合BATTLE_WIDE传播器 BONUS_OWNER_UPDATEROPPOSITE_SIDE限制器缺一不可。生物窗口想展示自定义天赋在 Bonus 中加description和icon字段不想要显示就设hidden : true。从一条NO_DISTANCE_PENALTY开始逐步解锁限制器、传播器与更新器——掌握这套 Bonus 系统你就能像官方一样用纯 JSON 重构英雄无敌的任意数值与机制。【免费下载链接】vcmiOpen-source engine for Heroes of Might and Magic III项目地址: https://gitcode.com/gh_mirrors/vc/vcmi创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考