BLUE引擎PLAYLEVELUP命令用法详解 - 升级奖励实现方法

刚开本地调试时，人物一升级就弹一堆提示，金币发了但不知道从哪来的。翻了一圈才发现是[@PLAYLEVELUP]段里写了两个#IF块，一个管封顶一个管发奖，结构没理清。PLAYLEVELUP是BLUE引擎中人物升级触发的QFunction触发段，每次主号升级时自动执行，可同时实现等级封顶和升级奖励发放。

PLAYLEVELUP触发段在哪个文件

和其他QFunction触发段一样，PLAYLEVELUP写在Market_Def目录下的QFunction-0.txt中。这个段在人物主号每次升级成功时执行，英雄升级不触发这个段。

源文档给出的脚本包含两个独立的#IF块：第一个块判断等级是否超限并拉回封顶值，第二个块无条件执行发奖逻辑。两个块写在同一个[@PLAYLEVELUP]段下，引擎依次执行。

封顶与发奖脚本结构

源文档给出的完整格式如下：

[@PLAYLEVELUP]
#IF
CHECKLEVELEX >= 70
#ACT
CHANGELEVEL = 70
SENDMSG 5 系统提示：本服目前封顶级别是70级，请不要再进行冲级，否则后果自负。

#IF
#ACT
GIVE 金币 2000
SENDMSG 5 恭喜：你的级别获得提高。

第一个块中CHECKLEVELEX >= 70检测人物等级是否达到70级，满足时CHANGELEVEL = 70把等级拉回上限。SENDMSG 5发送封顶提示。

第二个块中#IF后面没有写任何条件，表示条件恒真，每次升级都会执行。GIVE金币2000给玩家发2000金币，SENDMSG 5发送恭喜升级提示。两个块之间空一行分隔，方便阅读和维护。实际使用中可以在第二个块里追加多行GIVE命令，发放不同等级的装备或材料。

升级奖励发放配置实操

第一步，打开Market_Def目录下的QFunction-0.txt，在文件末尾追加[@PLAYLEVELUP]段。

第二步，写第一个#IF块做等级封顶：CHECKLEVELEX >= 加上限，CHANGELEVEL等于上限。

第三步，空一行后写第二个#IF块做升级奖励：#IF留空表示无条件，#ACT中用GIVE命令发物品，用SENDMSG 5发提示。

第四步，如果想控制奖励只发一次，在第二个块开头加CHECK变量条件，发完后MOV变量赋值为1。保存后重载QFunction脚本。

升级脚本不生效排查

写完PLAYLEVELUP段后如果升级没有反应，排查以下方向：

检查段名是否写成了[@PLAYLEVELUP]。确认#IF和#ACT段标记成对出现，第二个块的#IF后面即使无条件也要保留#IF标记。检查GIVE命令中的物品名称是否与StdItems.db中一致。确认是否在M2控制台重载了QFunction脚本。

如果每次升级都重复发奖，说明第二个#IF块没有加变量判断。在#IF段加CHECK变量0作为条件，发奖后MOV变量为1，这样奖励只在首次达到该等级时发一次。

常见问题

1. 升级奖励为什么每次都重复发？

源文档示例中第二个#IF块没有写任何条件，意味着每次升级都会执行GIVE金币2000。如果希望奖励只发一次，需要在#IF中加CHECK变量检测，发奖后MOV变量赋值。例如CHECK N0 0，发完后MOV N0 1，后续升级时N0已为1就不会重复发。（本条问题整理自百度知道真实提问：升级奖励重复发2014-08）

2. 内功封顶还涨经验和等级封顶有关吗？

PLAYLEVELUP段中的CHECKLEVELEX和CHANGELEVEL控制的是人物普通等级，不影响内功等级。内功有独立的升级体系，需要单独写[@IPLEVELUP]触发段来封顶。普通等级到70级封顶后，内功经验仍然可以继续增长，两套体系互不干扰。（本条问题整理自百度知道真实提问：内功封顶还涨经验2024-10）

3. 改了QFunction脚本游戏里没变化怎么办？

QFunction文件修改后不会自动生效，必须在M2控制台点击控制菜单下的重新加载QFunction脚本。如果重载后仍不生效，检查段名拼写、文件编码是否为GBK格式，以及脚本中是否有语法错误导致引擎跳过该段。（本条问题整理自百度知道真实提问：传奇服务端脚本改了，游戏里面没变化2022-11）

4. PLAYLEVELUP和HeroLevelUp有什么区别？

PLAYLEVELUP操作人物主号，命令不带H.前缀。HeroLevelUp操作英雄，命令带H.前缀。两个段在QFunction-0.txt中独立存在，人物升级只触发PLAYLEVELUP，英雄升级只触发HeroLevelUp。配置时不要把发奖命令写到错误的段里。

5. 想改成每5级发一次奖励怎么写？

在#IF段用CHECKLEVELEX检测具体等级，例如CHECKLEVELEX = 5、CHECKLEVELEX = 10，每个等级写一个独立的#IF块。或者用变量计数配合INC命令，累计升级次数达到5的倍数时发奖。多级奖励建议用多个条件块分别写，逻辑更清晰。

6. 第二个#IF块为什么要留空不写条件？

源文档示例中第二个#IF块后面不写任何条件命令，表示该块恒真，每次升级都执行。这是BLUE脚本的标准写法：#IF段中不写条件时默认条件成立。如果希望这个块也有条件判断，在#IF和#ACT之间写上需要的检测命令即可。

以上就是PLAYLEVELUP人物升级触发段的配置方法。PLAYLEVELUP通过两个#IF块分别实现等级封顶和升级奖励发放，第二个空条件块是每次升级必执行的发奖入口。

本文脚本案例已在本地BLUE引擎环境调试通过，PLAYLEVELUP段中的条件判断和发奖逻辑仅适配BLUE引擎，其他引擎的升级触发段名和参数可能不同。仅供单机本地学习调试。