脚本定义与运行机制
传奇新手上线送装备脚本是服务端用于实现“玩家创建角色首次登录时，自动发放新手礼包”功能的程序代码段。该脚本并非独立程序，而是嵌入在版本主控制文件（如 QFunction-0.txt 或 QManage.txt）中的一段触发指令。
触发原理：当玩家客户端与服务器建立连接并完成角色加载后，引擎会检测脚本中预设的“新人标签”（如 ISNEWHUMAN），若条件成立，则执行 GIVE 命令将数据库中的指定物品发放到玩家背包或直接穿戴。
核心脚本文件与存放路径
不同引擎的脚本存放位置略有差异，但核心逻辑一致。常见路径如下：
引擎类型 主要脚本文件 存放路径（相对服务端根目录）
Hero / GOM / GEE QFunction-0.txt Mir200\Envir\Market_Def\
翎风 / 3KM2 QManage.txt Mir200\Envir\MapQuest_Def\ 或 QuestDiary\
注意：修改脚本后，必须在服务器控制台（M2Server）中执行“重载NPC脚本”或“重载QF脚本”才能使更改生效，无需重启整个服务器。
基础脚本代码示例（Hero引擎）
以下是一个标准的全职业新手赠送脚本，通常写在 QFunction-0.txt 文件的 [@Login] 段落后。
[@Login]
#IF
ISNEWHUMAN
#ACT
GIVE 木剑 1
GIVE 布衣(男) 1
GIVE 布衣(女) 1
GIVE 金创药（小量） 5
GIVE 魔法药（小量） 5
SENDMSG 6 欢迎新人！系统已赠送新手装备包。
BREAK
代码指令解析：
• #IF：条件判断开始，检查后续条件是否成立。
• ISNEWHUMAN：核心检测指令，判断该角色是否为第一次登录的新号。
• #ACT：动作执行，当上方条件成立时，执行下方的命令。
• GIVE：给予物品指令，格式为 GIVE <物品名称> <数量>。物品名称必须与数据库（StdItems.DB）中的名称完全一致。
• SENDMSG：发送游戏内提示消息。
• BREAK：中断当前脚本流程，防止后续脚本冲突。
进阶：按职业分发不同装备
为避免战士送法杖的尴尬，可使用 CHECKJOB 指令进行职业分流。这是更规范的写法：
[@Login]
#IF
ISNEWHUMAN
CHECKJOB WARRIOR
#ACT
GIVE 青铜斧 1
GIVE 轻型盔甲(男) 1
BREAK
#IF
ISNEWHUMAN
CHECKJOB WIZARD
#ACT
GIVE 海魂 1
GIVE 轻型盔甲(女) 1
BREAK
职业参数说明：
• WARRIOR：战士
• WIZARD：法师
• TAOIST：道士
常见错误与排查
1. 物品不显示：GIVE 命令后的物品名称必须与数据库 StdItems.DB 中的 NAME 字段严格一致，包括括号和空格。建议直接从数据库复制名称。
2. 脚本不生效：
◦ 检查文件路径是否正确，确认修改的是当前运行版本的脚本文件。
◦ 检查是否缺少 ISNEWHUMAN 检测，导致老号上线重复领取。
◦ 确认脚本语法是否正确（如缺少 # 号，或使用了全角符号）。
3. 刷屏或卡顿：若赠送物品过多，建议使用 AutoTakeOnItem 命令直接穿戴，避免背包满格导致发放失败。
与“GM命令”及“插件”的区别
• 脚本（Script）：被动触发。玩家上线→系统自动检测→自动发放。无需人工干预，是版本固有的功能。
• GM命令：主动操作。管理员在游戏内输入 @make 屠龙 或 @give 金币 100000，属于后台管理指令。
• 外挂/辅助插件：第三方程序，通过修改客户端内存或封包来实现“自动领装备”，属于违规行为，与本文所述的服务端脚本有本质区别。
总结：上线送装备脚本是服务端用于提升新手体验的标准配置，其本质是服务端引擎对特定登录事件的自动化响应逻辑。
