传奇新人上线自动满血脚本配置全解析与GOM/GEE/HERO引擎命令对照

很多玩家在创建人物后第一次进入游戏时，经常不明不白地被出生地附近一级的稻草人或鹿之类的怪物打死，或者在进入新手练级地图时被里面的怪物爆掉。问题的根源在于：玩家创建人物进入游戏后，虽然血条看起来是满的，但实际上血量只有不到一半，加上新手装备防御力极低，被怪物打几下就会死亡。解决方法有两条路：通过登录脚本在人物上线时强制补满血量，或者从引擎底层调整升级规则让角色升级时自动满血。下面按触发文件定位、核心命令、各引擎脚本实例、引擎底层设置、脚本片段和排查要点六个层面展开。

一、触发文件定位

登录触发脚本的入口文件是 `Mir200\Envir\MapQuest_def\QManage.txt`，人物的上线、小退、升级、死亡等全局事件都在此文件中处理。部分版本使用 `QuestDiary\系统功能\QManage.txt`，如果MapQuest_def目录下没有QManage.txt，在QuestDiary目录下搜索同名文件即可。此外，`Mir200\Envir\Market_Def\QFunction-0.txt` 负责功能触发事件，与登录相关的补血逻辑通常写在QManage.txt中。脚本修改后需在M2控制器中重新加载脚本文件或重启服务端，仅保存文件不加载不会执行。

二、核心补血命令

补满血量涉及三个层面的命令，用途不同。

HumanHP命令直接在现有血量基础上增减数值，格式为 `HumanHP + 数值`，HumanMP同理。该命令加血量而非设置血量，适合在登录时给角色额外补充血量。数值上限为65535，超过该值部分引擎会截断或报错。

SetHumanHP命令直接将当前血量设置为指定值，格式为 `SetHumanHP 数值`。与HumanHP加算不同，SetHumanHP是覆盖式赋值。若需补满当前血量而非增加上限，使用SetHumanHP配合角色的最大血量值，或直接用RecoverHP命令。

RecoverHP和RecoverMP命令无需参数，执行后自动将当前血量或魔法值补满至上限。这是最直接的满血命令，适合在登录触发段中使用。

AddMaxHP命令用于永久增加角色的最大血量上限，执行后直接提升基础最大血量，不会随地图切换或角色下线清空。在登录脚本中配合使用AddMaxHP和RecoverHP，可以实现“先提升上限再补满当前血量”的效果。

三、GOM引擎脚本实例

GOM引擎的登录脚本写入QManage.txt的 `[@Login]` 触发段。基础满血脚本：

```
[@Login]
#IF
CHECKLEVELEX > 0
#ACT
RecoverHP
RecoverMP
SENDMSG 6 欢迎上线，血量魔法已补满
BREAK
```

这段脚本在人物每次上线时自动执行RecoverHP和RecoverMP，将血量和魔法值补满至上限。

如需对新人做额外处理，例如检测等级后给予满血并附加新手奖励：

```
[@Login]
#IF
CHECKLEVELEX < 10
#ACT
ChangeLevel + 5
HumanHP + 100000
HumanMP + 100000
RECALLMOB 变异骷髅
GIVE 回城卷 1
SENDMSG 6 你感觉体内热血沸腾，等级得到了提升
BREAK
```

这段脚本对10级以下的新人执行：提升5级、增加10万血量和魔法值、召唤变异骷髅协助战斗、给予回城卷。HumanHP后的数值按实际需求调整，不能超过65535，超过时需要多次执行或用SetHumanHP直接设置。

GOM引擎中HumanHP的最大有效值受引擎版本限制，部分版本支持到21亿以上，但标准GOM引擎建议控制在65535以内，超出部分可能不生效或触发数值溢出。

四、GEE引擎脚本实例

GEE引擎的登录触发结构与GOM一致，同样在QManage.txt中处理。GEE引擎支持 `CheckHpPer` 命令检测当前血量百分比，格式为 `CheckHpPer 操作符 百分比`，例如 `CheckHpPer < 100` 检测血量是否低于100%。结合该命令可以实现仅在血量不满时才补血的逻辑：

```
[@Login]
#IF
CheckHpPer < 100
#ACT
RecoverHP
RecoverMP
SENDMSG 6 血量已自动补满
BREAK
```

GEE引擎在2.1.0.10以上版本支持Lua脚本，登录脚本也可以用Lua编写，修改后无需重启服务器即可生效。

