增加一个可正常使用的npc必须同时完成入口配置和对话脚本两部分：前者决定npc出现在哪张地图、哪个坐标以及显示什么外观，后者决定玩家点击后能看到什么内容、执行哪些功能。操作前先复制保存`mir200\envir\merchant.txt`和`mir200\envir\market_def`目录，避免字段写错导致服务端无法读取；如果只是测试位置，可以先关闭相关服务进程，正式环境则建议在低峰期修改。npc增加通常没有玩家等级或元宝门槛，真正的前置条件是地图代码有效、坐标可通行、服务端目录可写，并且配置文件与脚本文件名称能够准确对应。
配置入口时，先打开`mir200\envir\merchant.txt`，在末尾新增一行，基础格式为脚本名称 地图代码 x坐标 y坐标 npc名称，例如`测试npc 3 353 337 测试npc`，其中`3`是地图代码，`353`和`337`分别是横纵坐标。需要自定义方向、外观或移动属性时，再按照当前版本已有npc的字段顺序补齐参数，不要直接照搬其他引擎的排列；常见扩展字段包括方向、形象编号、是否属于沙巴克、是否自动移动、移动间隔和变色参数。新手最稳妥的做法是复制同地图中一个能正常显示的npc配置，只修改脚本名、坐标和显示名称；外观编号则直接沿用已验证的数值，避免填入不存在的素材编号后只显示npc名字。
创建脚本时，在`mir200\envir\market_def`目录中建立与配置完全匹配的文件，例如地图代码为3时使用`测试npc-3.txt`，文件名中的连接符必须是英文半角短横线，中文名称、空格和大小写也要保持一致。脚本通常从`[@main]`入口开始，最简单的对话可以写成`[@main]`、`say`、`请选择功能\`，再接入`<传送服务/@teleportservice>`或`<仓库服务/@warehouseservice>`等按钮；按钮后方的标签必须在同一文件中定义，否则玩家能看到npc，却无法触发功能。功能型npc建议先复制一个已能运行的传送、仓库或商店脚本，再逐项替换文字和动作，先确认对话能打开，再添加扣除货币、检测等级、传送地图等条件。
完成配置和脚本后，在引擎控制面板执行重新加载—所有npc，支持热加载的gom版本通常无需重启；如果npc仍不出现，再完整重启服务端并重新登录角色。排查顺序应为：先确认地图代码和坐标是否正确，再检查`merchant.txt`是否保存为纯文本格式，然后核对脚本路径、文件名和`[@main]`标签，最后检查外观编号及客户端素材是否存在。npc完全不显示，通常是入口行、地图代码或坐标错误；能显示名字但没有人物外观，多半是形象参数无效；能看到npc但点击无反应，则优先检查脚本文件是否放在`market_def`、地图后缀是否一致。坐标最好选择空地或城内通行点，并避开已有npc，否则即使配置成功，也可能出现重叠、无法点击或玩家误触的问题。
