传奇英雄合击版本的元宝升级脚本，核心用途是让玩家消耗元宝直接提升主号或英雄的等级。编写时需针对不同引擎的命令差异做区分处理，并设计好等级分段的消耗梯度。整套脚本围绕"检测条件、扣除元宝、提升等级、反馈结果"这条主线展开。
**引擎适配：HeroM2与GOM的区别处理**
传奇引擎对英雄相关命令的支持存在差异，这是编写脚本前必须先搞清楚的底層逻辑。
HeroM2引擎是合击版本的主流引擎，支持英雄专属命令前缀"H."。主号与英雄的等级判定、升级操作可以完全分开控制，互不干扰。主号等级用CHECKLEVELEX和CHANGELEVEL，英雄等级用H.CHECKLEVELEX和H.CHANGELEVEL。这种设计天然适配英雄合击版本的需求。
GOM引擎没有专属的英雄命令前缀，需要通过变量把英雄数据关联到主号身上。升级操作使用CHANGELEVEL和CHECKLEVELEX这类通用命令，但得额外配置变量绑定，确保操作的对象是英雄而非主号。
所有引擎通用的基础命令包括：CHECKGAMEGOLD用于检测元宝数量，GAMEGOLD加或减用于增减元宝，SENDMSG用于发送提示信息，BREAK用于终止脚本继续执行。掌握这些命令就能搭建脚本的主体框架。
**等级分段消耗：防止后期升级失衡**
元宝升级脚本必须设置等级梯度消耗，低级升级便宜、高级升级昂贵，这是保持版本平衡的关键设计。
按1-29级、30-59级、60-100级三个区间划分，对应消耗1000元宝、3000元宝、6000元宝是比较通用的配置。玩家等级越高，升级所需元宝越多，防止顶尖玩家过快拉满等级破坏游戏节奏。
脚本逻辑遵循"先检测后执行"的原则。先用CHECKLEVELEX检测当前等级落在哪个区间，再用CHECKGAMEGOLD检测元宝是否足够。所有检测通过后，才执行GAMEGOLD扣减元宝和CHANGELEVEL提升等级的操作。检测条件未通过时，用SENDMSG输出失败提示，告知玩家是元宝不够还是已达等级上限。
**完整代码示例：HeroM2引擎直接套用**
以下脚本适配HeroM2引擎，包含主号升级、英雄升级、主号英雄同时升级三种模式，可直接绑定土城NPC使用。
主号升级逻辑：
[@main]
欢迎使用元宝快速升级服务，支持主号、英雄单独或同时升级！
当前主号等级：%level% 英雄等级：%H.level%
<主号升级/@player_up>
<英雄升级/@hero_up>
<主号+英雄同时升级/@both_up>
<离开/@exit>
[@player_up]
#IF
CHECKLEVELEX < 30
CHECKGAMEGOLD > 999
#ACT
GAMEGOLD - 1000
CHANGELEVEL + 1
SENDMSG 7 主号消耗1000元宝，成功升级至%level%级！
BREAK
#ELSEIF
CHECKLEVELEX > 29
CHECKLEVELEX < 60
CHECKGAMEGOLD > 2999
#ACT
GAMEGOLD - 3000
CHANGELEVEL + 1
SENDMSG 7 主号消耗3000元宝，成功升级至%level%级！
BREAK
#ELSEIF
CHECKLEVELEX > 59
CHECKLEVELEX < 101
CHECKGAMEGOLD > 5999
#ACT
GAMEGOLD - 6000
CHANGELEVEL + 1
SENDMSG 7 主号消耗6000元宝，成功升级至%level%级！
BREAK
#ELSEACT
SENDMSG 5 条件不满足！等级已达上限或元宝不足。
英雄升级逻辑使用H.前缀单独控制：
[@hero_up]
#IF
H.CHECKLEVELEX < 30
CHECKGAMEGOLD > 999
#ACT
GAMEGOLD - 1000
H.CHANGELEVEL + 1
SENDMSG 7 英雄消耗1000元宝，成功升级至%H.level%级！
BREAK
#ELSEIF
H.CHECKLEVELEX > 29
H.CHECKLEVELEX < 60
CHECKGAMEGOLD > 2999
#ACT
GAMEGOLD - 3000
H.CHANGELEVEL + 1
SENDMSG 7 英雄消耗3000元宝，成功升级至%H.level%级！
BREAK
#ELSEIF
H.CHECKLEVELEX > 59
H.CHECKLEVELEX < 101
CHECKGAMEGOLD > 5999
#ACT
GAMEGOLD - 6000
H.CHANGELEVEL + 1
SENDMSG 7 英雄消耗6000元宝，成功升级至%H.level%级！
BREAK
#ELSEACT
SENDMSG 5 英雄条件不满足！等级已达上限或元宝不足。
同时升级则合并主号和英雄的检测与扣费：
[@both_up]
#IF
CHECKLEVELEX < 100
H.CHECKLEVELEX < 100
CHECKGAMEGOLD > 1999
#ACT
GAMEGOLD - 2000
CHANGELEVEL + 1
H.CHANGELEVEL + 1
SENDMSG 7 消耗2000元宝，主号、英雄各升1级！
BREAK
#ELSEACT
SENDMSG 5 条件不满足！主号或英雄已达上限，或元宝不足。
**脚本调试要点与常见报错处理**
脚本写完后在引擎M2上加载，如果加载完成且无红色报错提示，不代表脚本一定正确。有些命令格式错误不会触发引擎报错，但进游戏后脚本执行不了或执行结果异常。常见原因包括空格格式错误、命令参数顺序颠倒、中英文标点混用等。
调试时先用GM命令调整角色状态，比如把元宝刷到足够数量、把等级卡在某个区间边界，逐条测试每个分段能否正确触发。观察SENDMSG的反馈信息是否与预期一致，元宝扣除量和等级变化量是否匹配。如果某条分支不执行，检查#IF下面的检测命令是否写错，或者#ACT后面的执行命令是否被BREAK提前终止。
