# PremiumVoucher 🎫
一个全面的代金券系统，支持玩家创建、提供 GUI 界面，并为 Minecraft 服务器提供高级管理功能。
## 🌟 主要功能
- **多种代金券类型** - 金钱、经验和命令代金券
- **玩家创建** - 允许玩家创建自己的代金券并收取费用
- **GUI 界面** - 直观的图形界面用于代金券管理
- **数据库支持** - 带有自动备份功能的 SQLite 数据库
- **经济系统集成** - 全面的 Vault 经济系统支持
- **高级管理** - 冷却时间、使用限制和过期系统
- **权限系统** - 对代金券访问的细粒度控制
- **管理员工具** - 全面的统计信息和管理命令
## 📋 命令
```
/voucher create [uses] - 创建一个代金券
/voucher give - 将代金券授予玩家
/voucher list - 列出所有代金券
/voucher stats - 查看代金券统计信息
/voucher delete - 删除一个代金券
/voucher info - 查看代金券信息
/voucher reload - 重新加载配置
/voucher gui - 打开代金券 GUI
/vouchergive - 快速赠送代金券
```
**代金券类型:**
- `money` - 向玩家提供金钱
- `exp` - 提供经验点数
- `commands` - 执行自定义命令
## ⚙️ 配置
```yaml
# PremiumVoucher 配置
config-version: 1
# 消息插件前缀
prefix: "&8[&6Premium&eVoucher&8] &r"
# 代金券设置
vouchers:
cooldown: 30000 # 使用之间的冷却时间（毫秒）
max-uses-per-player: -1 # 每个玩家的最大使用次数（-1 = 无限制）
expire-check-interval: 300 # 检查过期代金券（秒）
auto-save-interval: 600 # 自动保存间隔（秒）
# 玩家创建设置
player-creation:
enabled: true
money:
enabled: true
fee-percentage: 0.1 # 金钱代金券的费用百分比
exp:
enabled: true
fee-percentage: 0.1 # 经验代金券的费用百分比
# 数据库设置
database:
type: "SQLITE"
auto-backup: true
backup-interval: 86400 # 24 小时
keep-backups: 7
# 安全设置
security:
prevent-duplication: true
log-all-redemptions: true
admin-notifications: true
```
## 🔒 权限
```yaml
permissions:
voucher.*:
description: "访问所有代金券命令"
default: false
voucher.admin:
description: "完全的管理员访问权限"
default: op
children:
voucher.use: true
voucher.create.*: true
voucher.give: true
voucher.list: true
voucher.delete: true
voucher.stats: true
voucher.reload: true
voucher.gui: true
voucher.bypass: true
voucher.use:
description: "使用代金券的基本权限"
default: true
voucher.create.*:
description: "创建所有代金券类型的权限"
children:
voucher.create.money: true
voucher.create.exp: true
voucher.create.commands: true
default: false
voucher.create.money:
description: "创建金钱代金券"
default: true
voucher.create.exp:
description: "创建经验代金券"
default: true
voucher.create.commands:
description: "创建命令代金券（仅限管理员）"
default: op
```
## 💻 要求
- **服务器类型:** Paper, Spigot 或 Bukkit
- **Minecraft 版本:** 1.16+ (API 版本 1.16)
- **Java 版本:** 8 或更高版本
- **依赖项:** Vault (需要经济系统功能)
- **数据库:** SQLite (包含)
## 🔧 安装
1. **下载** PremiumVoucher 并确保 **Vault** 已安装
2. **停止** 您的服务器
3. **放置** 两个插件在您的 `plugins/` 文件夹中
4. **启动** 您的服务器
5. **配置** 经济插件（如 EssentialsX）
6. **自定义** `config.yml` 如需要
7. **重新加载** 使用 `/voucher reload`
## 🎮 使用示例
### 创建代金券
```
/voucher create money 1000 5 - 创建 $1000 代金券，使用 5 次
/voucher create exp 30 1 - 创建 30 经验代金券（单次使用）
/voucher create commands 1 -1 - 创建无限命令代金券
```
### 玩家创建（含费用）
玩家可以通过 GUI 或命令创建代金券，并自动从他们的余额/经验中扣除费用。
### GUI 界面
- `/voucher gui` - 打开管理界面
- 创建、管理和分发代金券
- 统计信息和概述面板
- 管理员控制高级管理
## 📊 功能概览
### 代金券管理
- **自动过期** - 设置代金券到期日期
- **使用跟踪** - 监控代金券兑换
- **冷却系统** - 阻止垃圾邮件使用
- **管理员通知** - 实时使用警报
### 数据库功能
- **SQLite 存储** - 可靠的数据持久性
- **自动备份** - 定期数据库备份
- **统计跟踪** - 详细的使用分析
- **数据迁移** - 轻松的服务器转移
### 安全
- **防复制** - 阻止代金券克隆
- **权限检查** - 安全的访问控制
- **审计日志** - 跟踪所有代金券活动
- **验证系统** - 阻止无效代金券
## 💝 支持开发
如果您发现 PremiumVoucher 有用:
- ⭐ **评价** 插件在 Modrinth 上
- 💬 **分享** 给其他服务器所有者
- 🐛 **报告问题** 以帮助改进
- 💡 **建议功能** 以供未来更新
## 📞 支持和社区
- **Discord:** [加入我们的社区](https://discord.gg/NJVHMSMR6m)
- **文档:** 完整的设置和使用指南
- **支持:** 报告错误和功能请求
- **更新:** 发布新功能
---
Made with ❤️ for the Minecraft community | Perfect for economy servers and custom rewards