传奇NPC无法买卖修理物品脚本数据库配置与引擎命令排查修复全解

NPC点击后不弹买卖界面、修理选项灰色点不动、或者对话框能打开但提示不支持该操作，这些现象在传奇服务端架设中统称为NPC交易功能失效。故障点分布在三个层面：NPC脚本头部的功能声明缺失、物品数据库的字段配置错误、以及引擎层面的物品规则限制。很多人只改了脚本文件就以为能解决，结果发现修理还是不行，原因就是另外两个层面的配置没有同步处理。下面按修复优先级从高到低逐项拆解。

NPC脚本头部功能声明缺失是最高发的故障原因

传奇引擎在加载NPC脚本时，首先读取文件顶部括号内的功能声明。括号内的内容决定了这个NPC具备哪些交互能力，引擎根据声明去初始化对应的功能模块。如果声明中没有写上买卖修理相关的标识，引擎就不会为这个NPC挂载交易功能模块，玩家点击后自然没有任何交易界面弹出。

标准的功能声明写在NPC脚本文件的第一行，格式是用括号包裹的命令列表，后面跟物价百分比和物品分类编号。一个完整的买卖修理NPC脚本头部示例如下：

```
(@buy @sell @repair @s_repair) %100 +5 +6
```

括号内的每个命令对应一种功能。@buy控制买入，@sell控制卖出，@repair控制普通修理，@s_repair控制特殊修理。@storage是存仓库，@getback是取仓库，@upgradenow是升级武器，@getbackupgnow是取回升级武器，@makedrug是炼药，@@sendmsg是发祝福语。这些标识按实际需求添加，不需要的功能可以省略不写，但买卖和修理是最基础的几项，商店类NPC通常全部保留。

括号后面的%100是物价系数，%100表示按数据库Price字段的原始价格交易，%150是1.5倍物价，%80是八折。这个数值影响买入和卖出的价格计算，写错不会导致功能失效，但会导致价格异常。后面的+5 +6是物品分类编号，不同的数字组合代表这个NPC允许交易的物品类别。举例来说，+19 +20 +21对应项链店，只有项链类物品可以在这里买卖和修理；+22 +23对应戒指店；+3 +25 +30对应杂货店。如果省略了分类编号，引擎会认为这个NPC没有指定可交易的物品类型，交易功能同样会失效。分类编号的含义因引擎版本和版本设置不同而有差异，需要参考对应引擎的说明书确认。

脚本头部修改完成后，还需要确认脚本文件中确实写入了[@main]段以及对应的<买/@buy><卖/@sell><修理/@repair>按钮。头部声明只是告诉引擎这个NPC具备哪些能力，[@main]段中的按钮才是玩家实际点击的入口。两者缺一不可。只写了头部声明但没有在[@main]中放置对应的跳转按钮，玩家看不到操作选项；只在[@main]中写了按钮但没有头部声明，点击后引擎找不到对应的功能模块，同样没有反应。

物品数据库Price字段为0导致无法修理

NPC脚本配置正确但修理功能仍然不可用，问题大概率出在物品数据库层面。传奇的物品数据库StdItems.DB中，Price字段不仅控制物品的出售价格，同时还控制物品的维修价格。Price字段被设置为0的物品，引擎在修理逻辑中会将其判定为不可修理物品，无论NPC脚本怎么写都不会生效。

排查方法是打开Mirserver\Mud2\DB目录下的StdItems.DB文件，用DBC2000或无极数据库工具打开。逐个检查玩家反映无法修理的装备，查看其Price字段的值。如果值为0，说明这件装备在设计上就是不可修理的，需要将其修改为一个大于0的数值。修改的范围没有硬性限制，通常参考同类型同等级装备的Price值来设置。修改完成后保存数据库文件，在M2Server控制台的物品设置中执行重新加载物品数据库，或者直接重启M2Server使修改生效。

除了Price字段，还需要检查物品的Need字段和Reserved字段。Need字段如果被设置为非0值，且NPC脚本中的物品分类编号与Need字段不匹配，物品也不会出现在交易列表中。Reserved字段中的特定位控制物品的交易权限，部分设置会禁止物品在NPC处进行买卖和修理操作。排查时对照引擎的物品规则说明逐项核对。

物品名包含引擎保留字同样会导致修理失败。部分传奇引擎对物品名称中的特定字符有特殊处理逻辑，例如名称中包含“符”字的物品在某些版本中会被引擎自动归类为不可修理类型。如果确认Price字段正常但仍然无法修理，尝试将物品名称中的可疑字符替换为其他字再测试。

MerChant.txt中NPC配置参数错误

NPC脚本写对了、数据库也改好了，但NPC在游戏中根本不出现或者出现后点击没有反应，问题出在MerChant.txt这个NPC注册文件中。MerChant.txt位于Mirserver\Mir200\Envir目录下，每一行记录一个NPC的完整配置信息。引擎启动时读取这个文件，按照行内的参数在指定地图和坐标生成NPC，同时将NPC与Market_Def目录下的脚本文件关联起来。

配置行的标准格式包含多个字段：脚本文件名、地图号、坐标X、坐标Y、NPC显示名称、朝向、外观编号，以及后续的扩展参数。脚本文件名必须和Market_Def目录下实际存在的txt文件名一致，去掉地图号后缀。例如Market_Def目录下有一个文件叫“武器店-3.txt”，MerChant.txt中对应的脚本名就写“武器店”。如果MerChant.txt中写的名称和实际文件名不一致，引擎加载时找不到对应的脚本文件，NPC要么不生成，要么生成后点击无任何反应。

