一、前期准备：核心文件定位与工具准备
1. 必备工具与服务端确认
需准备已正常启动的传奇服务端（确保M2Server.exe可正常运行）、文本编辑器（Notepad++或记事本）、服务端核心文件（需包含完整Envir文件夹）。确认服务端Envir目录下存在Merchant.txt（NPC总控制文件）、Market_Def文件夹（NPC脚本存放目录），缺失则需重新覆盖服务端对应文件，避免添加失败。
2. 核心文件路径梳理
添加与加载NPC需操作3类核心文件，路径如下：1. NPC总控制文件：X:\mirserver\Mir200\Envir\Merchant.txt（记录所有NPC的地图、坐标、外观等基础信息）；2. NPC脚本文件：X:\mirserver\Mir200\Envir\Market_Def（所有NPC脚本均存于此，文件名需与Merchant.txt中配置对应）；3. 地图编码查询：通过M2引擎或游戏命令查看，管理员在游戏内输入“@map”可显示当前地图编码，用于配置NPC所在地图。
提前备份Merchant.txt文件与Market_Def文件夹，备份方式为复制原文件/文件夹至同一目录，重命名为“文件名_备份”（如Merchant_备份.txt），避免操作失误导致原有NPC丢失。
二、完整流程：M2引擎添加NPC（3步核心操作）
1. 第一步：配置Merchant.txt（NPC基础信息设置）
打开Merchant.txt文件，按固定格式在文件末尾新增NPC配置，格式为：“脚本文件名 地图编码 X坐标 Y坐标 NPC显示名 预留参数 外观编码 预留参数”。各参数说明如下：
- 脚本文件名：后续将在Market_Def中创建的脚本文件名（不含后缀.txt）；
- 地图编码：NPC所在地图的编码（如比奇省为0、土城为3），可通过“@map”命令查询；
- X/Y坐标：NPC在地图中的刷新位置（需避开障碍物与其他NPC，如土城安全区60 80）；
- 外观编码：NPC在游戏内的造型编号（如73对应经典传送员造型，可查询引擎外观对照表获取更多编号）。
示例配置（土城添加传送NPC）：“土城传送员 3 60 80 土城传送员 0 73 0”，配置完成后保存Merchant.txt文件。
2. 第二步：编写NPC脚本（Market_Def文件夹操作）
进入Market_Def文件夹，创建与Merchant.txt中“脚本文件名”对应的文本文件，命名格式为“脚本文件名-地图编码.txt”（如“土城传送员-3.txt”，地图编码需与Merchant.txt中一致），避免引擎无法识别脚本。
脚本编写采用传奇通用脚本语法，核心框架以(@main)为主体，包含对话显示与功能指令，示例脚本（传送功能）如下：
(@main)
#SAY
欢迎使用土城传送服务！\
<FCOLOR=250>1. 传送至比奇省</FCOLOR>/@比奇传送
<FCOLOR=251>2. 传送至封魔谷</FCOLOR>/@封魔传送
<FCOLOR=249>3. 关闭对话</FCOLOR>/@EXIT
(@比奇传送)
#ACT
MAPMOVE 0 329 266
SENDMSG 6 已传送至比奇省，请注意安全！
BREAK
(@封魔传送)
#ACT
MAPMOVE 4 237 305
SENDMSG 6 已传送至封魔谷，请注意安全！
BREAK
(@EXIT)
#ACT
CLOSE
BREAK
脚本说明：#SAY用于显示对话内容，\表示换行，FCOLOR设置文字颜色；@比奇传送为自定义跳转标签，MAPMOVE为传送指令（后接地图编码与坐标）；SENDMSG 6发送黄色系统提示，BREAK结束当前脚本段。
3. 第三步：M2引擎加载NPC（即时生效，无需重启服务端）
启动服务端核心程序，打开M2Server.exe（核心服务），进入主界面后点击顶部“控制”菜单，选择“重新加载”→“所有NPC”，等待3-5秒后，引擎会弹出“加载NPC完成”提示，新增NPC即可生效。
若仅修改已有NPC脚本，无需重新加载所有NPC，可点击“控制”→“重新加载”→“NPC脚本”，仅加载修改后的脚本文件，提升操作效率。加载完成后，切换游戏画面（如小退、回城）即可看到NPC显示。
三、M2加载NPC的3种方式（适配不同场景）
1. 常规加载：重新加载所有NPC（新增NPC专用）
操作路径：M2Server→控制→重新加载→所有NPC。该方式适用于新增NPC后，可一次性加载Merchant.txt中所有NPC信息与Market_Def中的脚本，确保新增NPC与原有NPC均正常显示。加载时需确保服务端无报错，若提示“脚本文件不存在”，需核对Market_Def中脚本文件名与Merchant.txt配置是否一致。
2. 精准加载：单独加载NPC脚本（修改脚本专用）
操作路径：M2Server→控制→重新加载→NPC脚本。该方式仅加载Market_Def文件夹内的脚本文件，无需加载所有NPC基础信息，适合修改已有NPC的对话、功能后快速生效，避免影响其他NPC运行。加载后需在游戏内点击NPC，确认脚本修改内容是否生效（如对话文字、功能指令）。
3. 强制加载：重启M2引擎（加载失败时使用）
若上述两种方式加载失败（如NPC不显示、脚本无响应），可采用强制加载方式：先按顺序关闭M2Server.exe、DBServer.exe，等待3-5秒后重新启动服务端（启动顺序：DBServer.exe→LoginSrv.exe→M2Server.exe），重启后引擎会自动加载所有NPC信息与脚本，适合解决配置文件读取异常导致的加载问题。
四、常见问题排查：添加与加载失败解决
1. NPC不显示（加载失败核心问题）
问题1：Merchant.txt配置格式错误。解决方案：核对配置参数是否完整（脚本文件名、地图编码、坐标、外观编码缺一不可），参数之间需用空格分隔（至少1个空格），避免中文空格或特殊字符；示例配置需符合“脚本名 地图编码 X Y 显示名 0 外观编码 0”格式。
问题2：脚本文件名与配置不匹配。解决方案：确认Market_Def中脚本文件名为“脚本名-地图编码.txt”（如“土城传送员-3.txt”），与Merchant.txt中的“脚本文件名”完全一致，区分大小写（如“TuCheng”与“tucheng”视为不同名称）。
问题3：地图编码错误。解决方案：通过游戏内“@map”命令查询目标地图编码（如土城编码为3），确保Merchant.txt中配置的地图编码与实际一致，编码错误会导致NPC刷新在错误地图。
2. 点击NPC无响应（脚本问题）
问题1：脚本语法错误。解决方案：检查脚本中标签是否成对（如(@main)对应正确结尾），指令是否大写（#SAY、#ACT、MAPMOVE等指令需全大写），换行符“\”是否正确使用，缺失或错误会导致脚本无法执行。
问题2：脚本缺失核心标签。解决方案：确保脚本包含(@main)主体标签，所有自定义功能标签（如@比奇传送）需有对应的#ACT指令与BREAK结尾，避免标签无响应。
3. M2加载提示“脚本不存在”
解决方案：检查Market_Def文件夹是否存在对应脚本文件，确认文件路径无中文、特殊字符（如“土城传送员-3.txt”不可包含空格）；若文件存在仍提示不存在，可重新创建脚本文件，复制内容后保存（避免原文件格式损坏），再重新加载。
五、拓展技巧：NPC个性化设置与M2优化
1. NPC个性化设置（外观、对话、功能）
外观调整：修改Merchant.txt中的外观编码，可更换NPC造型（如100对应城主造型、50对应道士造型），部分引擎支持通过WIL资源查看外观编号（M2→查看→列表信息(二)→WIL资源）。
对话优化：在脚本中添加文字颜色、图标与自动变色效果，示例：“<AUTOCOLOR=254,251,168>点击传送至尸王殿</AUTOCOLOR>/@尸王殿传送”，可提升玩家交互体验；也可添加图标显示，格式为<Img:5:510:1:10:10/@图标触发>（F为WIL文件序号，N为图片序号）。
功能拓展：添加条件触发功能，如等级限制、物品检测，示例：“(@高级传送)
#IF
CHECKLEVEL >= 40
CHECKITEM 金币 1000
#ACT
TAKEITEM 金币 1000
MAPMOVE 5 100 100
#ELSESAY
等级不足40级或金币不足1000，无法传送！”。
2. M2加载效率优化（多NPC场景）
批量添加NPC：在Merchant.txt中批量复制配置格式，修改对应参数（地图编码、坐标、脚本名），可快速添加多个NPC；脚本可通过#CALL指令调用通用功能（如批量传送脚本），减少重复编写。
隐藏与删除NPC：在Merchant.txt中对应NPC配置前添加英文分号“;”，即可注释隐藏NPC（如“;土城传送员 3 60 80 土城传送员 0 73 0”），无需删除配置，后续可取消注释恢复；删除NPC则直接删除对应配置行与脚本文件。
六、总结：M2添加与加载NPC核心要点
传奇M2引擎添加NPC的核心在于“配置正确+脚本规范”，需先在Merchant.txt中设置NPC基础信息，再在Market_Def中编写对应脚本，最后通过M2引擎加载即可生效。加载优先选择“重新加载所有NPC”（新增）或“重新加载NPC脚本”（修改），避免频繁重启服务端。
实操中需重点注意：配置文件格式规范、脚本文件名与配置一致、地图编码准确，提前备份核心文件可避免操作失误。通过个性化脚本编写与M2加载技巧，可快速添加各类功能NPC（传送、交易、任务），丰富游戏玩法。整体流程适配多数传奇服务端版本，无需专业技术，按步骤操作即可完成。
