🧠 Momentum
⏳ 奖励你的玩家在线时长 — 他们在线时间越长，获得的奖励越多。
📚 查看Wiki
---
## 💡 为什么选择Momentum？
玩家参与度是任何Minecraft服务器的生命线。Momentum通过奖励玩家在线时间，提供动态的分层奖励系统，将每一分钟的游玩时间转化为进步。无论您运行一个小社区还是一个大型网络，Momentum完全可配置的奖励、乘数和跨服务器支持都能轻松地让玩家不断回来。
---
## ✨ 特性
### 核心特性
- 🎁 **渐进式奖励** - 玩得越久，解锁更好的奖励
- 🔄 **回收系统** - 暂时获得乘数加成，重置你的进度
- ⚡ **乘数** - 通过基于权限的奖励乘数赚取更多
- ⏳ **会话持久性** - 进度在服务器切换时继续
- 💤 **空闲检测** - 当玩家空闲时暂停计时器
### 技术特性
- 🌍 **多语言** - 内置对多种语言的支持
- 🧩 **PlaceholderAPI** - 广泛的占位符支持
- 🔗 **跨服务器** - 使用Redis支持网络级会话
- 🛠️ **完全可配置** - 自定义插件的各个方面
- 💰 **经济支持** - 与Vault兼容的经济插件协同工作
- 📊 **统计数据** - 跟踪玩家进度和服务器指标
### 奖励类型
- 💵 金钱奖励 (Vault)
- ⭐ XP/等级
- 🎯 命令
- 🎇 粒子效果
- 🎵 音效
- 以及通过自定义命令更多！
---
## 🖼️ GUI 预览
### 主菜单
### 奖励层级
### 回收系统
---
## ⚙️ 配置
### 文件
- `config.yml` - 主配置文件
- `rewards.yml` - 定义奖励层级和奖励
- `languages/` - 自定义插件消息
### 命令
- `/momentum` - 打开奖励菜单
- `/momentum reload` - 重新加载配置文件 (需要 `momentum.reload` 权限)
### 权限
```yaml
# 基本权限
momentum.use: true # 允许使用 /momentum
momentum.reload: op # 允许重新加载配置文件
# 乘数权限 (将这些权限授予玩家)
momentum.multiplier.1_0: true # 1x (默认)
momentum.multiplier.2_0: false # 2x 乘数
momentum.multiplier.3_0: false # 3x 乘数
```
### 占位符
```
%momentum_multiplier% - 当前奖励乘数
%momentum_playtime% - 当前会话游玩时间
%momentum_next_tier% - 下一个奖励层级的时间
```
## 🔧 要求
| 组件 | 要求 |
|----------------|------------------------------------|
| Minecraft | `1.21.x` |
| 服务器 | `Paper / Bukkit` |
| Java | `21+` |
| Vault | 经济功能所需 |
| 经济插件 | EssentialsX, CMI, 等 (可选) |
| Redis | 用于跨服务器支持 (可选)|
| PlaceholderAPI | 用于占位符 (可选) |
---
## 📥 安装
### 快速开始
1. 从 [GitHub](https://github.com/thepixel3261/Momentum/releases) 或 [Modrinth](https://modrinth.com/plugin/momentum) 下载最新版本
2. 将JAR文件放入服务器的 `/plugins` 文件夹中
3. 启动服务器以生成配置文件
4. 使用您想要的奖励配置 `rewards.yml`
5. 重新启动服务器
### 依赖项
- **所需**:
- Java 21 或更高版本
- Paper/Spigot 1.21.x
- [Vault](https://www.spigotmc.org/resources/vault.34315/) (用于经济支持)
- 一个经济插件 (EssentialsX, CMI, 等)
- **可选**:
- [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) (用于占位符)
- Redis (用于跨服务器功能)
### 更新
1. 备份您的配置文件
2. 将旧的JAR文件替换为新的JAR文件
3. 重新启动服务器
