传奇攻沙奖励脚本深度解析：从NPC配置到自动化发放的完整指南

#### 一、脚本设计核心逻辑与功能拆解
**攻沙奖励脚本需实现以下核心功能**：
1. **身份验证**：仅允许沙巴克城主及其行会成员领取奖励（通过 `ISCASTLEMASTER` 和 `CHECKGUILDLIST` 实现）。
2. **时间限制**：限定奖励领取时间段（如每日22:01-22:59），需结合 `HOUR` 和 `MIN` 命令判断。
3. **奖励分层**：区分首次攻沙奖励与每日攻沙奖励（通过全局变量如 `G322` 标记首次状态）。
4. **防重复领取**：使用个人标识或变量记录领取状态，避免玩家重复刷取奖励。
5. **数据持久化**：通过 `SAVEVAR` 或文本文件保存奖励进度，确保服务器重启后数据不丢失。

---

#### 二、NPC脚本配置全流程
##### **步骤1：创建NPC配置文件**
1. **路径设置**：
- 在服务端目录 `Mir200\Envir\MerChant.txt` 添加NPC信息，例如：
```
3 331 332 沙城奖励使者 0 12 0
```

含义：地图编号3，坐标(331,332)，NPC名称“沙城奖励使者”，外观代码12。

2. **脚本文件关联**：
- 在 `Market_Def` 目录下创建 `沙城奖励使者.txt`，编写交互逻辑。

##### **步骤2：基础脚本框架**
```lua
[@Main]
#IF
ISCASTLEMASTER
HOUR 22 22
MIN 01 59
CHECKVAR G322 = 0 ; 检测是否为首次攻沙
#ACT
GOTO @FirstReward
#ELSEACT
GOTO @DailyReward

[@FirstReward]
#IF
CHECKVAR G322 = 0
#ACT
GIVE 500000元宝 ; 首次奖励50万元宝
GIVE 逐风 1 ; 发放专属武器
SAVEVAR G322 1 ; 标记首次领取状态
SENDMSG 6 "首次攻沙奖励已发放！"
BREAK

[@DailyReward]
#IF
CHECKVAR G321 < 1 ; 检测当日是否已领取
#ACT
GIVE 200000元宝 ; 每日奖励20万元宝
SAVEVAR G321 1
SENDMSG 6 "今日攻沙奖励已发放！"
#ELSEACT
SENDMSG 6 "今日已领取奖励，请明日再来！"
```

**代码解析**：
- `ISCASTLEMASTER` 验证沙城主身份，`CHECKVAR` 管理奖励状态。
- `GIVE` 命令发放元宝与装备，`SAVEVAR` 保存变量防止重复。

---

#### 三、高级功能扩展与优化
##### **1. 行会成员奖励分发**
```lua
[@Main]
#IF
CHECKGUILDLIST ..\QuestDiary\沙巴克行会名单.txt ; 读取行会成员名单
#ACT
MOVR P10 10000 ; 随机发放元宝（1000-10000）
GIVE 元宝 <$STR(P10)>
SENDMSG 6 "行会成员<$USERNAME>获得随机奖励：<$STR(P10)>元宝！"
```

**说明**：
- 通过 `CHECKGUILDLIST` 读取行会名单文件，动态分配奖励。

##### **2. 时间容错与自动刷新**
```lua
#IF
NOT HOUR 22 22
OR NOT MIN 01 59
#ACT
SENDMSG 6 "当前时间不可领取奖励，请在22:01-22:59期间领取！"
DELAYGOTO 5000 @Main ; 5秒后重新检测
```

**作用**：防止玩家在非指定时间触发脚本。

##### **3. 多版本兼容性处理**
- **HeroM2引擎**：使用 `VAR` 声明变量类型（如 `VAR Integer G322`）。
- **GOM引擎**：需在 `QFunction-0.txt` 中定义奖励触发逻辑。

---

#### 四、脚本调试与常见问题处理
##### **1. 调试技巧**
- **日志输出**：通过 `SENDMSG 0` 向全服广播调试信息，定位逻辑错误。
- **变量检查**：使用 `CHECKVAR` 或 `PRINTVAR` 命令输出变量值。

##### **2. 常见问题**

| 问题现象 | 解决方案 |
|-------------------------|-----------------------------------|
| 奖励未发放 | 检查NPC脚本路径与文件名是否匹配 |
| 变量重置失败 | 使用 `CLEARVAR` 命令清除旧数据 |
| 时间检测不生效 | 确认服务器时区与脚本时间一致 |


---

#### 五、攻沙奖励脚本完整示例（支持首次+每日+行会奖励）
```lua
; Mir200\Envir\Market_Def\沙城奖励使者.txt
[@Main]
#IF
ISCASTLEMASTER
HOUR 22 22
MIN 01 59
#SAY
尊敬的沙城主，请选择奖励类型：\
<首次攻沙奖励/@First> <每日奖励/@Daily> <行会成员奖励/@Guild>\

[@First]
#IF
CHECKVAR G322 = 0
#ACT
GIVE 500000元宝
GIVE 逐风 1
SAVEVAR G322 1
SENDMSG 6 "首次攻沙奖励已发放！"
#ELSEACT
SENDMSG 6 "您已领取过首次奖励！"

[@Daily]
#IF
CHECKVAR G321 = 0
#ACT
GIVE 200000元宝
SAVEVAR G321 1
SENDMSG 6 "今日奖励已发放！"
#ELSEACT
SENDMSG 6 "今日奖励已领取！"

[@Guild]
#IF
CHECKGUILDLIST ..\QuestDiary\沙巴克行会名单.txt
#ACT
MOVR P10 1000 10000
GIVE 元宝 <$STR(P10)>
SENDMSG 6 "行会成员<$USERNAME>获得随机奖励：<$STR(P10)>元宝！"
```


---

#### 六、进阶设计：自动化任务与机器人脚本
1. **机器人脚本配置**：
- 在 `RobotManage.txt` 中添加定时任务，每日22:00自动开启攻沙状态。
2. **奖励清理机制**：
```lua
#ACT
CLEARVAR G321 ; 每日0点重置领取状态
SENDMSG 0 "今日攻沙奖励已重置！"
```


---

**总结**：攻沙奖励脚本的设计需兼顾身份验证、时间控制、变量管理三大核心模块，通过分层逻辑实现奖励精准发放。结合全局变量与文件读写功能，可进一步扩展为支持千人行会的大型奖励系统。