传奇新手上线送装备脚本核心是依托登录触发标签与变量校验，实现新角色首次上线自动发放新手装备，且仅发放一次，以下是具体编写逻辑、脚本框架及配置要点。
一、核心逻辑与触发机制
1. 核心逻辑
脚本遵循“上线触发-新手校验-装备发放-状态锁定”流程，通过专属登录标签捕捉角色上线行为，用变量标记是否为首次上线，校验通过后自动发放预设新手装备，发放完成后更新变量状态，避免重复发放，确保仅新手角色可领取。
2. 核心触发方式
新手上线脚本需绑定核心触发标签，适配新角色上线场景，通用触发标签及文件配置如下：
- @Login标签：角色每次上线都会触发，是新手装备发放的核心标签，可搭配变量精准筛选首次上线角色，排除老角色重复领取。
- 脚本存储文件：默认写入QManage.txt，该文件为传奇服核心脚本文件，存放所有登录相关触发逻辑，确保引擎加载时能识别执行。
补充说明：部分引擎支持@NewUser标签，仅新角色创建后首次上线触发，无需额外变量校验，适配更精准的新手场景，可根据引擎特性选择。
二、关键命令及用法
脚本依赖触发标签、变量操作、装备发放、提示反馈四类命令，不同引擎（HERO、GOM、GEE）格式略有差异，以下为通用版用法，需对照引擎手册微调。
- 变量操作命令：SETROLEVAR 角色名 变量名 数值（绑定角色永久变量，下线不丢失，用于标记是否领取装备）、CHECKROLEVAR 角色名 变量名 数值（校验变量状态，判断是否为首次上线），常用变量名如“NewUserEquipGot”（标记装备领取状态）。
- 装备发放命令：GIVE 物品名称 数量（直接发放装备至角色背包）、GIVE2 物品名称 数量 位置（指定装备佩戴位置，如武器栏、衣服栏），确保新手上线即可穿戴。
- 角色校验命令：CHECKLEVEL 等级（校验角色等级，通常限定1级新手领取，排除升级后新角色）、CHECKJOB 职业编号（区分战士、法师、道士，发放对应职业装备）。
- 提示反馈命令：SENDMSG 颜色代码 内容（界面文字提示，告知新手装备发放结果），常用颜色代码2为绿色（成功提示），提升新手体验。
三、不同场景脚本完整框架
1. 通用版新手上线送装备脚本（全职业通用）
功能：1级新角色首次上线，自动发放基础新手装备，仅可领取一次，适配所有职业。
1. // 通用新手上线送装备脚本（写入QManage.txt的@Login标签下）
2. CHECKLEVEL 1 // 校验角色等级是否为1级
3. IF ERROR // 等级不为1级，终止脚本
4. GOTO END
5. CHECKROLEVAR $USERNAME NewUserEquipGot 1 // 校验是否已领取装备
6. IF NOT ERROR // 已领取，提示并终止
7. SENDMSG 2 新手装备已领取，祝您游戏愉快！
8. GOTO END
9. // 未领取，发放新手装备
10. SENDMSG 2 欢迎新手上线，获得专属新手装备！
11. GIVE 布衣 1 // 发放新手衣服
12. GIVE 木剑 1 // 发放新手武器
13. GIVE 强效太阳水 3 // 发放补给道具
14. SETROLEVAR $USERNAME NewUserEquipGot 1 // 标记已领取，锁定权限
15. END: // 脚本结尾
2. 职业专属新手装备脚本（精准适配）
功能：根据新手职业发放对应专属装备，提升职业适配性，1级首次上线可领取。
1. // 职业专属新手装备脚本（写入QManage.txt的@Login标签下）
2. CHECKLEVEL 1
3. IF ERROR
4. GOTO END
5. CHECKROLEVAR $USERNAME NewUserEquipGot 1
6. IF NOT ERROR
7. GOTO END
8. SENDMSG 2 欢迎新手上线，获得职业专属新手装备！
9. // 战士职业装备发放
10. CHECKJOB 0 // 0为战士职业编号（按引擎数据库调整）
11. IF NOT ERROR
12. GIVE 轻型盔甲 1 // 战士新手衣服
13. GIVE 青铜剑 1 // 战士新手武器
14. // 法师职业装备发放
15. ELSEIF CHECKJOB 1 // 1为法师职业编号
16. GIVE 法师长袍 1 // 法师新手衣服
17. GIVE 偃月 1 // 法师新手武器
18. // 道士职业装备发放
19. ELSEIF CHECKJOB 2 // 2为道士职业编号
20. GIVE 道袍 1 // 道士新手衣服
21. GIVE 桃木剑 1 // 道士新手武器
22. // 通用补给发放
23. GIVE 强效太阳水 3
24. SETROLEVAR $USERNAME NewUserEquipGot 1
25. END: // 脚本结尾
3. @NewUser标签专属脚本（精准触发版）
功能：仅新角色创建后首次上线触发，无需等级校验，直接发放装备，适配支持该标签的引擎。
1. // @NewUser标签新手装备脚本（写入QManage.txt）
2. @NewUser // 仅新角色首次上线触发
3. SENDMSG 2 新手专属装备已发放至背包，请注意查收！
4. // 职业专属装备发放
5. CHECKJOB 0
6. IF NOT ERROR
7. GIVE2 轻型盔甲 1 4 // 直接发放至衣服栏（4为衣服栏位置编号）
8. GIVE2 青铜剑 1 0 // 发放至武器栏（0为武器栏位置编号）
9. ELSEIF CHECKJOB 1
10. GIVE2 法师长袍 1 4
11. GIVE2 偃月 1 0
12. ELSEIF CHECKJOB 2
13. GIVE2 道袍 1 4
14. GIVE2 桃木剑 1 0
15. GIVE 强效太阳水 5 // 补充更多补给
16. RETURN // 结束脚本
四、脚本配置与调试要点
1. 配置步骤
1. 文件定位：找到服务器安装目录下MirServer\Mir200\Envir文件夹，打开QManage.txt。
2. 标签绑定：无@Login标签则手动添加，将脚本内容粘贴至标签下方，确保格式正确。
3. 参数适配：替换职业编号、装备名称、栏位编号，确保与服务器数据库一致，避免装备发放失效。
4. 引擎重启：保存文件后重启传奇引擎，使脚本生效，未重启则无法加载执行。
2. 常见问题排查
- 装备无法发放：检查装备名称与数据库一致，职业编号是否匹配，部分引擎需给变量加前缀（如H_、G_），需对照手册调整。
- 重复发放装备：变量赋值命令遗漏或错误，需确认SETROLEVAR命令是否执行，可添加调试提示核对变量值。
- 职业装备发放错误：职业编号与引擎数据库不匹配，需在数据库中查询对应职业编号，替换脚本中的参数。
- 提示不显示：SENDMSG命令颜色代码超出0-255范围，或脚本被提前终止，检查GOTO END命令位置是否合理。
五、实操建议与功能拓展
1. 实操注意事项
1. 备份文件：修改QManage.txt前备份原始文件，若配置错误可快速恢复，避免影响服务器运行。
2. 测试验证：创建不同职业的1级新角色，测试装备发放、重复领取拦截功能，确保无逻辑漏洞。
3. 引擎适配：HERO引擎变量需加“H_”前缀，GOM引擎支持栏位精准发放，需根据所用引擎调整命令格式。
2. 功能拓展方向
可按需添加装备自动穿戴、新手buff加成、等级达标回收新手装备功能。装备自动穿戴用GIVE2命令指定栏位实现；新手buff通过ADDHP、ADDMP命令添加临时属性；等级回收需补充等级校验与TAKE命令，回收新手装备并发放进阶道具。
