一、前期准备：工具与核心文件定位
1. 必备工具清单
核心工具包括N++文本编辑器、WIL编辑器（素材查看工具）、DBC2000数据库管理工具、单机传奇服务端完整文件包。WIL编辑器用于查看NPC外观素材及计算编码，N++负责编辑配置文件与脚本，DBC2000用于补充NPC关联数据。
额外准备空文件夹，分类存放NPC外观素材、脚本文件，避免操作中文件混乱。所有工具需确保与自身单机引擎版本适配，常见GOM、GEE、蓝光引擎通用此套工具。
2. 核心文件路径确认
单机传奇NPC核心配置文件集中在服务端Mir200\Envir目录下：Merchant.txt为NPC总控制文件，记录NPC位置、外观、名称等基础信息；Market_Def文件夹存放NPC脚本文件，每个NPC对应独立脚本文件。
客户端素材路径为Data文件夹下的npc.wil文件，包含所有NPC外观素材，新增NPC外观需从该文件提取或导入，确保客户端能正常显示。
二、步骤一：确定NPC基础信息与外观编码
1. 基础信息规划
提前明确新NPC核心信息：地图位置（如比奇省、盟重省）、显示名称（如专属商人、任务使者）、功能类型（交易、传送、任务）、外观样式。地图编号可通过游戏内GM命令“@map”查询，输入后聊天框会显示当前地图编码。
例如规划新增“装备回收员”NPC，放置于比奇省（地图编码0），坐标328,265，外观选用铁匠样式，功能为回收装备兑换元宝。
2. 外观编码计算与提取
打开客户端Data文件夹，用WIL编辑器打开npc.wil文件，浏览并选中目标外观素材，记录该素材的第一张图片编号。外观编码计算公式为：（素材第一张图片编号÷60）-1，结果取整数即为服务端配置用编码。
举例：选中的铁匠素材第一张图片编号为1740，计算得（1740÷60）-1=28，该NPC外观编码即为28。若不想手动计算，可依次测试1-100区间编码，重启加载后确认外观是否符合预期。
三、步骤二：编辑Merchant.txt配置NPC基础信息
1. 配置格式说明
打开服务端Mir200\Envir\Merchant.txt文件，新增NPC需按固定格式填写字段，参数之间用空格分隔，格式为：脚本文件名 地图编码 坐标X 坐标Y 显示名称 预留参数1 外观编码 预留参数2。
其中预留参数可填0，脚本文件名需与后续创建的脚本文件名称一致，地图编码、坐标需与规划信息对应，外观编码填写第二步计算结果。
2. 填写配置内容
以新增“装备回收员”为例，在Merchant.txt文件末尾添加内容：装备回收员 0 328 265 装备回收员 0 28 0。填写后保存文件，若需隐藏原有NPC，可在对应配置行前加英文分号“;”注释。
注意文件名与显示名称可不一致，但建议保持统一便于管理，坐标需确保在对应地图内，避免NPC生成在地图边界外无法显示。
四、步骤三：创建NPC脚本文件（实现功能）
1. 脚本文件命名与创建
进入服务端Mir200\Envir\Market_Def文件夹，新建文本文档，按“脚本文件名-地图编码.txt”格式命名，例如“装备回收员-0.txt”。命名中地图编码需与Merchant.txt配置的地图编码一致，否则服务端无法读取脚本。
将文本文档用N++打开，开始编写脚本，脚本核心以“@main”为入口，定义NPC对话内容与功能逻辑，支持交易、传送、任务等多种功能实现。
2. 基础脚本编写示例
不同功能脚本格式不同，以下提供两种常用脚本示例，可按需修改适配：
1. 装备回收脚本（兑换元宝）：
(@main)
#say
欢迎来到装备回收处！\ 回收指定装备可兑换元宝。
沃玛装备回收/@wmhs
祖玛装备回收/@zmhs
关闭/@exit
(@wmhs)
#if
checkitem 沃玛号角 1
#act
take 沃玛号角 1
give 元宝 100
#say
回收成功！获得100元宝。
#elsesay
你没有沃玛号角，无法回收。
(@zmhs)
#if
checkitem 祖玛头像 1
#act
take 祖玛头像 1
give 元宝 300
#say
回收成功！获得300元宝。
#elsesay
你没有祖玛头像，无法回收。
2. 传送脚本（传送至指定地图）：
(@main)
#say
我可带你前往各大地图，需要吗？\ 猪洞七层/@zhudong
封魔殿/@fengmo
关闭/@exit
(@zhudong)
#if
checkgold 10000
#act
take 金币 10000
mapmove 717 300 300
#say
已为你传送至猪洞七层！
#elsesay
你没有10000金币，无法传送。
3. 脚本编写要点
脚本中“\”为换行符，确保对话内容分行显示；“#if”后为条件判断（如检查物品、金币、等级），“#act”后为满足条件执行的操作，“#elsesay”为不满足条件的提示内容。
可通过“@XXX”定义子段落，实现多选项功能，玩家点击黄色可点击文字触发对应段落。脚本编写完成后保存文件，避免语法错误导致功能失效。
五、步骤四：加载NPC并测试效果
1. 重载NPC生效
启动单机传奇服务端，打开M2Server.exe引擎控制器，点击“控制”→“重新加载”→“所有NPC”，等待加载完成即可生效，无需重启整个服务端。若未安装M2控制器，可登录游戏后输入GM命令“@reloadnpc”重载。
重载后切换游戏画面（如小退再登录、回城），前往目标地图坐标，即可看到新增NPC正常显示。
2. 功能测试与调整
点击NPC测试对话显示是否正常，功能是否可执行：回收脚本测试物品消耗与元宝获取，传送脚本测试金币扣除与地图跳转。若功能异常，检查脚本语法（如命令拼写、参数是否正确），修正后重新重载NPC即可。
若NPC外观显示异常，核对外观编码计算是否正确、Merchant.txt中编码填写是否有误，重新调整后重载生效。
六、不同引擎适配要点
1. GOM/GEE引擎
GOM/GEE引擎支持复杂脚本逻辑，新增NPC后若脚本不生效，需检查Market_Def文件夹权限，添加“Everyone”读取权限。外观编码需确保客户端npc.wil文件完整，缺失素材可从同引擎素材包中补充。
2. 蓝光/LEG引擎
蓝光引擎NPC配置文件为npcs.txt（对话型）与Merchant.txt（交易型），新增对话型NPC需编辑npcs.txt，脚本存放于Npc_Def文件夹，命名格式与Market_Def一致，重载命令同样为“@reloadnpc”。
3. 白日门引擎
白日门引擎NPC核心文件路径为Mir200\Envir\Npc，配置格式与通用版略有差异，外观编码无需手动计算，可直接在配置文件中选择素材编号，脚本编写规则与通用版一致。
七、常见问题排查与注意要点
1. 常见故障解决
NPC不显示：核对Merchant.txt配置格式（参数数量、地图编码）、脚本文件名与地图编码是否对应，重载NPC后切换游戏画面。脚本执行失败：检查命令拼写（如“mapmove”是否误写）、物品名称与数据库一致，修正语法后重载。
外观显示异常：重新计算外观编码，确认客户端npc.wil文件无损坏，缺失素材可复制同版本素材补充。重载NPC无反应：关闭服务端重新启动，检查M2控制器是否正常运行。
2. 实操注意要点
编辑配置文件与脚本前，备份原有文件，若操作出错可及时恢复。文件路径与命名禁止使用中文符号、空格，避免服务端无法读取。脚本命令区分大小写，核心命令（如#say、#act）需小写，参数（如物品名称）需与数据库一致。
单机版本可反复测试调整NPC功能与位置，优化体验，无需考虑多玩家影响，脚本可逐步添加复杂逻辑，丰富NPC玩法。
