在传奇游戏的服务端维护中，添加新NPC是版本修改最基础也是最核心的操作。无论是增加一个传送员，还是部署一个全新的功能商人，其底层逻辑都遵循着“脚本编写—参数配置—引擎加载”这一标准流程。许多初学者在操作时容易混淆脚本路径与配置文件的关系，导致NPC无法显示或点击无反应。实际上，只要理清M2引擎读取数据的顺序，掌握关键配置文件的语法格式，就能轻松实现NPC的自定义部署。
NPC脚本文件的创建与规范命名
一切始于脚本文件。NPC的“智慧”——即对话内容、功能跳转、物品交易逻辑，都存储在服务端Envir目录下的脚本文件中。通常，这些文件位于MirServerMir200EnvirMarket_Def目录下。在添加新NPC之前，首先需要在此目录下创建一个新的文本文件。
文件的命名至关重要，它必须遵循特定的格式规范才能被引擎正确识别。标准的命名格式通常为“NPC名称-地图号.txt”。例如，如果你想在盟重省（地图号通常为3）添加一个名为“屠龙刀匠”的NPC，那么脚本文件应命名为“屠龙刀匠-3.txt”。如果是在比奇城（地图号通常为0），则命名为“屠龙刀匠-0.txt”。这种命名方式不仅是管理员的整理习惯，更是许多引擎版本自动关联脚本的依据。文件内部需要包含标准的脚本标签，如[@main]作为对话入口，以及具体的功能代码。若文件为空或格式错误，NPC即便生成也无法进行交互。
配置文件Merchant.txt的参数详解
脚本文件创建完毕后，NPC并不会自动出现在游戏中，必须通过配置文件告诉引擎“在哪里生成”以及“长什么样”。这个关键的配置文件就是位于MirServerMir200Envir目录下的Merchant.txt（部分版本可能命名为Merchant.ini或包含在Npcs.txt中）。
打开该文件，需要在末尾添加一行配置代码。这行代码由多个参数组成，参数之间用空格分隔，每个参数都对应着NPC的一项属性。标准的配置格式如下：
脚本路径 地图号 X坐标 Y坐标 NPC显示名称 外观代码 是否沙巴克 自动刷新时间
以在盟重省坐标330:320处添加一个名为“屠龙刀匠”的NPC为例，代码可能如下：
Market_Def屠龙刀匠-3 3 330 320 屠龙刀匠 0 0 0
这里需要特别注意几个关键点。首先是“脚本路径”，它指向刚才创建的脚本文件，但不需要包含.txt后缀，且路径是相对于Market_Def目录的相对路径。其次是“地图号”，必须与脚本文件名中的地图号以及坐标所在的地图保持一致。最后是“外观代码”，这是一个决定NPC形象的数字，不同的数字对应客户端Monster.wil文件中的不同图像，可以通过游戏内的Ctrl+F4快捷键查询具体的外观代码表。
M2Server引擎的加载与重载机制
当脚本文件编写完毕，且Merchant.txt配置完成后，最后一步是让M2Server引擎读取这些更改。在服务器运行状态下，无需重启整个服务端，只需在M2Server控制台进行重载操作即可。
打开M2Server主程序界面，在顶部的菜单栏中找到“控制”或“功能”选项。在下拉菜单中，通常会有一个名为“重新加载所有NPC”或“重载NPC列表”的按钮。点击该按钮后，引擎会强制刷新内存中的NPC数据，重新读取Merchant.txt文件以及对应的脚本文件。如果配置无误，控制台会提示“加载成功”或无报错信息；如果存在路径错误或脚本语法问题，控制台会立即弹出错误日志，提示具体是哪一行代码出了问题。
故障排查与常见问题修正
在实际操作中，经常会遇到NPC不显示或点击无反应的情况。如果NPC在地图上不可见，首先应检查坐标是否正确，确认该坐标点没有被墙壁或其他障碍物遮挡。其次，检查Merchant.txt中的路径是否书写正确，特别是斜杠的方向和文件名的拼写。
如果NPC可见但点击后提示“脚本未找到”或没有任何反应，这通常是脚本文件命名或存放位置的问题。请再次确认脚本文件是否放在了Market_Def目录下，且文件名严格遵循“NPC名称-地图号.txt”的格式。此外，部分引擎版本对文件编码有严格要求，脚本文件必须保存为ANSI编码，若使用UTF-8编码可能会导致引擎无法识别中文字符，从而引发读取失败。通过逐一排查这些环节，即可解决绝大多数NPC添加失败的问题。
