# 💰 EconomySystem
**EconomySystem** 是一个轻量级、无依赖的经济插件,专为需要简单快速的数字货币系统的 Minecraft 服务器设计。无论您运行生存、 CityBuild 还是 SkyBlock 服务器,此插件都可以在不增加不必要负担的情况下为您提供基本的经济功能。
---
## ✨ 特性
- 💵 简单的数字货币系统(没有物品或钞票)
- ⚙️ 完全可配置的货币格式和初始余额
- 🧾 交易日志(支付、管理员更改等)
- 💬 基本玩家命令:`/pay`、`/balance`、`/balancetop`
- 🛠️ 管理员命令以设置、添加或移除玩家余额
- 📦 使用 **LiteSQL** (`.db` 文件) 的本地数据库支持
- 🐬 如果需要,可选择支持 **MariaDB**
- 🛠️ 无依赖项 – **无需 Vault**
- 🌐 为性能和跨版本兼容性而设计
---
## 🧑💼 命令 & 权限
| 命令 | 描述 | 权限 |
|--------|-------------|------------|
| `/balance [player]` | 查看您或另一个玩家的余额 | `economysystem.command.balance` |
| `/pay ` | 向另一个玩家发送资金 | `economysystem.command.pay` |
| `/balancetop` *(别名: `/baltop`, `/topbalance`)* | 显示最富有的前 10 名玩家 | `economysystem.command.balancetop` |
| `/economyadmin ` *(别名: `/ecoa`)* | 管理员命令以修改余额 | `economysystem.command.economyadmin` |
---
## 🧩 依赖
无。
EconomySystem 能够完全独立运行 – 不需要 Vault、PlaceholderAPI 或其他插件。
---
## ⚙️ 配置
该插件提供一个干净且强大的配置系统。 示例:
```yaml
economy:
# 货币符号
currency-symbol: "$"
# 货币名称
currency-name: "Dollar"
# 玩家开始的金额
start-balance: 100.0
database:
type: litesql # 选项: litesql, mariadb
mariadb:
host: "localhost"
port: 3306
database: "economy"
username: "user"
password: ""
litesql:
file: "economy.db"
```
✅ 默认情况下,该插件使用 LiteSQL 在本地 .db 文件中存储所有玩家数据。
🔁 您可以选择配置 MariaDB 以获得更好的性能和可扩展性。
---
## 📦 兼容性
EconomySystem 的设计具有广泛的兼容性和长期的稳定性,适用于各种 Minecraft 服务器类型和版本。
### ✅ 支持的 Minecraft 版本
- **1.8.x** 到 **1.20.x+**
- 在最新的 Paper/Purpur 构建中积极测试
### ✅ 支持的服务器软件
- **Paper**
- **Spigot**
- **Purpur**
- **Bukkit**
- **与 Bukkit API 兼容的任何分支**
### 🧩 插件依赖
- ❌ **无!**
- 不需要 Vault、PlaceholderAPI 或其他插件
### 🛢️ 数据库支持
| 类型 | 描述 | 推荐用于 |
|----------|---------------------------------------|------------------------------------|
| `litesql` | 轻量级的本地 `.db` 文件 (默认) | 小型到中型服务器 |
| `mariadb` | 外部 SQL 数据库 | 较大的网络或多服务器设置 |
> 💡 您可以通过 `config.yml` 随时在数据库之间切换。
---
### 🧪 性能 & 集成
- 最小的内存和 CPU 使用率
- 异步数据处理
- 快速加载时间,即使有数千条玩家记录