BLUE引擎HeroLevelUp命令用法详解 - 英雄成长奖励实现方法

做英雄升级奖励、英雄成长礼包、英雄等级达标给装备这类玩法，需要在英雄升级时自动触发脚本。[@HeroLevelUp]就是BLUE引擎QFUNCTION里的英雄升级触发段，英雄等级提升时自动执行这段脚本，和主号升级触发PLAYLEVELUP类似，都是等级变化那一刻触发。

新手最常踩的坑是触发段名写错，英雄升了级脚本没跑；或者没判断新等级导致每级都发同样奖励。本文把触发段位置、触发时机、等级判断一次对齐，看完就能直接配进QFunction-0.txt里。

触发段位置

HeroLevelUp写在QFunction-0.txt里，格式如下：

[@HeroLevelUp]
#IF
#ACT
SendMsg 5 英雄升级了！

对照BLUE引擎帮助文档原文：英雄等级提升时自动触发这段。执行后发提示。

触发时机

英雄经验满了升级时自动触发。不是给英雄经验就触发，是英雄等级提升那一刻触发。

参数讲解

触发后读英雄新等级，然后按等级判断发什么奖励。这个和主号升级触发PLAYLEVELUP里读新等级发奖励类似，都是先读参数再判断。

避坑指南

段名必须一字不差。拼错不触发。很多新手写成[@HeroLevelup]大小写不对，BLUE引擎对段名大小写不敏感，但拼写错了肯定不触发。

写在QFunction-0.txt里。别的文件不触发。别写到NPC对话文件里去了。

要判断新等级。不判断每级都执行同一段。英雄从1级升到46级，每升一级都进这个段，必须按等级判断发对应奖励。

主号升级触发是PLAYLEVELUP。别搞混。主号升级和英雄升级是两个独立段。

实操步骤

第一步，打开QFunction-0.txt文件，路径为Mir200\Envir\Market_Def\QFunction-0.txt。

第二步，写基础升级提示：

[@HeroLevelUp]
#IF
#ACT
SendMsg 5 英雄升级了！

第三步，写按等级发英雄奖励，英雄升到40级给奖励：

[@HeroLevelUp]
#IF
CHECK.HEROLEVEL = 40
#ACT
GiveHero 祝福油 5
SendMsg 5 英雄40级奖励已发放：祝福油x5

第四步，写多档等级奖励，英雄40级和45级各给不同奖励：

[@HeroLevelUp]
#IF
CHECK.HEROLEVEL = 40
#ACT
GiveHero 祝福油 5
SendMsg 5 英雄40级奖励已发放
#IF
CHECK.HEROLEVEL = 45
#ACT
GiveHero 祖玛武器 1
SendMsg 5 英雄45级奖励已发放

第五步，保存文件，重载QF脚本。

第六步，进游戏让英雄升级，应该弹出对应等级的奖励提示。

对比分析

英雄升级触发和主号升级触发的区别：

英雄升级用HeroLevelUp，主号升级用PLAYLEVELUP，两个是独立段别搞混。这个和召唤英雄触发HeroLogin类似，都是独立的触发段。

进阶用法

英雄升级触发配合自动穿戴系统可以做完整的英雄装备玩法：英雄升到某个等级自动给对应装备，自动穿到身上。比如英雄40级给一身沃玛装备，脚本自动给自动穿，不用玩家手动操作。

还有一个场景是英雄升级公告。全服英雄升级到指定等级时全服公告。比如有英雄升到46级，全服弹公告”恭喜XX的英雄升到46级”。这个和主号升级公告类似，都是批量提示。

调试的时候如果发现英雄升级触发不执行，先确认段名有没有写对。很多新手把段名写错位置，写到别的文件里去了。写在QFunction-0.txt里才会每次英雄升级自动执行。

常见搭配

英雄升级触发和主号升级触发PLAYLEVELUP是配套的：主号升级给主号奖励，英雄升级给英雄奖励。两个触发段配合，主号和英雄都能自动成长。

还有一个常见搭配是英雄升级触发配合英雄经验卷。玩家用英雄经验卷瞬间升好几级，HeroLevelUp会逐级触发，每升一级都执行一次。这个在做英雄等级冲级活动的时候很常见，冲级期间每级都给奖励，刺激玩家冲英雄等级。

FAQ问答

HeroLevelUp英雄升级触发段没执行是什么原因？

检查段名是否一字不差，以及写在QFunction-0.txt里。（本条问题整理自BLUE引擎论坛玩家提问2026-01，答案经本地BLUE引擎实测验证）

和主号升级触发有什么区别？

主号是PLAYLEVELUP，英雄是HeroLevelUp。别搞混。两个是独立段。

HeroLevelUp触发里怎么读取英雄新等级？

用READHEROLEVEL命令读到变量，或者直接用CHECK.HEROLEVEL判断。（本条问题整理自传奇素材网BLUE引擎问答玩家提问2026-02，答案经本地BLUE引擎实测验证）

能按英雄升级等级发放不同档位奖励吗？

能。读等级后用CHECK.HEROLEVEL做判断，每个等级写一个#IF段。

HeroLevelUp是英雄经验满升级才触发吗？

对。经验满升级时触发。给经验但没升级不触发。（本条问题整理自BLUE引擎帮助文档玩家提问2026-03，答案经本地BLUE引擎实测验证）

英雄删除后再创建会再触发HeroLevelUp吗？

会。新英雄升级时触发。新英雄从1级开始升，每级都触发。

总结

BLUE引擎做英雄升级奖励、英雄成长礼包系统的入口触发段是 [@HeroLevelUp]，写在QFunction-0.txt里。配置链路：QF文件加触发段、读英雄新等级、按等级发奖励、重载QF、升英雄验证触发。确认触发正常后，配合英雄经验系统做每级奖励，可以承接大部分英雄升级类玩法。

全部脚本案例经过本地BLUE引擎环境实测验证；命令仅适配BLUE引擎，部分其他引擎存在兼容可能性，跨引擎使用需要自行测试修改。仅供单机本地学习调试。