传奇单机服务端添加元宝充值记录详细教程（新手可直接套用）

传奇单机服务端添加元宝充值记录，核心是通过配置服务端脚本文件、创建充值记录存储文本、绑定NPC触发领取，实现充值记录的添加、读取和验证，无需复杂编程，全程依托服务端原有文件路径操作，适配所有常见单机传奇版本（GOM、GEE、HERO等引擎通用），以下分步骤详细拆解，每一步均贴合实际操作，无多余修饰，新手可按流程直接操作。
一、添加元宝充值记录核心前提（必看）
添加元宝充值记录前，需确认2个核心前提，避免操作失误导致记录添加失败或无法读取：
1. 服务端状态：所有操作需在服务端关闭状态下进行，修改完成后重启服务端，充值记录相关配置才能生效，未关闭服务端修改文件，会导致文件损坏或配置不生效。
2. 文件路径确认：找到传奇单机服务端核心目录MirServer，重点记住3个关键文件夹路径，后续所有操作均围绕这3个路径展开：
（1）脚本文件夹：MirServer→Mir200→Envir→QuestDiary（用于存放充值记录文本和相关脚本）；
（2）NPC配置文件夹：MirServer→Mir200→Envir→Market_Def（用于编写充值记录领取NPC脚本）；
（3）NPC显示配置文件：MirServer→Mir200→Envir→Merchant.txt（用于配置充值NPC的显示参数）。
补充：部分单机版本会将充值相关脚本放在QuestDiary下的子文件夹（如“充值元宝”“充值记录”），若找不到对应文件，可在QuestDiary文件夹内搜索“充值”关键词，快速定位相关文件。
二、第一步：创建元宝充值记录存储文本（核心步骤，记录核心载体）
元宝充值记录需通过文本文件存储，文本文件按充值金额分类，便于后续NPC脚本读取和验证，具体操作如下：
1. 打开脚本文件夹：进入MirServer→Mir200→Envir→QuestDiary，在该文件夹内新建文件夹，命名为“元宝充值记录”（自定义，便于识别，不可含特殊符号）。
2. 创建不同金额的充值记录文本：在“元宝充值记录”文件夹内，新建多个文本文档，按充值金额命名（如10.txt、50.txt、100.txt、1000.txt），文件名即对应充值金额（10.txt对应10元宝充值记录，以此类推），无需修改文件后缀，保持.txt格式即可。
3. 配置充值记录文本内容：打开任意一个充值记录文本（如10.txt），输入游戏账号（单机账号，即登录游戏时使用的账号），单个账号占一行，多个账号可分多行填写，填写完成后保存关闭；例如，在10.txt中输入“admin”，代表账号admin有10元宝的充值记录，后续可通过NPC领取对应元宝。
注意：文本内仅填写游戏账号，不可添加任何多余字符、空格或注释，否则会导致脚本无法读取记录；若需添加多个账号的同金额充值记录，只需在文本内换行填写多个账号即可，无需重复创建文本文件。
三、第二步：编写充值记录领取NPC脚本（实现记录读取与元宝发放）
充值记录需通过NPC触发读取，需编写NPC脚本，实现“检测账号是否有充值记录→读取记录金额→发放对应元宝→删除已领取记录”的逻辑，具体步骤如下：
1. 新建NPC脚本文件：进入MirServer→Mir200→Envir→Market_Def文件夹，新建文本文档，重命名为“元宝充值使者.txt”（NPC名称，自定义，需与后续配置的NPC名称一致），打开该文件，编写脚本，脚本核心逻辑固定，可直接套用，示例如下（适配所有通用引擎）：
(@main)
#SAY
欢迎使用元宝充值记录领取服务！
请选择你要领取的充值金额：
1. 10元宝/@领取10元宝
2. 50元宝/@领取50元宝
3. 100元宝/@领取100元宝
4. 1000元宝/@领取1000元宝
(@领取10元宝)
#IF
CheckAccountList ..\QuestDiary\元宝充值记录\10.txt ;检测当前账号是否在10元宝充值记录文本中
#ACT
GameGold + 10 ;发放10元宝（与文本金额对应）
DelAccountList ..\QuestDiary\元宝充值记录\10.txt ;删除文本中当前账号的记录，避免重复领取
SENDMSG 5 领取成功！已为你发放10元宝，请查收！
#ELSEACT
SENDMSG 5 领取失败！未查询到你的10元宝充值记录！
(@领取50元宝)
#IF
CheckAccountList ..\QuestDiary\元宝充值记录\50.txt
#ACT
GameGold + 50
DelAccountList ..\QuestDiary\元宝充值记录\50.txt
SENDMSG 5 领取成功！已为你发放50元宝，请查收！
#ELSEACT
SENDMSG 5 领取失败！未查询到你的50元宝充值记录！
(@领取100元宝)
#IF
CheckAccountList ..\QuestDiary\元宝充值记录\100.txt
#ACT
GameGold + 100
DelAccountList ..\QuestDiary\元宝充值记录\100.txt
SENDMSG 5 领取成功！已为你发放100元宝，请查收！
#ELSEACT
SENDMSG 5 领取失败！未查询到你的100元宝充值记录！
(@领取1000元宝)
#IF
CheckAccountList ..\QuestDiary\元宝充值记录\1000.txt
#ACT
GameGold + 1000
DelAccountList ..\QuestDiary\元宝充值记录\1000.txt
SENDMSG 5 领取成功！已为你发放1000元宝，请查收！
#ELSEACT
SENDMSG 5 领取失败！未查询到你的1000元宝充值记录！
2. 脚本修改说明：可根据自身需求，新增或修改充值金额，只需复制对应金额的脚本段落，修改“领取金额”“文本路径”“元宝数量”即可；例如，新增200元宝领取选项，只需新建200.txt充值记录文本，再在脚本中添加对应领取段落，修改相关参数即可。
3. 脚本防重复领取设置：脚本中“DelAccountList”指令的作用是删除已领取记录，避免同一账号重复领取，若无需删除记录（如测试场景），可删除该指令，但建议保留，贴合正常充值逻辑。
四、第三步：配置充值NPC显示（让NPC在游戏内可见）
编写完NPC脚本后，需在Merchant.txt文件中配置NPC显示参数，让NPC在游戏内指定地图显示，具体操作如下：
1. 打开NPC显示配置文件：进入MirServer→Mir200→Envir文件夹，找到Merchant.txt文件，用记事本打开，无需修改原有内容，直接在文件末尾新增NPC配置。
2. 新增NPC配置参数：配置格式为“地图编号 横坐标 纵坐标 NPC名称 外观代码 固定参数”，示例：3 330 330 元宝充值使者 8 1 0 0 0 1 2000 0，参数说明如下：
地图编号：填写游戏内可进入的地图编号（如3为主城，0为新手村，可在MapInfo.txt文件中查询）；
横坐标、纵坐标：NPC在对应地图的显示位置，建议设置在安全区（如主城330 330坐标），避免被怪物攻击；
NPC名称：需与Market_Def文件夹下的脚本文件名完全一致（如“元宝充值使者”），不可有任何差异；
外观代码：填写1-200之间的数值，对应不同NPC外观（如8为普通使者外观，可自行调整）；
后面的0为固定参数，无需修改，确保NPC正常显示和交互。
3. 保存文件：配置完成后，点击“文件→保存”，关闭记事本，NPC显示配置完成。
五、第四步：添加充值记录并测试（确保功能正常生效）
所有配置完成后，需添加测试充值记录，验证充值记录添加、读取、领取功能是否正常，具体步骤如下：
1. 添加测试充值记录：打开QuestDiary→元宝充值记录文件夹，选择任意一个充值金额文本（如10.txt），输入自己的单机游戏账号（如admin），保存关闭。
2. 重启服务端：关闭传奇单机服务端所有程序（包括M2Server、DBServer等），重新启动服务端，等待服务端完全启动（所有程序显示正常运行）。
3. 游戏内测试：登录单机游戏账号，前往配置的NPC所在地图（如主城，可通过GM命令@MapMove 3 330 330快速传送），找到“元宝充值使者”NPC，点击NPC，选择对应金额的领取选项（如领取10元宝）。
4. 验证结果：若提示“领取成功！已为你发放10元宝”，且游戏内元宝数量增加10，同时打开10.txt文本，发现账号已被删除，说明充值记录添加和领取功能正常；若提示“领取失败”，需按后续异常排查步骤处理。
六、常见异常排查（贴合单机实操，快速解决问题）
1. 游戏内找不到元宝充值使者NPC：核对Merchant.txt文件中NPC名称是否与脚本文件名一致，地图编号、坐标是否正确，外观代码是否在1-200之间；若仍无法找到，重启服务端后再次测试。
2. 点击NPC无反应：检查Market_Def文件夹下的脚本文件名是否与NPC名称完全一致（包括汉字、空格），脚本中的指令是否全部大写（传奇脚本指令区分大小写，如#IF、#ACT、GameGold不可小写），脚本语句是否完整（如#IF对应#ACT或#ELSEACT）。
3. 提示“未查询到充值记录”：检查充值记录文本（如10.txt）中是否填写了当前登录的游戏账号，文本内是否有多余空格、符号；核对脚本中“CheckAccountList”后的文本路径是否正确，确保路径与充值记录文本的实际路径一致（如文件夹名称是否为“元宝充值记录”）。
4. 领取元宝后记录未删除：检查脚本中是否有“DelAccountList”指令，指令后的文本路径是否正确；若指令缺失，添加该指令后保存脚本，重启服务端再次测试。
5. 发放元宝数量与记录金额不符：核对脚本中“GameGold + 数值”的数值，是否与充值记录文本的金额一致（如10.txt对应GameGold + 10），修改后保存脚本，重启服务端即可。
6. 服务端重启后配置失效：检查所有修改的文件是否保存成功，充值记录文本、NPC脚本是否放在对应文件夹下；部分单机版本需将充值记录文件夹放在QuestDiary→Pay或QuestDiary→充值元宝子文件夹下，可尝试调整文件夹路径后测试。
七、进阶操作（根据需求灵活调整）
1. 新增更多充值金额：重复第二步和第三步，新建对应金额的充值记录文本（如20.txt、200.txt），在NPC脚本中添加对应领取段落，修改参数即可，无需重新配置NPC显示。
2. 添加充值记录查询功能：在NPC脚本中新增“查询充值记录”选项，脚本示例如下，可直接添加到@main段落下方：
5. 查询充值记录/@查询记录
(@查询记录)
#SAY
正在查询你的充值记录，请稍候...

