HGE引擎登录脚本命令详解 - QManage登录触发配置教程

登录脚本是HGE引擎里人物一进游戏就自动跑一遍的专属脚本，写在Envir\MapQuest_def\QManage.txt里，专门在玩家登录瞬间执行欢迎提示、模式设置、新手礼包发放这类动作。

很多人以为欢迎语得靠每个NPC单独写一段，其实不对。把发消息、改攻击模式这类动作统一堆进登录段，玩家上线自动执行一次，不用挨个NPC点，这正是登录触发脚本存在的意义。

我最早搭本地测试版本时，把欢迎提示写进了普通NPC脚本，玩家点NPC才弹，小退重登后又得重新点，折腾半天才发现人物登录有专属文件和专属段名。下面把命令格式、参数、重载方法和踩过的坑逐个捋清楚。

命令格式详解

帮助文档给的功能说明很直接：即在人物进入游戏时自动执行的脚本，通过此脚本可对人物进行大量的功能控制。落点是Envir\MapQuest_def\目录下的QManage.txt文件，人物登录段用[@Login]标记，英雄登录段用[@HeroLogin]标记。

;脚本例子
[@Login]
#IF
 IsAdmin
#ACT
 CHANGEMODE 2 1
 CHANGEMODE 3 1
 SENDMSG 5 %s，欢迎进入游戏，当前模式为GM管理模式。

这段例子里，#IF后面跟IsAdmin判断是否为管理员，命中后#ACT依次执行CHANGEMODE开两种模式，再用SENDMSG 5在屏幕上弹出一句欢迎语。英雄进入游戏时另有一段：

[@HeroLogin]
#IF
#ACT
 SENDMSG 5 %s，欢迎你的英雄进入游戏。

命令名不区分大小写，写成@login也能识别，排查时重点看段名拼写和#IF、#ACT前后是否对齐，不要把大小写当成不触发的原因。

参数拆解

登录脚本本身没有复杂的数值参数，核心是两个触发段名和段内调用的子命令。段名决定这一段在什么时机跑，段内的#IF条件决定动作是否执行，普通玩家通不过管理员判断时这段动作就自动跳过。

这里的%s是人物名字占位符，SENDMSG 5后面跟的文本里写%s，引擎会自动替换成当前玩家的名字，不用手动去查玩家昵称再拼句子。

避坑要点

第一个坑是把登录脚本写错文件。很多人把[@Login]段写进QFunction-0.txt或者某个NPC脚本里，结果上线完全不触发。人物登录段固定认Envir\MapQuest_def\QManage.txt这个文件，放错位置引擎根本读不到。

第二个坑是改完不重载。帮助文档明确写了：该脚本更改后不须重启M2，可用@ReloadManage命令重新加载该脚本。改完直接进游戏测，没生效多半是没敲这条重载命令，脚本重载这一步不能省。

第三个坑是[@Login]和[@HeroLogin]混着写。主体人物的动作必须放[@Login]，英雄的动作必须放[@HeroLogin]，把英雄欢迎语写进[@Login]，英雄召唤出来时不会再跑一遍主体那段。

实战配置

第一步：从零搭一个登录欢迎脚本，打开Envir\MapQuest_def\目录，确认里面已经有QManage.txt；

第二步在文件末尾另起一段，写上[@Login]，下面跟#IF条件和#ACT动作；

第三步保存后在游戏里以GM身份敲@ReloadManage重载；

第四步小退再上线，看欢迎语和模式是否自动生效。

[@Login]
#IF
 IsAdmin
#ACT
 CHANGEMODE 2 1
 CHANGEMODE 3 1
 SENDMSG 5 %s，欢迎进入游戏，当前模式为GM管理模式。
#SAY
欢迎你回来，今天也要加油练级哦。

普通玩家的新手欢迎提示可以不加IsAdmin判断，把#IF那一行删掉，#ACT直接写SENDMSG 5 %s，欢迎来到新手乐园，这样所有玩家上线都能收到一句问候，不用跑任何NPC。

三阶拓展案例

初级案例：对照帮助文档的[@Login]骨架，只保留SENDMSG 5 %s，欢迎进入游戏，让每个玩家上线都弹一句问候。新手把这段复制过去把文本改改就能用，这是登录脚本最基础的用法。

中级案例：在[@Login]里加一段新手礼包发放。用变量判断玩家是不是首次登录，首次登录就GIVE一本技能书和一瓶金创药，再MOV一个标记变量防重复发。这样玩家第一次进游戏自动拿新手装备，不用专门跑NPC领取。

