一、传奇商店NPC运行底层与MerChant.txt作用说明
热血传奇服务端所有可交易、可售卖、可回收的功能NPC，全部依托Envir目录下的MerChant.txt文件驱动运行。该文件是服务端商店NPC的核心配置文件，负责定义NPC名称、地图刷新坐标、外观模型、对话脚本、售卖物品列表、交易比例、功能权限等全部核心参数。常规版本自带的老兵、杂货铺、武器店、衣服店NPC，其刷新规则与售卖内容，均由该文件内的对应代码行控制。
手动新增装备售卖NPC，无需修改引擎内核、无需新增脚本程序，仅通过编辑MerChant.txt配置参数，搭配对应物品数据库参数匹配，即可快速落地专属装备商店功能。多数新手搭建版本时出现NPC不刷新、点击无反应、物品不显示、无法购买售卖等问题，根源均为MerChant.txt参数格式错误、字段缺失、坐标错乱、物品ID不匹配导致。
区别于玩家摆摊、游戏寄售系统，自定义商店NPC为系统固定交易单元，数据永久留存、不受玩家上下线影响，可自由定制专属高阶装备、稀有道具、套装装备的售卖与回收规则，是版本个性化修改、丰富发育路径的基础操作。
二、新增售卖NPC前置文件与环境准备
正式配置前需核对服务端核心文件完整性，保证MerChant.txt、StdItems.DB、NPC脚本文件三者数据互通匹配。首先打开服务端Mirserver\Envir目录，确认MerChant.txt文件存在且可正常编辑，文件编码统一为ANSI格式，修改编码会直接导致引擎无法识别配置内容，NPC加载失效。
打开DB数据库工具，查看StdItems.DB数据表，记录需要上架售卖的装备对应ItemID编号、装备名称、属性参数，后续商店配置必须精准匹配ItemID，ID错误会造成商店空白、物品加载失败、点击报错等问题。区分普通装备、专属装备、套装装备的数据库字段，确认装备无隐藏锁定参数，支持交易售卖功能。
提前确定NPC刷新地图与坐标，常规售卖NPC统一放置在主城安全区地图，记录对应地图编号、X轴坐标、Y轴坐标，坐标可通过游戏内F12坐标拾取功能获取，避免手动输入坐标偏差导致NPC刷新错位、卡地图、无法点击等问题。同时穴NPC外观代码，适配传奇原版NPC模型，保证游戏内正常显示。
三、MerChant.txt完整字段逐行详解
MerChant.txt采用单行单NPC配置格式，每一行完整参数对应一个独立商店NPC，字段以空格分隔，固定顺序不可打乱、不可缺失、不可增减字段。全套标准字段包含NPC名称、地图编号、X坐标、Y坐标、朝向、外观代码、脚本文件、功能标记、预留参数九大固定模块，每个字段具备专属作用，任一参数出错都会导致NPC失效。
第一个字段为NPC自定义名称，支持中文自定义，对应游戏内鼠标悬浮名称、头顶显示名称，可根据功能自定义为专属装备商店、高阶套装兑换、神器售卖等个性化名称。第二个字段为地图编号，必须匹配服务端MapInfo.txt内的标准地图代码，主城地图固定为0，其他副本地图、野外地图需对应真实编号。
第三个、第四个字段为X、Y刷新坐标，精准控制NPC在地图内的站立位置，坐标超出地图范围会导致NPC无法刷新。第五个字段为NPC朝向，数值0至4对应上下左右四个朝向，常规统一设置为2，面向玩家主流行走方向。第六个字段为NPC外观代码，对应游戏客户端NPC模型编号，数值错误会出现NPC透明、模型错乱、显示异常问题。
第七个字段为绑定脚本文件名，所有售卖、回收、对话逻辑均由对应txt脚本控制，脚本存放于Envir\Market_Def目录，文件名必须与MerChant配置完全一致，无需添加后缀。第八个字段为商店功能标记，固定数值0、1、2三类，0为普通对话NPC、1为标准售卖商店NPC、2为回收兑换NPC，新增装备售卖NPC统一填写1。第九个字段为引擎预留参数，固定填写0即可，无需修改。
四、手把手新增装备售卖NPC完整实操步骤
4.1编写MerChant.txt刷新配置
用记事本打开MerChant.txt文件，在文件末尾另起新行，按照固定字段顺序编写全新NPC配置代码。严格遵循字段空格分隔规则，禁止中文空格、多余空行、换行错乱。完成编写后，核对地图编号、坐标、外观代码、功能标记全部参数无误，保存文件。
标准示范格式：专属装备商人0330330215Market_装备商店10。该行代码含义为，在0号主城地图330330坐标，生成外观15的专属装备商人NPC，绑定Market_装备商店脚本，开启商店售卖功能，预留参数默认归零。
4.2创建对应商店交易脚本
进入Envir\Market_Def目录，新建文本文档，将文件名严格修改为配置中对应的Market_装备商店，保证文件名完全一致，大小写统一。打开脚本文件，编写标准商店开启指令与装备售卖列表，脚本语法遵循传奇引擎通用商店格式。
脚本首行固定为[@main]，作为NPC对话触发入口，第二行编写游戏内弹窗提示文字，第三行使用shop指令开启商店界面，后续逐行添加售卖装备参数。每条售卖指令对应一件装备，格式为shopitem+空格+ItemID+空格+售卖金币价格，精准匹配数据库ItemID，价格根据版本玩法自定义设置。
可批量添加多件装备，包含祖玛套装、赤月套装、雷霆高阶装备、专属神器等，逐行排列无数量上限。脚本末尾添加返回对话指令，完善交互逻辑，保存文件并关闭编辑器。
4.3服务端重载配置生效
无需重启整套服务端，直接打开传奇引擎主控制台，找到脚本重载、NPC重载功能，依次执行重载NPC配置、重载商店脚本两条指令。引擎会自动读取新增MerChant配置与商店脚本，加载完成后控制台提示读取成功、NPC注册完成。
进入游戏对应地图坐标，即可看到新增装备售卖NPC，点击NPC正常弹出商店界面，展示所有预设装备，支持正常购买、扣除对应货币、物品自动进入背包，整套基础功能搭建完成。
五、高级配置：差异化装备商店规则设置
5.1限购次数配置
在商店脚本内添加限购指令，可设置单件装备每日购买次数、账号限购次数，避免高频批量获取高阶装备。通过玩家个人变量记录购买次数，每日零点自动清零，实现循环限购规则，适配高阶稀有装备售卖场景。
5.2准入条件配置
可在脚本头部添加等级判定、转生判定、职业判定指令，设置商店准入门槛。未满足条件的玩家点击NPC仅弹出提示文字，无法打开商店界面，实现等级专属、转生专属、职业专属的差异化装备商店，丰富版本玩法层级。
5.3多货币售卖配置
原版默认仅支持金币售卖，可通过脚本修改扣费指令，替换为元宝、积分、声望、行会贡献等多类货币扣费方式，同时支持多种货币混合扣费，打造积分兑换商店、元宝高阶装备商店等特色功能。
六、新增NPC常见报错问题与精准解决方法
NPC完全不刷新：大概率为MerChant.txt格式错误、地图编号错误、坐标超出地图范围、文件编码异常。核对字段顺序无错乱，坐标替换为游戏内实测可用坐标，文件重新保存为ANSI编码，重载配置即可恢复。
NPC刷新成功点击无反应：脚本文件名与MerChant配置不匹配、脚本文件缺失、脚本首行指令错误。核对Market_Def目录脚本文件名完全对应，重新编写[@main]入口指令，修复残缺脚本代码。
商店打开空白、无装备显示：装备ItemID填写错误、数据库无对应装备数据、售卖指令格式错误。对照StdItems.DB重新核对ID，修正脚本shopitem指令格式，删除无效错误参数。
点击购买无响应、不扣货币不掉物品：装备存在交易锁定属性、脚本扣费指令缺失、背包空间不足判定失效。解除装备交易锁定参数，补全脚本扣费与物品发放逻辑，添加背包空格检测代码。
七、MerChant.txt长期维护与批量优化规范
所有自定义商店NPC统一在文件末尾新增配置行，不改动原版系统NPC参数，避免原生商店功能失效。新增脚本文件统一规范命名，按照功能分类命名，方便后期批量修改、删减、维护。每次修改配置后优先使用引擎重载功能测试，无需频繁重启服务端，提升搭建与修改效率。
批量添加多件装备时，统一排序规则，按照装备等级、品类、稀有度依次排列，保证商店界面整洁有序。高阶装备单独设置专属商店，与基础道具商店拆分，避免功能混杂、界面杂乱，让版本交易体系更加规整清晰。
热血传奇服务端所有可交易、可售卖、可回收的功能NPC，全部依托Envir目录下的MerChant.txt文件驱动运行。该文件是服务端商店NPC的核心配置文件，负责定义NPC名称、地图刷新坐标、外观模型、对话脚本、售卖物品列表、交易比例、功能权限等全部核心参数。常规版本自带的老兵、杂货铺、武器店、衣服店NPC，其刷新规则与售卖内容，均由该文件内的对应代码行控制。
手动新增装备售卖NPC，无需修改引擎内核、无需新增脚本程序，仅通过编辑MerChant.txt配置参数，搭配对应物品数据库参数匹配，即可快速落地专属装备商店功能。多数新手搭建版本时出现NPC不刷新、点击无反应、物品不显示、无法购买售卖等问题，根源均为MerChant.txt参数格式错误、字段缺失、坐标错乱、物品ID不匹配导致。
区别于玩家摆摊、游戏寄售系统，自定义商店NPC为系统固定交易单元，数据永久留存、不受玩家上下线影响，可自由定制专属高阶装备、稀有道具、套装装备的售卖与回收规则，是版本个性化修改、丰富发育路径的基础操作。
二、新增售卖NPC前置文件与环境准备
正式配置前需核对服务端核心文件完整性，保证MerChant.txt、StdItems.DB、NPC脚本文件三者数据互通匹配。首先打开服务端Mirserver\Envir目录，确认MerChant.txt文件存在且可正常编辑，文件编码统一为ANSI格式，修改编码会直接导致引擎无法识别配置内容，NPC加载失效。
打开DB数据库工具，查看StdItems.DB数据表，记录需要上架售卖的装备对应ItemID编号、装备名称、属性参数，后续商店配置必须精准匹配ItemID，ID错误会造成商店空白、物品加载失败、点击报错等问题。区分普通装备、专属装备、套装装备的数据库字段，确认装备无隐藏锁定参数，支持交易售卖功能。
提前确定NPC刷新地图与坐标，常规售卖NPC统一放置在主城安全区地图，记录对应地图编号、X轴坐标、Y轴坐标，坐标可通过游戏内F12坐标拾取功能获取，避免手动输入坐标偏差导致NPC刷新错位、卡地图、无法点击等问题。同时穴NPC外观代码，适配传奇原版NPC模型，保证游戏内正常显示。
三、MerChant.txt完整字段逐行详解
MerChant.txt采用单行单NPC配置格式，每一行完整参数对应一个独立商店NPC，字段以空格分隔，固定顺序不可打乱、不可缺失、不可增减字段。全套标准字段包含NPC名称、地图编号、X坐标、Y坐标、朝向、外观代码、脚本文件、功能标记、预留参数九大固定模块，每个字段具备专属作用，任一参数出错都会导致NPC失效。
第一个字段为NPC自定义名称，支持中文自定义，对应游戏内鼠标悬浮名称、头顶显示名称，可根据功能自定义为专属装备商店、高阶套装兑换、神器售卖等个性化名称。第二个字段为地图编号，必须匹配服务端MapInfo.txt内的标准地图代码，主城地图固定为0，其他副本地图、野外地图需对应真实编号。
第三个、第四个字段为X、Y刷新坐标，精准控制NPC在地图内的站立位置，坐标超出地图范围会导致NPC无法刷新。第五个字段为NPC朝向，数值0至4对应上下左右四个朝向，常规统一设置为2，面向玩家主流行走方向。第六个字段为NPC外观代码，对应游戏客户端NPC模型编号，数值错误会出现NPC透明、模型错乱、显示异常问题。
第七个字段为绑定脚本文件名，所有售卖、回收、对话逻辑均由对应txt脚本控制，脚本存放于Envir\Market_Def目录，文件名必须与MerChant配置完全一致，无需添加后缀。第八个字段为商店功能标记，固定数值0、1、2三类，0为普通对话NPC、1为标准售卖商店NPC、2为回收兑换NPC，新增装备售卖NPC统一填写1。第九个字段为引擎预留参数，固定填写0即可，无需修改。
四、手把手新增装备售卖NPC完整实操步骤
4.1编写MerChant.txt刷新配置
用记事本打开MerChant.txt文件，在文件末尾另起新行，按照固定字段顺序编写全新NPC配置代码。严格遵循字段空格分隔规则，禁止中文空格、多余空行、换行错乱。完成编写后，核对地图编号、坐标、外观代码、功能标记全部参数无误，保存文件。
标准示范格式：专属装备商人0330330215Market_装备商店10。该行代码含义为，在0号主城地图330330坐标，生成外观15的专属装备商人NPC，绑定Market_装备商店脚本，开启商店售卖功能，预留参数默认归零。
4.2创建对应商店交易脚本
进入Envir\Market_Def目录，新建文本文档，将文件名严格修改为配置中对应的Market_装备商店，保证文件名完全一致，大小写统一。打开脚本文件，编写标准商店开启指令与装备售卖列表，脚本语法遵循传奇引擎通用商店格式。
脚本首行固定为[@main]，作为NPC对话触发入口，第二行编写游戏内弹窗提示文字，第三行使用shop指令开启商店界面，后续逐行添加售卖装备参数。每条售卖指令对应一件装备，格式为shopitem+空格+ItemID+空格+售卖金币价格，精准匹配数据库ItemID，价格根据版本玩法自定义设置。
可批量添加多件装备，包含祖玛套装、赤月套装、雷霆高阶装备、专属神器等，逐行排列无数量上限。脚本末尾添加返回对话指令，完善交互逻辑，保存文件并关闭编辑器。
4.3服务端重载配置生效
无需重启整套服务端，直接打开传奇引擎主控制台，找到脚本重载、NPC重载功能，依次执行重载NPC配置、重载商店脚本两条指令。引擎会自动读取新增MerChant配置与商店脚本，加载完成后控制台提示读取成功、NPC注册完成。
进入游戏对应地图坐标，即可看到新增装备售卖NPC，点击NPC正常弹出商店界面，展示所有预设装备，支持正常购买、扣除对应货币、物品自动进入背包，整套基础功能搭建完成。
五、高级配置：差异化装备商店规则设置
5.1限购次数配置
在商店脚本内添加限购指令，可设置单件装备每日购买次数、账号限购次数，避免高频批量获取高阶装备。通过玩家个人变量记录购买次数，每日零点自动清零，实现循环限购规则，适配高阶稀有装备售卖场景。
5.2准入条件配置
可在脚本头部添加等级判定、转生判定、职业判定指令，设置商店准入门槛。未满足条件的玩家点击NPC仅弹出提示文字，无法打开商店界面，实现等级专属、转生专属、职业专属的差异化装备商店，丰富版本玩法层级。
5.3多货币售卖配置
原版默认仅支持金币售卖，可通过脚本修改扣费指令，替换为元宝、积分、声望、行会贡献等多类货币扣费方式，同时支持多种货币混合扣费，打造积分兑换商店、元宝高阶装备商店等特色功能。
六、新增NPC常见报错问题与精准解决方法
NPC完全不刷新：大概率为MerChant.txt格式错误、地图编号错误、坐标超出地图范围、文件编码异常。核对字段顺序无错乱，坐标替换为游戏内实测可用坐标，文件重新保存为ANSI编码，重载配置即可恢复。
NPC刷新成功点击无反应：脚本文件名与MerChant配置不匹配、脚本文件缺失、脚本首行指令错误。核对Market_Def目录脚本文件名完全对应，重新编写[@main]入口指令，修复残缺脚本代码。
商店打开空白、无装备显示：装备ItemID填写错误、数据库无对应装备数据、售卖指令格式错误。对照StdItems.DB重新核对ID，修正脚本shopitem指令格式，删除无效错误参数。
点击购买无响应、不扣货币不掉物品：装备存在交易锁定属性、脚本扣费指令缺失、背包空间不足判定失效。解除装备交易锁定参数，补全脚本扣费与物品发放逻辑，添加背包空格检测代码。
七、MerChant.txt长期维护与批量优化规范
所有自定义商店NPC统一在文件末尾新增配置行，不改动原版系统NPC参数，避免原生商店功能失效。新增脚本文件统一规范命名，按照功能分类命名，方便后期批量修改、删减、维护。每次修改配置后优先使用引擎重载功能测试，无需频繁重启服务端，提升搭建与修改效率。
批量添加多件装备时，统一排序规则，按照装备等级、品类、稀有度依次排列，保证商店界面整洁有序。高阶装备单独设置专属商店，与基础道具商店拆分，避免功能混杂、界面杂乱，让版本交易体系更加规整清晰。