计时奖励（多人游戏）

描述

**TimedRewards** 会根据玩家在服务器上实际游玩的时长给予奖励：达到一个小时节点，即可获得该节点的奖励。一小时获得五个帕鲁球，五小时获得金币，一百小时获得传说级物品——奖励阶梯完全由你掌控。

## 奖励阶梯是一个设置文件

该模组附带一个简单的默认奖励阶梯，你无需修改代码即可替换它——在模组旁边放入一个 `settings.config` 文件即可：

```ini ; Mods/TimedRewards/settings.config — 管理员奖励阶梯 rewards.1.hours = 1 rewards.1.item = PalSphere rewards.1.count = 5

rewards.2.hours = 10 rewards.2.item = Money rewards.2.count = 1500

rewards.3.hours = 100 rewards.3.item = Money rewards.3.count = 50000

编辑内容会在运行中的服务器上数秒内生效——无需重启。该文件在模组更新后依然保留，因为它属于你，而非模组本身。物品 ID 使用游戏内部名称（金币为 `Money`，面包为 `Pan`）。

<br />
<br />## 结算而非定时

<br />
<br />Palladium 会逐分钟统计游戏时间，支持崩溃安全，并在玩家累计时间达到整点时立即触发事件。TimedRewards 会支付所有低于或等于已游玩时长的未支付奖励节点——并记录每个玩家已领取的奖励。其效果正是你在真实服务器上想要的：

<br />
<br />- 服务器重启绝不会重复发放奖励。
<br />- 服务器离线期间跨过的小时节点会被补记，不会丢失——在玩家下次上线时发放。
<br />- 你后续添加的奖励节点，如果低于玩家已有的游玩时长，会追溯发放。
<br />- 只有实际在线时间才会计入；崩溃最多损失当前正在計数的这一分钟。

<br />
<br />## 玩家指令

<br />
<br />`!rewards` — 查看已游玩小时数、已领取的奖励节点，以及下一个奖励所在的位置。
<br />`?rewards` — 在聊天中解释该指令的用法。

<br />
<br />## 管理员设置

<br />
<br />两个权限节点，默认均为 **允许**：

<br />
<br />- `timedrewards.reward` — 获得里程碑奖励。对默认组设为拒绝，并仅对特定组设为允许，则整个奖励阶梯就变成仅限成员的特权——无需修改代码。
<br />- `timedrewards.check` — 使用 `!rewards` 指令的权限。

<br />
<br />领取记录存储在一个声明的集合中：面板（配合 pal-up）可列出谁领取了什么奖励，`data.list timedrewards.claimed` 可从任何位置读取该数据。删除模组文件夹即可完全移除模组及其记录——干净卸载。

<br />
<br />## 安装

<br />
<br />需要 [Palladium](https://www.nexusmods.com/palworld/mods/YOUR-PALLADIUM-MOD-ID) 4.9.3 或更高版本（游玩时间计数器和整点事件功能包含在其中）。

<br />
<br />- **使用 pal-up：** 将 TimedRewards 文件夹放入 `./mods` 目录并重启。
<br />- **独立 Palladium：** 将文件夹放入 Palladium 旁边的 `Mods/` 目录下，在 `Mods/Palladium/mods.list` 中添加 `TimedRewards`，然后重启。

<br />
<br />在 UE4SS.log 中确认加载成功：

<br />
<br />```
[Palladium] framework: loaded TimedRewards (2 handler(s), 1 command(s))

## 源代码

一个可读的文件，作为基于游玩时间驱动的模组参考实现：[GitHub 上的 mod.lua](https://github.com/s-kiu/pal-up/tree/main/mods/TimedRewards)。仅服务端使用——玩家无需安装任何内容。

────────────────────────────────────────────────────

更新日志 (1.0.0)

首次发布。
- 按小时节点发放奖励，奖励阶梯由管理员在 settings.config 中定义，实时生效。
- 支付所有低于或等于已游玩时长的未支付奖励节点；同一节点绝不重复发放；后续添加的节点会追溯发放。
- 聊天指令 `!rewards` / `?rewards`；两个权限节点控制领取和查询权限。
- 每个玩家的领取记录存储在声明的集合中，可从面板或 API 读取。