五、HERO引擎脚本实例

HERO引擎使用HumanHP和HumanMP命令增加血量，格式与GOM一致。Hero引擎还有一个常用命令SetHumanHP，用于直接设置血量值。转生后上线建议用“+”命令，避免覆盖角色本身的血量加成。

HERO引擎登录满血脚本：

```
[@Login]
#IF
CHECKLEVELEX > 0
#ACT
HumanHP + 65535
HumanMP + 65535
RecoverHP
RecoverMP
SENDMSG 6 血量魔法已恢复
BREAK
```

先用HumanHP增加65535点血量确保覆盖大多数低等级角色的血量缺口，再用RecoverHP补满至当前上限。

HERO引擎还有一个常见问题：升级时不会自动满血。这需要在M2Server的升级规则中设置，或在脚本的升级触发段中加入回满血蓝的指令。具体做法是在 `QFunction-0.txt` 的 `[@LevelUp]` 触发段中添加RecoverHP和RecoverMP命令。

六、BLUE引擎脚本实例

BLUE引擎的登录脚本同样写入QManage.txt。BLUE引擎支持 `HumanHP` 和 `AddHP` 命令修改血量。BLUE引擎的满血脚本写法与GOM类似，但部分版本的HumanHP参数格式有差异，需查阅对应引擎版本的命令说明。

BLUE引擎中一键满血脚本通常放在 `Market_Def` 目录下新建独立的NPC脚本文件，通过NPC对话触发。例如：

```
[@满血]
#IF
CHECKLEVELEX > 0
#ACT
HumanHP + 50000
HumanMP + 50000
SENDMSG 6 体力值和魔法值已瞬间恢复
BREAK
```

七、引擎底层升级满血设置

除了登录脚本补血，更彻底的方案是在M2Server中修改升级规则，让角色每次升级时自动满血满蓝。该设置对所有通过打怪、做任务升级的角色全局生效。

在M2Server控制台进入选项菜单，找到客户端设置或游戏设置中的升级相关选项，开启升级时自动补满HP和MP。部分引擎此选项位于M2的“功能设置”或“游戏规则”面板中。

如果引擎本身不支持该选项，可以在 `QFunction-0.txt` 的 `[@LevelUp]` 触发段中手动写入补血脚本：

```
[@LevelUp]
#IF
CHECKLEVELEX > 0
#ACT
RecoverHP
RecoverMP
BREAK
```

这段脚本在角色每次升级时自动补满血量和魔法值。

八、新人首次上线专属处理

新人首次登录与老玩家登录可以使用不同的触发条件区分。QManage.txt中的 `[@Login]` 段对所有角色生效，若只对新人处理，用等级检测条件限定范围：

```
[@Login]
#IF
CHECKLEVELEX < 10
#ACT
HumanHP + 10000
HumanMP + 10000
SENDMSG 6 新人福利：血量魔法已补满
BREAK
```

CHECKLEVELEX < 10条件确保脚本仅对10级以下的新角色执行，老玩家上线不会触发。等级阈值根据版本设置调整。

如果需要在角色创建时而非登录时补血，可以在 `MapQuest_def` 目录下创建专门的创建触发脚本，使用 `[@Create]` 触发段处理。

九、排查与常见问题

登录脚本不执行时，首先确认QManage.txt中是否存在 `[@Login]` 触发段，段名拼写是否正确。其次确认脚本末尾是否有Break语句，缺少Break会导致引擎继续执行后续脚本段产生异常。修改脚本后必须在M2控制器中重新加载脚本文件，仅保存不加载不会生效。

补血数值不生效时，检查HumanHP后的数值是否超过了引擎支持的上限。标准GOM引擎HumanHP数值上限为65535，超过该值需改用SetHumanHP直接设置，或分多次执行HumanHP。

RecoverHP命令不生效时，确认引擎版本是否支持该命令。部分老版本引擎不支持RecoverHP，需改用 `HumanHP + 65535` 配合 `HumanMP + 65535` 的写法。HERO引擎部分版本对RecoverHP支持不完整，建议使用HumanHP加算方式。

如果玩家上线后血量仍然不满，排查是否存在其他脚本段在登录后执行了扣血操作。检查QFunction-0.txt中是否有与登录相关的其他触发段，以及是否有定时器脚本在角色上线后短时间内修改了血量。

脚本文件编码需使用ANSI保存，UTF-8编码的中文内容在部分引擎中会显示为乱码，可能导致脚本解析失败。