## 一、脚本调用机制深度解析
### （一）核心脚本文件调用规则
1. **系统级功能脚本**
- `QFunction-0.txt` 是引擎强制绑定的全局事件触发器（如死亡、升级、穿戴装备等），文件名和路径不可修改
- `QManage.txt` 负责登录触发事件，存放于`Mir200\Envir\MapQuest_Def`
- 其他功能脚本如`RobotDef\AutoRunRobot.txt`控制定时任务
2. **自定义NPC脚本调用流程**
```text
│── 步骤1：注册NPC坐标
│ 编辑 Mir200\Envir\Merchant.txt
│ 添加：装备领取/3 330 320 装备领取-3 0 8 0 0 0
│ （地图编号3，坐标330,320，关联脚本：装备领取-3.txt）
│── 步骤2：创建脚本文件
│ 在 Mir200\Envir\Market_Def 目录下
│ 新建 装备领取-3.txt
│── 步骤3：编写交互逻辑
│ [@main]
│ #SAY
│ <领取新手套装/@GetEquip>
│ <离开/@exit>
│── 步骤4：物品发放模块
│ [@GetEquip]
│ #IF
│ CHECKLEVELEX < 10
│ #ACT
│ give 木剑 1
│ give 布衣(男) 1
```
### （二）多脚本协同运作原理
```mermaid
graph TD
A[玩家点击NPC] --> B{Merchant.txt查表}
B -->|匹配NPC信息| C[调用Market_Def对应脚本]
C --> D[执行#ACT指令]
D --> E[关联QFunction-0.txt全局事件]
```
## 二、装备穿戴指令与编号规范
### （一）装备穿戴命令语法
```lua
TakeOnItem 装备名称 位置编号 操作对象
-- 示例：TakeOnItem 圣战项链 3 Hero（英雄穿戴）
```
### （二）装备位置编号对照表
| 装备位置 | 编号 | 对应数据库字段 | 特殊说明 |
|----------------|------|----------------|------------------------|
| 武器 | 2 | Stdmode=5 | 检测职业匹配 |
| 衣服 | 0 | Stdmode=10 | 分男女款式 |
| 项链 | 3 | Stdmode=19 | 可附加幸运属性 |
| 左手镯 | 1 | Stdmode=26 | 需区分左右 |
| 右手镯 | 2 | Stdmode=26 | 部分引擎支持双持 |
| 左戒指 | 7 | Stdmode=22 | 强化槽位独立 |
| 右戒指 | 8 | Stdmode=22 | 镶嵌宝石不叠加 |
| 勋章 | 9 | Stdmode=24 | 需鉴定激活属性 |
| 腰带 | 10 | Stdmode=27 | 影响负重上限 |
| 靴子 | 11 | Stdmode=28 | 移动速度加成 |
| 宝石 | 12 | Stdmode=29 | 套装效果触发 |
| 斗笠 | 13 | Stdmode=30 | 外观显示优先级最高 |
| 马牌 | 14 | Stdmode=31 | 骑乘状态切换 |
### （三）进阶穿戴控制技巧
1. **批量穿戴指令**
```lua
#ACT
TakeOnItem 圣战手镯 1
TakeOnItem 圣战戒指 7
SetIcon 1 888 0 0 // 添加装备特效
```
2. **穿戴条件检测**
```lua
#IF
CHECKJOB Warrior // 检测战士职业
CHECKITEMW 屠龙 // 检测是否持有武器
#ACT
TakeOnItem 战神盔甲 0
```
3. **自动更换策略**
```lua
[@OnDie]
#IF
CHECKITEM 复活戒指 1
#ACT
TakeOffItem 12 // 脱下当前宝石
TakeOnItem 复活戒指 12
```
## 三、典型NPC脚本开发实例
### （一）新手装备发放NPC
```lua
[@main]
#SAY
{COLOR=253 ★ 新兵福利官 ★}━━━━━━━━━━━━━━\
<请选择您的职业：/{$USERNAME}>\
<战士套装/@WarriorEquip> <法师套装/@WizardEquip> <道士套装/@TaoistEquip>\
[@WarriorEquip]
#IF
CHECKJOB Warrior
CHECKLEVELEX < 15
#ACT
give 青铜斧 1
give 轻型盔甲(男) 1
TakeOnItem 青铜斧 2
SENDMSG 6 战士装备已发放，自动穿戴武器！
#ELSEACT
SENDMSG 6 等级超过15级或职业不符！
[@WizardEquip]
...（类似结构）
```
### （二）智能装备回收NPC
```lua
[@Recycle]
#IF
CHECKITEM 圣战戒指 1
#ACT
TAKE 圣战戒指 1
GAMEGOLD + 5000
SENDMSG 0 玩家[%s]回收圣战戒指获得5000元宝！
#ELSEACT
SENDMSG 6 背包中未检测到可回收装备！
```
## 四、脚本调试与异常处理
### （一）常见调用故障排查
| 故障现象 | 解决方案 | 相关原理 |
|-----------------------|-----------------------------------|-----------------------|
| NPC不显示 | 检查Merchant.txt地图编号和坐标 | 地图参数错误 |
| 脚本未生效 | 确认Market_Def文件名后缀匹配 | 命名规范冲突 |
| 物品无法穿戴 | 验证Stdmode与位置编号是否匹配 | 数据库字段限制 |
| 特效丢失 | 补全Wil/Wzl资源文件 | 客户端资源缺失 |
### （二）日志追踪技术
```lua
#ACT
SAVELOG ..\QuestDiary\Debug.log [$(DATE)]尝试穿戴<$CURRICONITEM>
```
## 五、引擎兼容性说明
| 引擎类型 | 脚本差异点 | 适配建议 |
|---------------|-----------------------------|-----------------------|
| GOM引擎 | 支持动态进度条标签 | 使用<ProgressBar>语法 |
| GEE引擎 | 需启用LUA扩展模块 | 加载geem2.dll |
| LEGEND引擎 | 穿戴指令需指定V参数 | TakeOnItemEx格式 |
| HERO引擎 | 强化系统绑定独立数据库 | 配套HeroDB设置 |
通过本指南的系统化学习，开发者可掌握从基础脚本调用到复杂装备系统的全流程开发技能。建议结合引擎官方文档进行二次开发，同时参考反外挂方案确保脚本安全性。