坐标参数写错的表现比较隐蔽。NPC可能正常出现在地图上，但位置和预期不符。坐标X和坐标Y必须是整数，且在地图的有效范围内。如果写入了超出地图范围的坐标，引擎不会报错，NPC会生成在地图边缘或根本不生成。排查时先用GM命令飞到目标地图，手动走到NPC应该出现的位置，用GM命令查看当前坐标，和MerChant.txt中写的坐标对比。

文件编码格式同样需要注意。MerChant.txt和Market_Def下的NPC脚本文件都必须保存为ANSI编码。如果用记事本编辑后保存为UTF-8格式，文件开头的BOM字符会被引擎当作脚本内容的一部分，导致脚本第一行的功能声明被BOM字符污染，引擎无法正确解析，NPC功能全部失效。用Notepad++打开文件，在编码菜单中确认当前显示的是“ANSI”，如果不是，选择“转为ANSI编码”后保存。

引擎的物品规则和CheckItemList.txt限制

脚本和数据库都排查完毕后，如果修理功能仍然不可用，需要检查引擎层面的物品规则设置。3K引擎和GOM引擎的CheckItemList.txt文件中记录了每个物品的四项操作权限：扔地上、交易、存仓库、修理。文件格式是物品名称后跟四个数字位，数字位为1表示禁止该操作，0表示允许。例如某物品的配置行写成“木剑0110”，表示禁止交易和存仓库，允许扔地上和修理。如果玩家反映某件装备无法修理，检查这个文件中该装备的配置行，第四个数字位如果为1，说明修理被明确禁止了。

这个文件位于服务端Envir目录下，修改后需要在M2Server控制台执行重新加载物品列表，不重启或者不执行重载操作的话，修改不会生效。另一种排查方式是直接在M2Server控制台的菜单栏中找到选项，进入物品规则设置界面，在列表中搜索目标物品，查看禁止修理的勾选框是否被选中。取消勾选后保存，效果等同于修改CheckItemList.txt。

GOM引擎还有一个特有的限制：NPC文件头部如果缺少特定分类编号，修理命令也会失效。GOM引擎的修理功能依赖于脚本头部括号内的分类编号，例如修理衣服类装备需要在头部添加+10 +11，修理武器需要添加+5 +6。这些分类编号告诉引擎这个NPC可以对哪类物品执行修理操作。如果NPC头部只写了(@buy @sell)但没有写上对应的修理分类编号，即使脚本中有[@repair]段，引擎也不会执行修理命令。

QFunction-0.txt功能扩展脚本的冲突

部分服务端使用QFunction-0.txt作为全局功能扩展脚本，这个文件可以实现和普通交易NPC一样的买卖、存取、修理功能。如果QFunction-0.txt中存在与目标NPC同名的功能声明或冲突的脚本段，可能导致NPC的交易功能被覆盖或拦截。QFunction-0.txt位于Market_Def目录下，编写方式与普通NPC脚本不同，顶部标签必须是[@Member]，使用呼出命令触发而非直接点击NPC。

排查时先确认服务端中是否存在QFunction-0.txt文件。如果存在，检查其中是否有与故障NPC相关的功能定义。临时处理方式是把QFunction-0.txt重命名为QFunction-0.txt.bak使其失效，重启M2Server后测试NPC功能是否恢复。如果恢复，说明是QFunction-0.txt中的冲突导致的。确认冲突段落的具体内容后，修改或删除相关段落即可。

物品修复命令不生效的引擎差异

部分服务端的NPC脚本中使用了RepairAll命令来实现全身修理，但GOM引擎和GEE引擎对这个命令的支持方式不同。GOM引擎的RepairAll命令会自动计算磨损并扣除对应金币，命令本身包含扣费逻辑。而GEE引擎中如果使用RepairAll，可能因为引擎内部扣费机制的差异导致修理失败但不报错。排查时在M2Server控制台的日志窗口中查看命令执行记录，确认RepairAll命令是否被执行以及是否返回了错误信息。

GOM引擎的全身修理标准写法需要使用两个命令配合：CheckNeedRepair用于判断玩家是否有需要修理的装备，RepairAll用于执行修理，RepairAllCost用于扣除修理费用。如果只写了RepairAll而没有写RepairAllCost，修理不会扣费，部分版本的引擎会因为缺少费用参数而拒绝执行修理操作。正确的脚本写法是先在#IF段中用CheckNeedRepair检测装备状态，用CheckGold检测金币是否充足，然后在#ACT段中执行RepairAll命令，再跟上RepairAllCost扣除对应金币。

对于老版本引擎不支持RepairAll命令的情况，需要改用逐栏位修理的写法。遍历角色身上的武器、衣服、头盔、项链、手镯、戒指、腰带、靴子八个装备位置，分别使用对应位置的修理命令逐件修复。这种写法脚本行数较多但兼容性最好，在HERO引擎和早期GOM引擎上都能正常工作。

排查顺序建议

遇到NPC不能买卖修理的问题时，按以下顺序排查效率最高。第一步打开NPC脚本文件，确认第一行的功能声明括号中是否包含@buy @sell @repair @s_repair，以及是否写入了正确的物品分类编号。第二步检查StdItems.DB中目标物品的Price字段值是否为0，如果是则修改为正常数值并重新加载数据库。第三步打开MerChant.txt，核对NPC配置行的脚本文件名、坐标和编码格式是否正确。第四步检查CheckItemList.txt中该物品的修理位是否被禁止。第五步临时禁用QFunction-0.txt测试是否存在脚本冲突。每一项修改完成后重启M2Server或者执行对应的重载操作，立即用测试账号验证效果，不要同时做多项改动，否则无法判断是哪一步修复生效的。