#IF
CheckAccountList ..\QuestDiary\元宝充值记录\10.txt
#SAY
你有10元宝未领取充值记录！
点击领取/@领取10元宝
#ELSEIF
CheckAccountList ..\QuestDiary\元宝充值记录\50.txt
#SAY
你有50元宝未领取充值记录！
点击领取/@领取50元宝
#ELSEIF
CheckAccountList ..\QuestDiary\元宝充值记录\100.txt
#SAY
你有100元宝未领取充值记录！
点击领取/@领取100元宝
#ELSEIF
CheckAccountList ..\QuestDiary\元宝充值记录\1000.txt
#SAY
你有1000元宝未领取充值记录！
点击领取/@领取1000元宝
#ELSEACT
SENDMSG 5 未查询到任何未领取的充值记录！
3. 批量添加充值记录：若需为多个账号添加相同金额的充值记录，只需在对应金额的文本文件中，换行填写多个游戏账号，保存后即可，无需逐个添加。
4. 调整元宝发放指令：不同引擎的元宝发放指令略有差异，若GameGold指令无效，可替换为对应引擎指令（GOM引擎可用ChangeGold，GEE引擎可用AddGold），替换后保存脚本，重启服务端测试。
八、补充说明
传奇单机服务端添加元宝充值记录，核心是“创建记录文本→编写NPC脚本→配置NPC显示→测试验证”，全程无需修改服务端核心程序，所有操作均基于原有文件路径，新手可快速上手。操作过程中，需重点核对文件路径、NPC名称、脚本指令，避免因细节错误导致功能失效。
修改文件前，建议备份对应文件夹（如QuestDiary、Market_Def），若修改错误，可直接替换备份文件，避免服务端无法启动。不同单机版本的文件路径可能略有差异，但核心逻辑一致，若找不到对应文件夹，可通过搜索关键词（如“充值”“QuestDiary”）快速定位，灵活调整操作步骤即可。