传奇单机模拟真实充值流程全解析，从NPC脚本改造到系统提示精准触发

用户需在自架传奇单机中实现 **非GM命令的元宝充值流程**，要求玩家通过充值NPC领取元宝时，触发 **“XXX通过短信充值，成功领取XXXX元宝”** 的系统提示。该需求涉及 **支付平台对接、脚本逻辑改造、数据写入** 三大模块，需通过以下技术路径实现：
1. **构建虚拟支付接口**：伪造短信充值请求并生成交易记录
2. **改造NPC脚本**：实现元宝发放与系统公告联动
3. **数据持久化**：将充值记录写入服务端文件供后续查询

---

### **一、支付平台与虚拟接口搭建**
#### **1. 本地支付平台部署（无需联网）**
- **核心文件准备**：
```
/MirServer/支付接口
├─ PayClient.exe # 模拟支付平台客户端
├─ PayList.txt # 充值名单数据库
└─ PayLogs/ # 交易记录存放目录
```

- **配置文件修改**：
修改 `PayClient.ini` 中的端口设置（默认7100），与服务端 `DBServer` 端口一致：
```ini
[System]
Port=7100
FakePay=1 # 开启虚拟充值模式
```

- **启动虚拟支付**：
双击运行 `PayClient.exe`，右下角出现托盘图标即表示启动成功。

#### **2. 充值名单写入逻辑**
- **实时名单更新**：
在 `PayList.txt` 中按格式添加玩家账号与充值金额，系统每60秒自动读取：
```
2025-03-09 12:00:00 | 玩家账号A | 100 | 待领取
2025-03-09 12:01:00 | 玩家账号B | 500 | 已发放
```

- **状态码机制**：
- **待领取**：玩家未在NPC处执行领取操作
- **已发放**：元宝已通过脚本发放至账户

---

### **二、充值NPC脚本改造**
#### **1. NPC脚本路径与结构**
- **核心文件位置**：
```
/MirServer/Mir200/Envir/Market_Def/元宝使者-3.txt
```

- **脚本功能模块**：
```lua
[@Main]
# 主界面显示
{欢迎使用短信充值系统/COLOR=254}\
{当前可领取元宝：<$STR(G8)>/COLOR=249}\
{点击[领取元宝]完成操作/COLOR=253}\
<领取元宝/@领取> <离开/@exit>

[@领取]
# 触发充值验证
#IF
CHECKTEXTLIST ..\QuestDiary\支付记录\待领取.txt <$USERID> # 检查待领取名单
#ACT
GETVALIDSTR <$STR(G8)> "," <$STR(S0)> <$STR(S1)> # 解析充值金额
GAMEGOLD + <$STR(S1)> # 增加元宝
DELTEXTLIST ..\QuestDiary\支付记录\待领取.txt <$USERID> # 移除待领取记录
ADDTextList ..\QuestDiary\支付记录\已发放.txt <$USERID> # 写入已发放记录
SENDMSG 0 [系统公告] 玩家「<$USERNAME>」通过短信充值成功领取<$STR(S1)>元宝！ # 全服公告
#ELSEACT
MESSAGEBox 您暂无待领取的元宝！
```


#### **2. 动态变量与金额匹配**
- **G变量映射表**：

| 充值档位（元） | 对应G变量 | 元宝数值 |
|----------------|-----------|----------|
| 10 | G8 | 10,2000 |
| 30 | G9 | 30,6000 |
| 50 | G10 | 50,10000 |
- **实现原理**：
通过 `LOADVAR G8 ..\QuestDiary\充值配置\档位1.ini` 加载预设数值，避免硬编码


---

### **三、全流程模拟与提示触发**
#### **1. 虚拟充值操作步骤**
1. **生成待领取记录**：
手动编辑 `QuestDiary\支付记录\待领取.txt`，添加格式：
```
玩家账号A,2000
玩家账号B,10000
```

2. **NPC交互验证**：
玩家点击NPC时，脚本自动检索账号是否存在待领取记录
3. **元宝发放与日志生成**：
成功发放后，在 `MirServer\Logs\PayLogs\` 下生成带时间戳的日志文件

#### **2. 系统提示定制化**
- **公告颜色与频道控制**：
```lua
SENDMSG 0 {提示内容} 1 5 # 红色文字，滚动公告（频道5）
SENDMSG 0 {提示内容} 0 3 # 白色文字，顶部公告（频道3）
```

- **多语言支持**：
通过 `#CALL [..\QuestDiary\多语言\中文.txt] @Chinese` 实现公告内容动态切换

---

### **四、高阶调试与异常处理**
#### **1. 日志追踪与排错**
- **关键日志路径**：
```
/MirServer/Logs/
├─ PayError.log # 支付接口错误日志
├─ NPCExec.log # NPC脚本执行记录
└─ GameGOLD.log # 元宝变动流水
```

- **常见错误代码**：

| 错误码 | 含义 | 解决方案 |
|--------|-----------------------|-----------------------|
| E202 | 玩家账号不存在 | 检查DBServer是否正常 |
| E305 | 充值记录文件权限不足 | 右键文件夹赋予完全控制权限 |
| E410 | G变量未初始化 | 检查LOADVAR脚本段 |


#### **2. 压力测试方案**
1. **批量充值模拟**：
使用脚本工具生成1000条随机充值记录：
```powershell
1..1000 | % { Add-Content "待领取.txt" "TestUser$_,$((Get-Random -Min 100 -Max 5000))" }
```

2. **并发领取测试**：
启动多开工具模拟20个客户端同时点击NPC，观察M2Server的CPU占用与日志写入延迟

---

### **五、扩展功能开发建议**
1. **充值排行系统**：
```sql
-- 在MSSQL中创建视图
CREATE VIEW PayRank AS
SELECT TOP 10 UserID, SUM(Amount) AS Total
FROM PayLogs
GROUP BY UserID
ORDER BY Total DESC
```

2. **多货币支持**：
修改NPC脚本实现元宝/金币/灵符多选领取：
```lua
[@Main]
{请选择兑换货币类型：/COLOR=254}\
<元宝/@元宝> <金币/@金币> <灵符/@灵符>
```


---

### **总结**
通过搭建本地虚拟支付接口、深度改造NPC脚本逻辑、结合动态变量与文件操作，可实现无需GM命令的元宝充值流程。重点在于支付记录文件与脚本的实时交互，以及系统公告的精准触发。建议在正式部署前进行多账号压力测试，确保高并发场景下的稳定性。