核心脚本文件定位
人物上线赠送功能完全由脚本驱动，不涉及引擎内核修改。主入口位于Mir200\Envir\MapQuest_def\QManage.txt中的[@Login]段，该段在玩家每次上线时自动触发。若版本结构复杂，可能会通过#CALL指令调用QuestDiary目录下的外部脚本文件（如登陆脚本.txt）进行模块化管理。
新人判定与职业分流逻辑
为防止老玩家重复领取，必须使用ISNEWHUMAN标签进行新人检测。配合checkjob命令实现职业分流，确保战士、法师、道士获取不同的初始装备。典型的多条件判断结构如下：
[@Login]
#IF
ISNEWHUMAN
checkjobwarrior
#ACT
give木剑1
give布衣(男)1
give金创药(小)4
ADDSKILL基本剑术1
Break
此脚本块执行后需用Break中断，避免逻辑穿透导致后续职业判断失效。
装备自动穿戴与位置映射
直接给予的装备默认在背包，需配合AutoTakeOnItem命令实现自动穿戴。该命令需在GIVE之后执行，且必须指定正确的装备位置编号（而非数据库字段）：
编号部位编号部位
0盔甲8左戒指
1武器9护身符
4头盔10腰带
5/6手镯11鞋子
示例代码：
#ACT
give青铜剑1
AutoTakeOnItem青铜剑1 //自动装备到武器位
give布衣(男)1
AutoTakeOnItem布衣(男)0 //自动装备到衣服位
技能直接学习与等级控制
无需通过技能书道具，使用ADDSKILL命令可直接将技能添加到角色技能栏。命令格式为ADDSKILL技能名称等级，其中等级参数通常为0（未修炼）或1（1级）。若需开局赠送满级技能，需先在Magic.DB中确认该技能的最大等级上限。
//法师开局送技能示例
#IF
ISNEWHUMAN
checkjobwizard
#ACT
ADDSKILL火球术1
ADDSKILL抗拒火环1
ADDSKILL诱惑之光1
全职业通用套装配置
对于单职业或通用版本，可移除职业判断，统一发放套装。建议配合CHECKBAGITEM检测背包空格，避免因背包满导致脚本报错。同时利用SENDMSG发送提示信息增强体验：
#IF
ISNEWHUMAN
#ACT
give新手木剑1
give新手布衣1
give回城卷5
ADDSKILL新手技能1
SENDMSG7新手礼包已发放至背包，请查收！
脚本加载与调试要点
修改QManage.txt后，无需重启整个服务端。在M2Server主控台依次点击“控制”→“重新加载”→“登录脚本”即可生效。若上线未触发，优先检查ISNEWHUMAN标签是否被其他全局脚本覆盖，或使用SENDMSG输出调试信息定位断点。
多引擎指令兼容性
GOM、GEE、LEGEND等主流引擎对上述基础指令（GIVE、ADDSKILL）兼容性良好。若使用HERO等老引擎，需注意AutoTakeOnItem的坐标参数可能略有差异，建议以对应引擎的帮助文档为准。
人物上线赠送功能完全由脚本驱动，不涉及引擎内核修改。主入口位于Mir200\Envir\MapQuest_def\QManage.txt中的[@Login]段，该段在玩家每次上线时自动触发。若版本结构复杂，可能会通过#CALL指令调用QuestDiary目录下的外部脚本文件（如登陆脚本.txt）进行模块化管理。
新人判定与职业分流逻辑
为防止老玩家重复领取，必须使用ISNEWHUMAN标签进行新人检测。配合checkjob命令实现职业分流，确保战士、法师、道士获取不同的初始装备。典型的多条件判断结构如下：
[@Login]
#IF
ISNEWHUMAN
checkjobwarrior
#ACT
give木剑1
give布衣(男)1
give金创药(小)4
ADDSKILL基本剑术1
Break
此脚本块执行后需用Break中断，避免逻辑穿透导致后续职业判断失效。
装备自动穿戴与位置映射
直接给予的装备默认在背包，需配合AutoTakeOnItem命令实现自动穿戴。该命令需在GIVE之后执行，且必须指定正确的装备位置编号（而非数据库字段）：
编号部位编号部位
0盔甲8左戒指
1武器9护身符
4头盔10腰带
5/6手镯11鞋子
示例代码：
#ACT
give青铜剑1
AutoTakeOnItem青铜剑1 //自动装备到武器位
give布衣(男)1
AutoTakeOnItem布衣(男)0 //自动装备到衣服位
技能直接学习与等级控制
无需通过技能书道具，使用ADDSKILL命令可直接将技能添加到角色技能栏。命令格式为ADDSKILL技能名称等级，其中等级参数通常为0（未修炼）或1（1级）。若需开局赠送满级技能，需先在Magic.DB中确认该技能的最大等级上限。
//法师开局送技能示例
#IF
ISNEWHUMAN
checkjobwizard
#ACT
ADDSKILL火球术1
ADDSKILL抗拒火环1
ADDSKILL诱惑之光1
全职业通用套装配置
对于单职业或通用版本，可移除职业判断，统一发放套装。建议配合CHECKBAGITEM检测背包空格，避免因背包满导致脚本报错。同时利用SENDMSG发送提示信息增强体验：
#IF
ISNEWHUMAN
#ACT
give新手木剑1
give新手布衣1
give回城卷5
ADDSKILL新手技能1
SENDMSG7新手礼包已发放至背包，请查收！
脚本加载与调试要点
修改QManage.txt后，无需重启整个服务端。在M2Server主控台依次点击“控制”→“重新加载”→“登录脚本”即可生效。若上线未触发，优先检查ISNEWHUMAN标签是否被其他全局脚本覆盖，或使用SENDMSG输出调试信息定位断点。
多引擎指令兼容性
GOM、GEE、LEGEND等主流引擎对上述基础指令（GIVE、ADDSKILL）兼容性良好。若使用HERO等老引擎，需注意AutoTakeOnItem的坐标参数可能略有差异，建议以对应引擎的帮助文档为准。