传奇单机增加npc

传奇单机版增加npc，必须同时完成脚本文件和入口配置两步：先在 `mirserver\mir200\envir\market_def` 中准备对话脚本，再在同目录下的 `merchant.txt` 登记地图、坐标、名称和外观。只新增脚本而不写入口，npc不会出现在地图上；只写入口而没有对应脚本，通常会出现npc但点击无反应。新增前先复制一份原文件备份，并从同版本中挑选一个功能相近的npc作为模板，避免混用不同引擎的字段格式。

最稳妥的操作顺序是先确认地图代码和坐标，再建立脚本文件，最后登记入口。假设要在版本内地图代码为3的位置330、330增加新手指南，可在 `market_def` 中新建 `新手指南-3.txt`，然后在 `merchant.txt` 增加类似 `新手指南 3 330 330 新手指南 0 15 0 0 0` 的一行。第一项对应脚本名称，第二项是地图代码，第三、四项是x和y坐标，第五项是游戏中显示的名称，后面的数字通常用于方向、外观、城堡属性和移动设置；不同引擎的字段数量可能不同，因此应优先复制原有npc整行，只修改脚本名、地图、坐标、显示名和外观编号。

脚本文件必须与入口名称、地图代码和目录层级完全对应，文件名中的连接符要使用英文半角短横线。脚本内容不要直接套用其他版本的完整代码，应打开同目录下一个能正常对话的npc文件，保留原有触发段和菜单写法，只替换npc名称、提示文字、传送坐标或奖励条件。新增后进入游戏检查三个结果：npc是否出现在指定坐标、点击后是否能弹出对话、菜单按钮是否能执行动作。坐标应选择可行走且不被建筑遮挡的格子，npc之间最好间隔1至2格，避免角色无法靠近或多个名称重叠；地图代码应以该服务端的 `mapinfo.txt` 和现有配置为准，不能把其他版本的地图编号直接照搬。

完成文件修改后，优先在管理工具中执行重载npc或重启m2引擎，若引擎不支持热加载则必须完整重启服务端再登录测试。npc可见但无法对话时，重点检查脚本路径、文件名后缀和首段触发标签；能对话但外观异常时，检查外观编号和客户端素材是否匹配；完全不显示时，检查 `merchant.txt` 是否保存为纯文本、地图代码是否正确、坐标是否超出地图范围。部分服务端使用 `npcs.txt` 配合 `npc_def` 管理固定npc，这类结构不能与 `merchant.txt`、`market_def` 混写，应照现有目录中的配置方式添加。新手只需复制一个普通npc完成静态显示，熟悉脚本后再加入传送、兑换、任务或条件判断功能，先保证入口、脚本、坐标三项稳定，再扩展交互内容。