传奇Merchant.txt配置教程 NPC文件路径及格式详解

在传奇版本搭建、服务器运维、自定义功能开发过程中，NPC配置是基础核心操作。绝大多数新手版本架设报错、NPC不显示、跨服NPC失效等问题，均源于Merchant.txt文件路径错误、格式参数填写不规范。本文详细讲解传奇NPC配置文件默认路径、核心参数定义、常规NPC与跨服NPC标准写法，帮助运维人员…

在传奇版本搭建、服务器运维、自定义功能开发过程中，NPC配置是基础核心操作。绝大多数新手版本架设报错、NPC不显示、跨服NPC失效等问题，均源于Merchant.txt文件路径错误、格式参数填写不规范。本文详细讲解传奇NPC配置文件默认路径、核心参数定义、常规NPC与跨服NPC标准写法，帮助运维人员快速完成配置调试。

一、传奇NPC核心配置文件基础信息

1.1 文件默认存储路径

传奇服务端中，所有交易类、交互类NPC均由专用配置文件统一管理，该文件默认固定路径如下：

NPC配置文件默认路径：\Mir200\Envir\Market_Def

该目录为服务端核心环境目录下的专属NPC配置文件夹，所有NPC的注册信息、脚本关联信息均集中在此路径下读取。若路径修改或文件缺失，会导致服务端启动后所有自定义NPC无法加载、地图内无NPC显示等问题。

1.2 核心配置文件名称

目录内主配置文件为：Merchant.txt

该文件是传奇服务端识别NPC的核心文件，每一行独立代码对应游戏内一个NPC实体，支持定义NPC的位置、外观、归属、跨服属性等全部基础参数，是版本修改中使用率最高的配置文件之一。

二、Merchant.txt标准配置格式解析

2.1 完整配置字段结构

传奇所有NPC均遵循统一字段排序规则，字段之间以空格分隔，不可随意调整顺序、增减字段数量，完整配置格式如下：

NPC脚本路径   地图   X坐标  Y坐标  NPC名字  方向  外观  是否归属沙城  备用 备用 备用 备用  备用  跨服ID(不可重复)

2.2 逐字段功能说明

为避免参数填写错误，下面对每个必填、选填字段做详细释义，适配GOM、LEG等主流传奇引擎：

1. NPC脚本路径：关联NPC对应的功能脚本文件路径，指向Market_Def目录内的脚本文本，决定NPC的交互功能（买药、锻造、传送等）；

2. 地图：目标地图编号或地图名称，如比奇城地图标识、跨服地图专属标识，决定NPC刷新的地图位置；

3. X坐标/Y坐标：NPC在目标地图中的精准坐标，坐标偏差会导致NPC错位、隐藏不可见；

4. NPC名字：游戏内玩家可见的NPC显示名称，支持自定义中文命名；

5. 方向：NPC站立朝向参数，取值范围0-7，对应游戏内八个基础朝向；

6. 外观：NPC模型外观代码，对应服务端外观素材库，不同代码显示不同人物、怪物模型；

7. 是否归属沙城：权限参数，0为普通NPC（全玩家可见），1为沙巴克专属NPC（仅沙城成员交互）；

8. 备用字段：共5组预留参数，默认全部填写0，用于引擎后续拓展功能，常规配置无需修改；

9. 跨服ID：跨服场景核心参数，全局唯一不可重复，普通区内NPC填0，跨服NPC填写专属数字编号。

三、常规NPC与跨服NPC配置实例

3.1 区内常规NPC标准格式

常规NPC指仅在单区本地地图刷新、无跨服交互权限的普通功能NPC，如药店老板、仓库管理员、传送员等，标准实例代码如下：

【比奇城】/比奇城_药店 0108 7 7 赖家店老板 0 1 0 0 0 0 0 0

实例解析：脚本关联比奇城药店功能脚本，刷新于0108号比奇城地图（7,7坐标），名称为赖家店老板，朝向0、外观1，非沙城专属，无跨服权限。

3.2 跨服NPC标准格式

跨服NPC支持全服多区互通访问，核心要求是跨服ID全局唯一，不可与任何区内、其他跨服NPC编号重复，标准实例代码如下：

kuafu 跨服地图名 20 25 跨服NPC 0 23 0 0 0 0 0 1 100

实例解析：标识为跨服类型，刷新于指定跨服地图（20,25坐标），NPC名称为跨服NPC，朝向0、外观23，无沙城归属权限，全局唯一跨服ID为100。

四、常见配置报错及规避技巧

1. NPC不刷新：优先检查文件路径是否正确、Merchant.txt编码是否为ANSI、地图坐标是否超出地图有效范围；

2. 跨服NPC重复报错：核对跨服ID，确保全服所有配置文件中无重复编号；

3. NPC点击无反应：检查NPC脚本路径是否正确，关联的脚本文件是否存在、无语法错误；

4. 沙城NPC权限异常：核对是否归属沙城字段，普通玩家可见必须设置为0。

五、总结

Merchant.txt作为传奇NPC配置的核心文件，路径、字段顺序、参数唯一性是配置关键。运维人员只需牢记默认路径、规范填写常规NPC与跨服NPC参数，规避跨服ID重复、坐标无效等常见问题，即可快速完成各类NPC的添加与修改，适配传奇版本架设、功能定制等各类场景需求。