传奇MerChant配置文件全字段含义与完整参数详解

MerChant是传奇引擎NPC登记的核心配置文件，所有游戏内可交互的NPC都必须在这个文件里完成登记，引擎才能正确识别NPC的生成位置、交互权限、外观属性等全部信息。每一行配置对应一个独立NPC，所有参数按固定顺序排列，任何一个字段填写错误都会直接导致NPC不显示、无法交互、权限异常等问题。
第一个参数为脚本命令，用于指定该NPC绑定的脚本文件路径，默认情况下填写NPC的名称即可，引擎会自动在Market_Def目录下找到对应名称的脚本文件，玩家点击NPC时自动加载执行对应脚本逻辑。如果需要绑定自定义路径的脚本，直接填写完整的相对路径即可，支持跨目录调用不同分类的脚本文件。
第二个参数为地图名，填写NPC生成所在地图的数字编号，必须和MapInfo.txt里登记的地图编号完全一致，填写错误会导致NPC直接生成在错误地图，或者完全无法加载显示。如果需要让NPC在多个地图同时生成，不能在同一行配置里重复填写地图名，必须新增一行完全独立的配置，分别指定不同的地图编号。
第三个参数为X坐标，填写NPC生成位置在对应地图上的横轴坐标数值，数值范围必须在该地图的有效坐标区间内，不能填写地图边界之外的无效坐标，否则NPC会生成在地图空气墙里，玩家无法正常点击交互。
第四个参数为Y坐标，填写NPC生成位置在对应地图上的纵轴坐标数值，和X坐标配合精准定位NPC的生成点位，两个坐标的数值必须同时落在地图的可通行区域内，不能落在水域、墙体等不可行走的地块上。
第五个参数为人物名称，也就是游戏内玩家看到的NPC显示名称，名称支持中文、英文、数字组合，不能包含特殊非法字符，名称长度不能超过引擎设定的上限，否则会出现名称显示不全的问题。
第六个参数为sFlag角方向，用于设定NPC生成时的初始朝向，数值范围0到7，对应游戏内的8个不同朝向，数值0代表NPC面向正右方，数值2代表面向正下方，数值4代表面向正左方，数值6代表面向正上方，其余数值对应四个斜向朝向。
第七个参数为APPR值，也就是NPC的外观代码，这个数值必须和MonGen.txt里登记的怪物外观ID完全对应，填写不同的数值可以让同一个NPC显示出完全不同的外观，支持自定义各类特殊NPC造型。
第八个参数为是否为沙城，该参数用于控制NPC的沙城专属显示权限，数值0代表所有玩家都可以正常看到该NPC，数值1代表只有沙巴克行会的成员才能看到该NPC，非沙城玩家完全看不到这个NPC的存在，常用于沙城专属的城主功能NPC配置。
第九个参数为sCanMove能否移动，该参数控制NPC是否可以自主移动，数值0代表NPC完全固定在当前坐标点，不会发生任何位置偏移，绝大多数功能NPC都设置为0；数值1代表NPC可以在当前地图内自主随机移动，适合配置巡逻类、游走类的特殊NPC。
第十个参数为sMoveTime移动时间，该参数仅在第九个参数设置为1时生效，单位为秒，用于设定NPC每次移动的时间间隔，比如填写数值30，就代表NPC每30秒随机移动一次位置，数值不能设置得过小，否则NPC会频繁瞬移导致游戏画面卡顿。
第十一个参数为tariff税率，该参数用于控制NPC商店交易时的税收比例，数值范围0到100，填写数值5就代表玩家在该NPC商店出售物品时，系统会自动扣除5%的金币作为交易税，数值设置为0时完全不扣除任何交易税，所有出售所得全额返还给玩家。
在基础的11个参数之后，还可以追加三个扩展自定义参数，用于实现NPC的变色特效功能。第一个扩展参数为变色模式，数值1代表NPC的名称和身体同时变色，数值2代表仅NPC的身体外观变色，数值3代表仅NPC的头顶名称变色。第二个扩展参数为变色间隔，单位为毫秒，用于设定NPC颜色切换的时间间隔，填写数值1000就代表每1秒切换一次颜色。第三个扩展参数为是否固定颜色，数值0代表NPC按设定的间隔循环切换不同颜色，数值1到7代表NPC固定显示对应编号的单一颜色，不会发生任何颜色变化。
配置完成后重启游戏引擎，所有登记的NPC就会自动在对应地图的指定坐标点生成，玩家点击NPC时引擎会自动加载对应绑定的脚本文件，执行预设的交互逻辑。如果NPC出现不显示的问题，优先检查地图编号、XY坐标、外观代码这三个核心参数，确认没有填写错误后再排查脚本文件的路径是否正确，就能快速定位并解决所有配置异常问题。