一、传奇充值NPC基础原理与文件路径说明
自行架设的传奇版本中，充值NPC是游戏货币兑换、礼包领取、赞助开通的核心功能载体，多数改版版本、复古版本、微端版本均自带充值NPC脚本，部分纯净版本需要手动添加部署。充值NPC的显示位置、对话界面、充值比例、赠送奖励、领取规则，全部由服务端本地配置文件与脚本控制，无需对接外部程序，单机环境下可完全自定义修改。
充值NPC的核心配置文件集中存放于服务端固定目录，核心路径为D:\Mirserver\Mir200\Envir。其中MerChant.txt为NPC位置注册文件，负责控制NPC在游戏地图的坐标、外观、是否显示；Market_def文件夹存放NPC对话脚本与功能执行脚本；QuestDiary文件夹存放充值档位、奖励明细、领取判定规则文件。所有充值NPC的新增、修改、删除、功能调试，均围绕以上三类文件操作。
二、已有充值NPC参数自定义修改方法
多数架设完成的传奇版本已经自带RMB充值、元宝兑换、赞助充值类NPC，无需重新添加，直接修改脚本参数即可调整充值规则，适配个人游玩需求。
2.1定位充值NPC对应脚本文件
首先进入游戏，查看已有充值NPC的名称，常见名称包含充值使者、RMB兑换、元宝赞助、福利充值等。记录准确NPC名称后，打开D:\Mirserver\Mir200\Envir\MerChant.txt文件，使用检索功能搜索NPC名称，即可找到该NPC的注册代码，代码末尾会标注对应的脚本文件夹名称。
根据标注的文件夹名称，进入Market_def目录找到对应脚本文本，该文件为NPC前台对话界面脚本，可修改NPC显示文字、充值档位介绍、按钮提示文本。进入QuestDiary对应充值目录，可找到后台执行脚本，控制实际充值到账数量、附赠道具、等级奖励等核心数据。
2.2修改充值比例与货币到账数量
打开充值档位脚本文件，文件内会标注各类充值金额对应的元宝、灵符、金币数量。脚本内存在固定数值代码，对应不同档位的基础货币发放数量，可直接修改数字调整比例。
常规修改逻辑为更改基础数值倍率，例如原有1元兑换100元宝，可直接将数值修改为500、1000，实现高倍率兑换。同时可修改档位区间，删除低档位、新增高档位，自定义设置10元、50元、100元等不同充值档位的对应福利。修改过程中保持脚本代码格式不变，仅替换数值内容，避免代码错乱导致NPC功能失效。
2.3自定义充值附赠奖励设置
传奇充值NPC自带附赠奖励逻辑，可通过脚本修改新增额外福利，包含专属装备、高阶材料、游戏积分、转生凭证、限时称号等道具。打开对应档位的执行脚本，在货币发放代码下方，添加自定义物品发放代码，填写物品标准数据库名称、发放数量。
可单独设置档位专属奖励，低档位仅发放基础元宝，高档位叠加稀有道具、专属地图进入权限、技能书等奖励。同时可修改奖励领取限制，取消每日领取次数限制、去除账号领取上限，适配单机自由游玩模式。
2.4修改NPC对话界面与文字内容
打开Market_def目录下的NPC对话脚本，可全面修改NPC界面显示内容。可替换顶部标题、档位介绍文字、温馨提示、按钮名称，删除原版冗余文字、广告提示内容，自定义编辑简洁的充值说明文本。
同时可调整界面排版，新增分割线条、备注说明，标注专属福利规则，让NPC界面适配个人版本风格，修改后保存文件，游戏内重载NPC即可实时预览效果。
三、纯净版本手动添加充值NPC完整步骤
纯净无插件版本无自带充值NPC，需要手动注册NPC、写入脚本、配置功能，全程仅需修改本地配置文件，操作简单适配所有GOM、LEG主流引擎。
3.1MerChant.txt注册NPC坐标
打开D:\Mirserver\Mir200\Envir\MerChant.txt文件，在文件空白行添加NPC注册代码，固定格式为【NPC名称地图编号X坐标Y坐标外观代码脚本文件夹】。主城地图编号为0，可自定义主城任意空白坐标，避免与原有NPC重叠，外观代码可选用常规商人、使者外观编号。
输入完成后保存文件，确保无格式错误、无多余空格，否则会导致NPC无法在游戏内显示。注册完成后，记录填写的脚本文件夹名称，后续用于匹配功能脚本。
3.2新建NPC功能脚本文件夹
进入Market_def目录，新建与注册代码对应名称的文件夹，在文件夹内新建同名txt脚本文件。将通用充值NPC标准脚本复制粘贴至文件内，基础包含对话界面、档位选择、奖励判定、到账执行全套逻辑。
根据自身版本需求，修改脚本内的货币数值、奖励道具、界面文字，适配当前游戏版本的道具体系与货币体系，避免出现道具不存在、代码不识别的问题。
3.3配置后台充值执行脚本
在QuestDiary目录新建充值专属文件夹，新建档位执行脚本，分别对应不同充值档位的发放逻辑，明确元宝发放、道具赠送、积分累加等执行代码。添加领取判定代码，支持点击按钮一键领取，无多余验证流程，适配单机使用场景。
脚本编写完成后，保存所有文件，保证前台对话脚本与后台执行脚本路径关联一致，无路径错乱、文件缺失问题。
四、GM单机专属充值领取权限设置
自行架设传奇可设置免付费一键充值功能，无需真实支付，通过NPC直接领仍应档位奖励，是单机GM常用设置方法。
打开充值执行脚本，删除脚本内的支付验证、订单校验、外网对接代码，保留纯奖励发放逻辑。添加GM权限判定，仅最高权限账号可点击领取，普通玩家无操作权限，避免功能滥用。
同时可设置无限领取模式，去除账号领取记录缓存代码，GM账号可重复点击领取各类充值档位奖励，快速获取游戏货币与稀有道具，无需反复修改脚本数值。
五、NPC修改后重载与功能生效方法
所有脚本修改、新增操作完成后，无需重启整套服务端，可通过引擎快捷指令快速生效。打开M2引擎控制台，输入NPC重载指令【@reloadnpcall】，回车执行后，所有NPC配置、对话脚本、功能逻辑会即时更新。
游戏内角色小退重登，找到充值NPC，即可查看修改后的界面、档位与奖励内容。针对部分参数未生效的情况，可关闭M2引擎重新启动，加载全新配置文件，保证所有修改完整落地。
六、充值NPC常见异常问题排查
游戏内不显示充值NPC，多为MerChant.txt注册代码格式错误、坐标超出地图范围、脚本文件夹名称不匹配导致，核对代码格式、坐标数值、文件夹名称一致性即可解决。
NPC可以打开界面但点击无反应，属于前台脚本与后台执行脚本未关联、缺失档位判定代码，重新核对脚本路径，补全缺失的执行代码，删除无效冗余脚本即可恢复正常功能。
点击领取无奖励到账，多为道具名称输入错误、货币数值代码错乱、权限判定拦截导致，核对数据库道具标准名称，重置脚本数值参数，关闭多余权限验证逻辑即可修复。
NPC界面文字错乱、排版异常，是脚本内符号格式错误、换行代码缺失导致，统一脚本格式，删除多余特殊符号，重新保存文件重载即可恢复正常排版。
自行架设的传奇版本中，充值NPC是游戏货币兑换、礼包领取、赞助开通的核心功能载体，多数改版版本、复古版本、微端版本均自带充值NPC脚本，部分纯净版本需要手动添加部署。充值NPC的显示位置、对话界面、充值比例、赠送奖励、领取规则，全部由服务端本地配置文件与脚本控制，无需对接外部程序，单机环境下可完全自定义修改。
充值NPC的核心配置文件集中存放于服务端固定目录，核心路径为D:\Mirserver\Mir200\Envir。其中MerChant.txt为NPC位置注册文件，负责控制NPC在游戏地图的坐标、外观、是否显示；Market_def文件夹存放NPC对话脚本与功能执行脚本；QuestDiary文件夹存放充值档位、奖励明细、领取判定规则文件。所有充值NPC的新增、修改、删除、功能调试，均围绕以上三类文件操作。
二、已有充值NPC参数自定义修改方法
多数架设完成的传奇版本已经自带RMB充值、元宝兑换、赞助充值类NPC，无需重新添加，直接修改脚本参数即可调整充值规则，适配个人游玩需求。
2.1定位充值NPC对应脚本文件
首先进入游戏，查看已有充值NPC的名称，常见名称包含充值使者、RMB兑换、元宝赞助、福利充值等。记录准确NPC名称后，打开D:\Mirserver\Mir200\Envir\MerChant.txt文件，使用检索功能搜索NPC名称，即可找到该NPC的注册代码，代码末尾会标注对应的脚本文件夹名称。
根据标注的文件夹名称，进入Market_def目录找到对应脚本文本，该文件为NPC前台对话界面脚本，可修改NPC显示文字、充值档位介绍、按钮提示文本。进入QuestDiary对应充值目录，可找到后台执行脚本，控制实际充值到账数量、附赠道具、等级奖励等核心数据。
2.2修改充值比例与货币到账数量
打开充值档位脚本文件，文件内会标注各类充值金额对应的元宝、灵符、金币数量。脚本内存在固定数值代码，对应不同档位的基础货币发放数量，可直接修改数字调整比例。
常规修改逻辑为更改基础数值倍率，例如原有1元兑换100元宝，可直接将数值修改为500、1000，实现高倍率兑换。同时可修改档位区间，删除低档位、新增高档位，自定义设置10元、50元、100元等不同充值档位的对应福利。修改过程中保持脚本代码格式不变，仅替换数值内容，避免代码错乱导致NPC功能失效。
2.3自定义充值附赠奖励设置
传奇充值NPC自带附赠奖励逻辑，可通过脚本修改新增额外福利，包含专属装备、高阶材料、游戏积分、转生凭证、限时称号等道具。打开对应档位的执行脚本，在货币发放代码下方，添加自定义物品发放代码，填写物品标准数据库名称、发放数量。
可单独设置档位专属奖励，低档位仅发放基础元宝，高档位叠加稀有道具、专属地图进入权限、技能书等奖励。同时可修改奖励领取限制，取消每日领取次数限制、去除账号领取上限，适配单机自由游玩模式。
2.4修改NPC对话界面与文字内容
打开Market_def目录下的NPC对话脚本，可全面修改NPC界面显示内容。可替换顶部标题、档位介绍文字、温馨提示、按钮名称，删除原版冗余文字、广告提示内容，自定义编辑简洁的充值说明文本。
同时可调整界面排版，新增分割线条、备注说明，标注专属福利规则，让NPC界面适配个人版本风格，修改后保存文件，游戏内重载NPC即可实时预览效果。
三、纯净版本手动添加充值NPC完整步骤
纯净无插件版本无自带充值NPC，需要手动注册NPC、写入脚本、配置功能，全程仅需修改本地配置文件，操作简单适配所有GOM、LEG主流引擎。
3.1MerChant.txt注册NPC坐标
打开D:\Mirserver\Mir200\Envir\MerChant.txt文件，在文件空白行添加NPC注册代码，固定格式为【NPC名称地图编号X坐标Y坐标外观代码脚本文件夹】。主城地图编号为0，可自定义主城任意空白坐标，避免与原有NPC重叠，外观代码可选用常规商人、使者外观编号。
输入完成后保存文件，确保无格式错误、无多余空格，否则会导致NPC无法在游戏内显示。注册完成后，记录填写的脚本文件夹名称，后续用于匹配功能脚本。
3.2新建NPC功能脚本文件夹
进入Market_def目录，新建与注册代码对应名称的文件夹，在文件夹内新建同名txt脚本文件。将通用充值NPC标准脚本复制粘贴至文件内，基础包含对话界面、档位选择、奖励判定、到账执行全套逻辑。
根据自身版本需求，修改脚本内的货币数值、奖励道具、界面文字，适配当前游戏版本的道具体系与货币体系，避免出现道具不存在、代码不识别的问题。
3.3配置后台充值执行脚本
在QuestDiary目录新建充值专属文件夹，新建档位执行脚本，分别对应不同充值档位的发放逻辑，明确元宝发放、道具赠送、积分累加等执行代码。添加领取判定代码，支持点击按钮一键领取，无多余验证流程，适配单机使用场景。
脚本编写完成后，保存所有文件，保证前台对话脚本与后台执行脚本路径关联一致，无路径错乱、文件缺失问题。
四、GM单机专属充值领取权限设置
自行架设传奇可设置免付费一键充值功能，无需真实支付，通过NPC直接领仍应档位奖励，是单机GM常用设置方法。
打开充值执行脚本，删除脚本内的支付验证、订单校验、外网对接代码，保留纯奖励发放逻辑。添加GM权限判定，仅最高权限账号可点击领取，普通玩家无操作权限，避免功能滥用。
同时可设置无限领取模式，去除账号领取记录缓存代码，GM账号可重复点击领取各类充值档位奖励，快速获取游戏货币与稀有道具，无需反复修改脚本数值。
五、NPC修改后重载与功能生效方法
所有脚本修改、新增操作完成后，无需重启整套服务端，可通过引擎快捷指令快速生效。打开M2引擎控制台，输入NPC重载指令【@reloadnpcall】，回车执行后，所有NPC配置、对话脚本、功能逻辑会即时更新。
游戏内角色小退重登，找到充值NPC，即可查看修改后的界面、档位与奖励内容。针对部分参数未生效的情况，可关闭M2引擎重新启动，加载全新配置文件，保证所有修改完整落地。
六、充值NPC常见异常问题排查
游戏内不显示充值NPC，多为MerChant.txt注册代码格式错误、坐标超出地图范围、脚本文件夹名称不匹配导致，核对代码格式、坐标数值、文件夹名称一致性即可解决。
NPC可以打开界面但点击无反应，属于前台脚本与后台执行脚本未关联、缺失档位判定代码，重新核对脚本路径，补全缺失的执行代码，删除无效冗余脚本即可恢复正常功能。
点击领取无奖励到账，多为道具名称输入错误、货币数值代码错乱、权限判定拦截导致，核对数据库道具标准名称，重置脚本数值参数，关闭多余权限验证逻辑即可修复。
NPC界面文字错乱、排版异常，是脚本内符号格式错误、换行代码缺失导致，统一脚本格式，删除多余特殊符号，重新保存文件重载即可恢复正常排版。