高阶案例：把[@HeroLogin]用起来做英雄上线补状态。玩家带着英雄上线时，[@HeroLogin]自动跑一段，给英雄补满血量魔法，再SENDMSG提示英雄已就位。再配合转生判断，转生玩家上线自动叠加攻魔道临时属性，把登录段做成一个上线状态初始化的总入口。

报错排查

登录脚本改了游戏里没反应

进游戏小退再上线仍然不触发，先检查QManage.txt的路径是不是Envir\MapQuest_def\下，文件名是不是QManage.txt一个字都不能差；再敲一次@ReloadManage确认重载成功。最常见原因就是改完忘了重载，或者把段名写到了别的脚本文件里。

登录段脚本报错红字提示

M2启动时如果QManage.txt里有语法错误，会在日志里报脚本错误行号。打开QManage.txt按行号定位，多半是#IF和#ACT没对齐、段名[@Login]后面少了中括号，或者SENDMSG文本里多了个特殊符号。改完再@ReloadManage重新加载。

英雄欢迎语不弹

英雄的动作必须写在[@HeroLogin]段里。如果只在[@Login]写了SENDMSG，英雄召唤上线时不会重复执行主体那段。把英雄欢迎语单独搬到[@HeroLogin]段，重载后再召唤英雄验证。

常见问题

1. QManage登录脚本改完要重启M2才生效吗？

不用重启M2。帮助文档明确说明该脚本更改后不须重启M2，在游戏里以GM身份输入@ReloadManage命令就能重新加载QManage.txt，脚本重载后小退再上线即可看到新效果，省掉反复重启本地服务端的时间。（本条问题整理自百度知道真实提问：服务端脚本改了游戏里面没变化2022-11）

2. 玩家上线自动发欢迎提示怎么写？

在Envir\MapQuest_def\QManage.txt里写[@Login]段，#ACT后加SENDMSG 5 %s，欢迎进入游戏。%s会自动替换成玩家名字，数字5是消息类型。不需要任何条件判断就去掉#IF行，这样所有玩家上线都收到新手欢迎提示。（本条问题整理自百度知道真实提问：QQ礼包脚本错误QManage2024-12）

3. 登录脚本和QFunction-0脚本有什么区别？

登录脚本QManage.txt管的是人物进入游戏那一刻自动执行的动作，上线跑一次；QFunction-0.txt管的是穿戴、拾取、喝药这类触发事件，是玩家在游戏过程中反复触发的。欢迎语、上线补状态放QManage，穿装备触发放QFunction，两段各司其职别放反。（本条问题整理自百度知道真实提问：QManage登录脚本报错2024-12）

4. 怎么让转生玩家上线自动加血加蓝？

在[@Login]段里先用CheckRenewLevel判断转生次数，命中转生等级后用ChangeModeEx之类的状态命令按转生重数叠加HP和MP临时属性。登录段每次上线都会重跑一遍，正好把这种需要持续生效的上线加成放在这里初始化，小退重登也不会丢。（本条问题整理自百度知道真实提问：登录脚本设置转生后血量蓝增加2009-08）

5. 英雄进游戏也要自动跑一段脚本怎么办？

用[@HeroLogin]段。帮助文档给出的标准写法是[@HeroLogin]下#IF留空、#ACT后写SENDMSG 5 %s，欢迎你的英雄进入游戏。主体人物登录跑[@Login]，英雄登录跑[@HeroLogin]，两段互不干扰，英雄相关的补状态、发提示都写在[@HeroLogin]里。

6. IsAdmin判断管理员模式怎么配合登录脚本用？

帮助文档的例子就是在[@Login]里#IF加IsAdmin，命中后#ACT执行CHANGEMODE 2 1和CHANGEMODE 3 1，再SENDMSG提示当前为GM管理模式。普通玩家通不过IsAdmin判断，这段GM模式动作只会对管理员生效，正好用来区分GM和普通玩家的上线待遇。

写在最后

登录脚本QManage.txt是玩家上线的第一个入口，把欢迎提示、GM模式、新手礼包、英雄初始化都收拢到[@Login]和[@HeroLogin]两段里，玩家一进游戏就自动跑完，不用再逐个NPC点。改完一定记得@ReloadManage重载，别动不动就重启本地服务端。

QManage.txt登录段相关案例已在本地HGE引擎环境逐项跑通；命令仅适配HGE引擎，部分其他引擎存在兼容可能性，跨引擎使用需要自行测试修改。本内容仅供单机本地学习调试、用于版本技术研究与功能测试。