# 🏦 MithCraft Magnata - Minecraft Magnate 系统完整版
一个专为 Minecraft 服务器设计的 Magnate 插件，能够自动识别最富有的玩家，并提供一套完整的奖励和认可系统，从而节省服务器资源。
## ✨ 特性
- 🤑 **自动识别**最富有的玩家（大亨）
- 🎁 **完全可配置的奖励系统**
- 📜 **带有分页功能的完整历史记录**
- 💬 **通过 messages.yml 进行 100% 自定义的消息**
- 🔗 **与 Vault、LuckPerms 和 PlaceholderAPI 原生集成**
- 📊 **15 多个占位符**，可用于其他插件
- ⚡ **针对 Purpur 1.21+ 服务器进行了优化**
## 📥 安装
1. 从 [Releases](https://github.com/PETRALHA/MithCraft_Magnata/releases) 标签下载最新版本。
2. 将 `.jar` 文件放置在 `plugins/` 文件夹中。
3. 重启服务器。
4. 在 `plugins/MithCraftMagnata/config.yml` 文件中按照需要进行配置。
## ⚙️ 基本配置
```yaml
# plugins/MithCraftMagnata/config.yml
settings:
check_interval: 300 # 5分钟验证一次
rewards:
on_become:
- "eco give %player% 100" # 给予 $100
- "lp user %player% parent add magnata" # 添加 magnata 组
- "lp user %magnata_previous_player% parent remove magnata" # 从前一个大亨移除
periodic:
interval: 60 # 每 1 小时奖励一次
commands:
- "eco give %player% 500"
```
## 📌 占位符 (PlaceholderAPI)
### 基本
| 占位符 | 描述 | 示例 |
|----------------------|-------------------------------|-----------------|
| `%magnata_name%` | 当前大亨的名称 | `Steve` |
| `%magnata_balance%` | 格式化的财富 | `$1,000.00` |
### 排名
| 占位符 | 描述 |
|------------------------|-------------------------------|
| `%magnata_position_1%` | 第一名玩家 |
| `%magnata_top_3_line%` | 格式化的前三名行 |
[查看完整的占位符列表](#placeholders-completos)
## 🎮 指令
| 指令 | 描述 | 权限 |
|-----------------------|-------------------------------|--------------------|
| `/magnata` | 显示当前大亨 | `magnata.command` |
| `/magnata history [página]` | 查看历史 | `magnata.history` |
| `/magnata reload` | 重新加载设置 | `magnata.reload` |
| `/magnata help` | 显示帮助菜单 | `magnata.help` |
| `/magnata` | 显示当前大亨 | `magnata.command` |
**别名:** `/magnata ajuda`, `/magnata ?`, `/magnata hist`, `/magnata list`
## 📚 权限系统
- `magnata.command` - 基本指令访问
- `magnata.history` - 查看历史
- `magnata.reload` - 重新加载插件
- `magnata.notify` - 接收通知
- `magnata.help` - 查看帮助菜单
- `magnata.admin` - 完全访问
## 🔗 有用链接
- [报告 Bug](https://github.com/PETRALHA/MithCraft_Magnata/issues)
- [请求功能](https://github.com/PETRALHA/MithCraft_Magnata/discussions)
---
```