在传奇版本制作中，新手上线赠送装备是留住玩家的第一步。无论是赠送基础木剑、布衣，还是变态版本的满级神器、万元宝，其核心逻辑都依赖于登录脚本的触发机制。很多初学者在配置时容易出现“上线不送”、“重复领取”或“职业区分错误”等问题，根本原因在于对脚本标签和判断命令的理解不够透彻。本文将深入解析QManage.txt登录脚本的底层逻辑，手把手教你如何编写一套精准、稳定且具备职业区分功能的上线奖励脚本。
核心机制：理解登录脚本的触发原理
传奇引擎在处理玩家数据时，会实时读取特定的脚本文件。对于“上线送装备”这一需求，核心文件通常是QManage.txt（部分引擎可能略有差异，但逻辑通用）。在这个文件中，存在一个至关重要的内置标签——[@Login]。
[@Login]标签具有唯一性和强制性。它的触发条件是“人物每次进入游戏”。这意味着，只要玩家点击开始游戏，角色数据加载完毕出现在地图上，引擎就会立即执行[@Login]下方的代码。这与[@Main]标签不同，[@Main]通常用于NPC对话，需要玩家点击触发；而[@Login]是系统后台自动运行的，玩家无感知但必定执行。
在编写脚本时，必须明确区分“每次上线触发”和“仅第一次上线触发”的区别。如果代码直接写在[@Login]下且没有附加条件，玩家每次重进游戏都会重复领取奖励，这将瞬间破坏游戏经济平衡。因此，引入“新人检测”机制是编写此脚本的关键。
关键命令：检测新人与执行给予
要实现“仅限第一次上线领取”，必须使用引擎提供的检测命令。在大多数主流引擎（如GOM、GEE、996等）中，IsNewHuman是判断当前角色是否为本服首次登录的核心指令。
脚本的基本逻辑结构遵循“IF（判断） -> ACT（执行）”的范式。
#IF：这是判断段落的开始。在这里我们放置IsNewHuman。它的作用是询问引擎：“当前登录的这个角色，是不是第一次来到这个世界？”
#ACT：这是执行段落的开始。只有当上方的#IF判断结果为“是”时，引擎才会运行这里的命令。
GIVE：这是具体的给予物品命令。格式通常为GIVE 物品名 数量。
除了IsNewHuman，为了区分不同职业赠送不同装备（例如战士送裁决，法师送骨玉），还需要结合CHECKJOB命令。CHECKJOB用于检测职业，参数通常为0（战士）、1（法师）、2（道士）。通过组合这些命令，我们可以构建出严密的逻辑网。
脚本编写实战：分职业赠送方案
下面展示一段标准、通用的上线赠送脚本代码。这段代码实现了：检测是否为新人 -> 判断职业 -> 发放对应装备和通用货币（元宝/金币）。
[@Login]
;---------------------------------------
; 逻辑说明：检测是否为新人，若是则根据职业发放装备
;---------------------------------------
IF
IsNewHuman
CHECKJOB 0
ACT
GIVE 屠龙 1
GIVE 元宝 50000
GIVE 金币 2000000
BREAK
IF
IsNewHuman
CHECKJOB 1
ACT
GIVE 开天 1
GIVE 元宝 50000
GIVE 金币 2000000
BREAK
IF
IsNewHuman
CHECKJOB 2
ACT
GIVE 凤天 1
GIVE 元宝 50000
GIVE 金币 2000000
BREAK
代码深度解析：
段落分隔：每一组#IF和#ACT构成一个完整的逻辑块。
BREAK命令的重要性：在每个#ACT的末尾，务必加上BREAK。它的作用是“中断后续脚本执行”。如果不加BREAK，引擎在执行完战士的赠送后，可能会继续向下读取，导致玩家同时触发后续法师或道士的奖励，或者触发脚本中其他无关的逻辑。
性别区分（进阶）：如果你的版本对男女角色有严格区分，或者需要赠送性别专属装备，可以在#IF下增加CHECKGENDER命令（男/女）。但通常情况下，仅需区分职业即可满足大部分需求。
常见误区与排错指南
在实际配置过程中，很多GM会发现脚本写对了但游戏里没反应，或者出现其他异常情况。以下是几个高频问题的排查方向：
1. 脚本未生效：
最常见的原因是修改后未重启M2Server，或者未重新加载NPC脚本。在M2控制器中，点击“重新加载”或“重载脚本”是必须的操作步骤。此外，检查QManage.txt文件是否被保存，路径是否正确。
2. 每次上线都送（重复领取）：
这通常是因为脚本中遗漏了IsNewHuman判断，或者引擎版本较老不支持该命令。如果是后者，需要寻找该引擎专用的“新人标记”变量（如CHECKVAR配合特定全局变量）来替代。另一种情况是，玩家使用了某些漏洞重置了新人状态，这需要在M2设置中开启防刷检测。
3. 物品名称错误：
GIVE命令后的物品名称必须与数据库（StdItems或自定义数据库）中的名称完全一致，包括空格和特殊符号。如果数据库里叫“屠龙[神]”，脚本里写“屠龙”，玩家是无法收到的。建议直接复制数据库中的名称。
4. 逻辑冲突：
如果[@Login]下还有其他功能代码（如上线自动传送、上线顶赞检测等），要注意代码的排列顺序和BREAK的使用。错误的逻辑跳转（GOTO）可能会导致赠送装备的代码段被跳过。
扩展应用：从赠送装备到自动回收
掌握了上线赠送脚本，实际上就掌握了传奇脚本编写的基础。同样的逻辑可以延伸到“自动回收”功能。例如，在[@Login]下增加一段代码，检测玩家背包中是否有“回收凭证”，如果有则自动扣除并给予元宝。
此外，对于单职业版本，不需要区分职业，脚本可以简化为一段：
[@Login]
IF
IsNewHuman
ACT
GIVE 终极神器 1
GIVE 充值点 100
BREAK
这种简洁的写法适用于所有角色，减少了代码量，也降低了出错的概率。对于GM而言，灵活运用IsNewHuman、CHECKJOB和GIVE这三个核心要素，足以应对90%以上的开服奖励配置需求。切记，脚本编写重在逻辑严密，测试时务必建立新账号进行多轮验证，确保万无一失。
