一、调试充值NPC前期准备 工具与文件定位
核心工具：文本编辑器（推荐Notepad++，支持ANSI编码）、对应引擎脚本编辑器（GOM用LegendEditor、996用自带脚本工具）、服务端文件管理器。无需额外复杂工具，确保文本编辑器编码格式可切换为ANSI，避免脚本乱码。
关键文件路径：服务端根目录\Mir200\Envir文件夹为核心目录，其中MerChant.txt（交易类NPC配置）、Npcs.txt（管理类NPC配置）用于设置NPC位置与形象；market_def文件夹存放NPC功能脚本，QuestDiary文件夹用于复杂充值逻辑关联脚本。
前置要求：确保服务端已正常启动，数据库连接稳定。调试前备份Envir文件夹下所有文件，防止配置错误导致服务端异常。Win11系统需右键文本编辑器，勾选“以管理员身份运行”，避免文件修改后无法保存。
二、充值NPC基础添加 位置与形象配置
1. 新增NPC至指定地图
打开Mir200\Envir\MerChant.txt（优先选择此文件，适配交易类充值功能），按固定格式添加NPC信息，格式为：NPC功能文件路径 地图代码 X轴坐标 Y轴坐标 NPC名称 方向标识 形象代码 城堡属性 自动移动 移动间隔。
示例：盟重省_充值使者 3 664 707 充值使者 0 500 0 0 2。其中“3”为盟重省地图代码，“664 707”为坐标，“500”为NPC形象代码，“0”代表不自动移动。添加后保存文件，确保无空格冗余、格式正确。
2. 匹配NPC功能脚本文件
在Mir200\Envir\market_def文件夹下，按“NPC路径-地图代码.txt”格式新建脚本文件，示例对应上文NPC的文件名为“盟重省_充值使者-3.txt”。若需将NPC放在庄园地图，地图代码为6，文件名则为“庄园_充值使者-6.txt”，确保文件名与MerChant.txt中路径完全对应。
若添加管理类充值NPC，需在Npcs.txt中配置，格式与MerChant.txt一致，功能脚本仍放在market_def文件夹，命名规则不变。配置后关闭服务端，重启所有组件使NPC生效，或在游戏中用GM命令@reloadnpc all重载NPC，无需重启服务端。
三、充值NPC核心脚本编写 实现基础功能
1. 脚本基础语法与逻辑框架
充值NPC脚本核心由#SAY（对话显示）、#IF（条件判断）、#ACT（执行命令）组成，支持充值点兑换、元宝抵扣、物品发放等功能。变量优先使用充值点变量UE、元宝变量GAMEGIRD，引擎通用变量无需额外定义，直接调用即可。
基础框架示例：@Main为脚本入口，#SAY显示NPC对话内容，标注充值档位与奖励；#IF判断玩家充值点或元宝数量；#ACT执行发放物品、扣除道具、设置领取标识等操作，#ElseAct显示条件不满足提示。
2. 常用充值功能脚本示例
充值点兑换物品：
#SAY\n 欢迎使用充值服务！\n 1. 充值50点领取屠龙刀/@GetTuLong\n 2. 充值30点领取麻痹戒指/@GetMaBi\n\n(@GetTuLong)\n#IF\n CHECKVAR UE >= 50\n#ACT\n GIVE 屠龙刀 1\n SUBVAR UE 50\n MESSAGEBOX 领取成功！\n#ElseAct\n MESSAGEBOX 充值点不足50，无法领取！\n
元宝抵扣兑换：
(@GetMaBi)\n#IF\n CHECKGAMEGIRD >= 10000\n#ACT\n TAKEGAMEGIRD 10000\n GIVE 麻痹戒指 1\n MESSAGEBOX 元宝兑换成功！\n#ElseAct\n MESSAGEBOX 元宝不足10000，无法兑换！\n
3. 限量领取与重复领取控制
添加领取次数限制，需用到个人标识变量，示例：
(@GetXianLiang)\n#IF\n large G124 0\n CHECK (101) 0\n CHECKVAR UE >= 66\n#ACT\n Dec G124 1\n Set (101) 1\n GIVE 白银斗笠 1\n CONFERTITLE 爱心大使\n GuildNoticeMsg 255 241 〖充值福利〗恭喜(%s)领取限量礼包！\n#ElseAct\n MESSAGEBOX 礼包已售完或您已领取过！\n
其中G124为礼包剩余数量变量，(101)为个人领取标识，Set (101) 1后玩家无法重复领取，Dec G124 1减少剩余数量。
四、不同引擎充值NPC适配调试 规避常见问题
1. GOM引擎专属配置
GOM引擎需确保脚本文件编码为ANSI，打开文本编辑器，选择“格式>转为ANSI编码”保存。充值点变量需在M2引擎中启用，进入「参数设置>变量设置」，勾选“启用UE充值点变量”，无需重启引擎即可生效。
复杂脚本需调用外部函数时，在QuestDiary文件夹新建关联脚本，用#CALL命令调用，示例：#CALL [\QuestDiary\充值奖励.txt] @Reward，确保路径分隔符为\，避免格式错误。
2. GEE/996引擎适配要点
GEE引擎充值变量替换为USEREP、GAMEGOLD，脚本逻辑不变，仅变量名称调整。996引擎无需额外启用变量，直接编写脚本即可，但需在服务端「脚本设置」中勾选“允许充值NPC脚本执行”。
所有引擎调试时，若NPC无对话，检查脚本文件名与MerChant.txt中路径是否一致，坐标是否在地图合理区域，避免NPC被地形遮挡无法交互。
五、充值NPC功能测试与问题排查
1. 功能测试步骤
启动服务端与客户端，登录游戏后前往NPC配置坐标，点击NPC查看对话是否正常显示。用GM命令@AddVar UE 100添加充值点，@AddGameGIRD 20000添加元宝，测试各档位领取、抵扣功能是否生效。
测试限量功能时，多次点击领取按钮，确认领取一次后无法重复领取，剩余数量变量同步减少。关闭服务端重启，检查领取标识与剩余数量是否保留，确保数据正常存储。
2. 常见故障及解决办法
脚本无响应：检查脚本编码是否为ANSI，非ANSI编码会导致引擎无法读取，重新保存为ANSI格式即可。变量无效时，确认对应引擎变量名称正确，GOM用UE，GEE用USEREP，避免变量混用。
物品发放失败：检查物品名称与服务端物品数据库一致，避免错别字或物品ID错误。领取后无提示，补充MESSAGEBOX命令，确保脚本逻辑完整，无遗漏#END或Break语句。
NPC不显示：核对MerChant.txt中地图代码、坐标是否正确，形象代码是否在引擎支持范围内，错误代码会导致NPC无法加载。重载NPC后仍不显示，重启服务端即可解决。
六、充值NPC进阶调整 优化交互体验
对话美化：在#SAY语句中添加颜色代码，示例<充值福利/SCOLOR=150>，SCOLOR=150为红色，SCOLOR=70为绿色，提升对话辨识度。按功能分类显示，用换行符\n分隔不同充值档位，避免内容杂乱。
多条件判断：添加充值叠加逻辑，示例“充值满50点且无领取记录可额外获赠会员”，通过嵌套#IF语句实现，增强功能灵活性。新增充值后自动发放提示，用SENDMSG命令推送系统消息，提醒玩家领取奖励。
定期维护：调试完成后备份脚本文件，后续调整充值档位或奖励时，直接修改脚本内容，重载NPC即可生效。定期检查脚本日志，排查异常领取记录，确保功能稳定运行。
