传奇特修NPC全流程添加指南，从零基础到安全区精准部署

## 一、特修NPC原理与核心文件定位
在传奇私人服务器中，特修NPC（特殊修理NPC）是玩家修复装备耐久度的重要功能载体。其核心由**参数配置**与**交互脚本**两部分构成，涉及以下关键文件：
- **Merchant.txt**：位于`D:\mirserver\Mir200\Envir\`目录，定义NPC名称、坐标、外观等基础属性
- **Market_Def脚本文件**：存放于`D:\mirserver\Mir200\Envir\market_def\`目录，控制NPC对话逻辑与功能触发
- **NPC素材文件**：需通过WZL补丁（如npc.wil）或自定义PAK资源实现外观显示

---
## 二、土城安全区特修NPC搭建全流程
### 步骤1：确定坐标与地图编号
- **土城安全区定位**：使用GM命令`@map`查看当前坐标（通常土城地图编号为3，安全区坐标可选330:330附近）
- **防止坐标冲突**：通过`Merchant.txt`检查现有NPC坐标，避免重叠

### 步骤2：修改Merchant.txt参数
1. 打开`D:\mirserver\Mir200\Envir\Merchant.txt`，添加一行配置：
```plaintext
特修服务 3 330 330 装备特修师 0 78 0 0 0
```

- **参数详解**：
- `特修服务`：脚本文件名前缀（需与Market_Def文件对应）
- `3`：土城地图编号
- `330 330`：安全区坐标
- `装备特修师`：NPC显示名称
- `78`：外观代码（经典铁匠形象，可替换为自定义素材）

### 步骤3：编写特修功能脚本
1. 在`Market_Def`目录创建`特修服务-3.txt`文件（注意文件名必须与Merchant.txt中的"特修服务"一致）
2. 写入以下脚本内容：
```lua
[@main]
#IF
#SAY
<尊敬的勇士，我能修复你所有装备的耐久！>
<全身修理/@repairall> <单件修理/@repairitem>
<离开/@exit>

[@repairall]
#ACT
RepairAll
SENDMSG 6 你的装备已全部修复！

[@repairitem]
#ACT
RepairItem
SENDMSG 6 请将需要修理的装备放在手上！
```

- **功能扩展**：
- **收费模式**：添加`TAKE 金币 10000`实现每次修理收取1万金币
- **特效触发**：插入`PlayEffect 5 330 330 1`添加修理光效

### 步骤4：自定义NPC外观（可选）
- **传统素材替换**：使用WIL编辑器修改npc.wil中78号素材
- **GOM引擎PAK补丁**：
1. 在`Merchant.txt`中设置形象代码为10000+
2. 通过M2引擎加载PAK文件，设置起始图片编号与播放帧数

---
## 三、加载与调试要点
### 服务端生效方式
- **M2控制台操作**：点击“查看”->“列表信息二”->“重新加载NPC”
- **重启验证**：若NPC未显示，需彻底重启服务端并清理缓存

### 常见问题排查

| 现象 | 原因分析 | 解决方案 |
|---------------------|--------------------------|----------------------------|
| NPC名称显示但无对话 | 脚本文件命名错误 | 检查文件名是否包含"特修服务-3.txt" |
| NPC位置偏移 | 坐标被其他物体阻挡 | 使用`@move`命令调整坐标 |
| 功能无效 | 脚本命令语法错误 | 检查RepairAll/RepairItem拼写 |


---
## 四、高级定制技巧
### 动态变色NPC实现
在Merchant.txt末尾追加参数：
```plaintext
特修服务 3 330 330 装备特修师 0 78 0 0 0 **1 500 0**
```

- **参数解析**：
- `1`：名称+身体同时变色
- `500`：每0.5秒变色间隔
- `0`：随机颜色

### 跨地图连锁服务
在比奇城（地图0）同步添加同名NPC，实现双城特修网络：
```plaintext
特修服务 0 300 300 装备特修师 0 78 0 0 0
```

需在`Market_Def`创建`特修服务-0.txt`脚本

---
## 五、安全与版权注意事项
- **防刷漏洞**：在脚本中添加`CHECKLEVELEX > 50`限制低等级玩家使用
- **素材版权**：自定义NPC外观需避免直接复制官方素材

通过以上流程，玩家将在土城安全区看到闪烁的装备特修师，实现一键修复装备功能。建议首次部署后邀请测试员验证交互流畅度，并根据玩家反馈优化对话文本与收费梯度。