? PromoPlugin
适用于 Minecraft 服务器的强大促销码管理系统
管理 Paper/Spigot 服务器上的促销码、每日奖励和玩家互动的终极解决方案!
✨ 功能特性
? 核心促销码系统
- 创建具有自定义奖励的无限促销码
- 预配置的奖励模板,便于快速设置
- 使用 SQLite 数据库进行持久化数据存储
- 使用次数限制和过期控制
- 用于统计和管理信息的交互式 GUI
- 购买追踪与分析
- 统计数据导出功能
? 高级系统 (v1.1.0)
| 系统 |
描述 |
| 每日奖励 |
登录奖励及连续登录加成(7 天 = 钻石,30 天 = 绿宝石) |
| 排行榜 |
按消费金额和促销码创建数量追踪顶级玩家 |
| 自动促销码 |
每小时/每天自动生成促销码 |
| 通知系统 |
Discord Webhook、Telegram 机器人以及游戏内警报 |
| 促销商店 |
销售带有自定义奖励的预设促销码礼包 |
? 要求
- 服务端软件: Paper 1.20.4+ 或 Spigot 1.20.4+
- Java 版本: Java 17 或更高
- 依赖项: 无需额外依赖(内置 SQLite)
- 可选: Vault 用于经济系统集成
? 安装指南
快速设置
- 下载 Modrinth 上最新的
PromoPlugin.jar
- 放置 到服务器的
plugins/ 文件夹中
- 重启 你的服务器
- 配置
plugins/PromoPlugin/config.yml 以满足需求
完成!插件将自动创建所有必要的文件。
? 命令
玩家指令
| 命令 |
描述 |
/promocod <code> |
激活促销码 |
/dailyreward |
领取每日登录奖励 |
/dailyreward stats |
查看你的奖励统计信息 |
/leaderboard [category] [limit] |
查看顶级玩家 |
管理员指令
| 命令 |
描述 |
/createpromocod <name> [template] |
创建新的促销码 |
/exitpromocod <name> |
查看促销码统计信息 |
/promopurchase <player> <code> <amount> |
记录一笔购买交易 |
/promoreload |
重载插件配置 |
/promoexport <name> |
导出统计数据 |
/promoreset <name> |
重置促销码统计信息 |
? 权限
| 权限节点 |
描述 |
默认值 |
promo.promocod.use |
激活促销码 |
✓ 所有人 |
promo.create |
创建促销码 |
OP |
promo.dailyreward |
使用每日奖励 |
✓ 所有人 |
promo.leaderboard |
查看排行榜 |
✓ 所有人 |
promo.admin |
所有管理员命令 |
OP |
⚙️ 配置
主配置文件:plugins/PromoPlugin/config.yml
示例:每日奖励
daily-rewards:
enabled: true
streak-bonuses:
7: "DIAMOND:1"
14: "DIAMOND:3"
30: "EMERALD:1"
示例:Discord 通知
notifications:
discord:
enabled: true
webhook-url: "YOUR_WEBHOOK_URL"
示例:自动促销码
auto-promo-codes:
enabled: true
hourly:
enabled: true
prefix: "H"
max-uses: 100
price: 50.0
? 核心功能详解
? 每日奖励系统
通过每日登录奖励鼓励玩家留存:
- 追踪连续登录天数
- 在 7、14 和 30 天时提供额外奖励
- 完全可自定义的奖励物品
- 自动数据库追踪
? 排行榜系统
竞争性的玩家追踪:
- 最高消费排行榜
- 最佳促销码创作者排行榜
- 实时统计数据更新
- 可自定义显示限制
? 自动促销码生成
自动化分发您的促销码:
- 每小时或每天自动生成代码
- 唯一代码生成
- 按时间表自定义奖励
- 创建时向管理员发送通知
? 多渠道通知
跨平台保持知情:
- 游戏内: 通知管理员重要事件
- Discord: Webhook 集成以接收服务器警报
- Telegram: 移动端访问的机器人通知
? 促销商店系统
通过促销码变现:
- 创建打包的促销码产品
- 设置每日购买限制
- 每个产品自定义奖励
- 自动库存管理
?️ 数据库
PromoPlugin 使用 SQLite 存储所有数据:
创建的表:
promo_codes - 所有促销码及其设置
transactions - 购买记录
daily_rewards - 玩家连续登录追踪
player_stats - 活动统计数据
leaderboard - 排名数据
promo_shop - 商店商品
promo_purchases - 购买历史
位置: plugins/PromoPlugin/promo.db
所有表将在首次启动时自动创建。
? 更新日志
v1.1.0 - 最新版本
- ✨ 新增每日奖励系统
- ✨ 新增排行榜功能
- ✨ 新增自动促销码生成
- ✨ 新增通知系统(Discord、Telegram)
- ✨ 新增促销商店系统
- ? 修复数据库连接问题
- ? 改进错误处理
v1.0.0
- ✨ 初始发布
- ✨ 核心促销码系统
- ✨ SQLite 数据库支持
- ✨ GUI 统计查看器
? 支持与资源
? 许可证
本项目遵循 MIT License 许可证。详细信息请参见 LICENSE。
? 鸣谢
- 开发者: Muliccki
- PaperMC - 提供 Paper API
- 社区 - 参与测试并提供反馈
⭐ Star 历史
如果您觉得此插件有用,请 给仓库加星 并在 Modrinth 上评分!这有助于他人发现该插件。
为 Minecraft 社区 ❤️ 制作
在 Modrinth 下载 • 加入 Discord
? PromoPlugin
Powerful Promo Code Management System for Minecraft Servers
The ultimate solution for managing promo codes, daily rewards, and player engagement on your Paper/Spigot server!
✨ Features
? Core Promo Code System
- Create unlimited promo codes with custom rewards
- Pre-configured reward templates for quick setup
- SQLite database for persistent data storage
- Usage limits and expiration controls
- Interactive GUI for statistics and management
- Purchase tracking and analytics
- Statistics export functionality
? Advanced Systems (v1.1.0)
| System |
Description |
| Daily Rewards |
Login rewards with streak bonuses (7 days = diamond, 30 days = emerald) |
| Leaderboard |
Track top players by spending and code creation |
| Auto-Promo Codes |
Automatic code generation every hour/day |
| Notifications |
Discord webhook, Telegram bot, and in-game alerts |
| Promo Shop |
Sell ready-made promo code packs with custom rewards |
? Requirements
- Server Software: Paper 1.20.4+ or Spigot 1.20.4+
- Java Version: Java 17 or higher
- Dependencies: None required (SQLite built-in)
- Optional: Vault for economy integration
? Installation
Quick Setup
- Download the latest
PromoPlugin.jar from Modrinth
- Place it in your server's
plugins/ folder
- Restart your server
- Configure
plugins/PromoPlugin/config.yml as needed
That's it! The plugin will create all necessary files automatically.
? Commands
For Players
| Command |
Description |
/promocod <code> |
Activate a promo code |
/dailyreward |
Claim daily login reward |
/dailyreward stats |
View your reward statistics |
/leaderboard [category] [limit] |
View top players |
For Administrators
| Command |
Description |
/createpromocod <name> [template] |
Create a new promo code |
/exitpromocod <name> |
View promo code statistics |
/promopurchase <player> <code> <amount> |
Record a purchase |
/promoreload |
Reload plugin configuration |
/promoexport <name> |
Export statistics |
/promoreset <name> |
Reset promo code stats |
? Permissions
| Permission |
Description |
Default |
promo.promocod.use |
Activate promo codes |
✓ All |
promo.create |
Create promo codes |
OP |
promo.dailyreward |
Use daily rewards |
✓ All |
promo.leaderboard |
View leaderboard |
✓ All |
promo.admin |
All admin commands |
OP |
⚙️ Configuration
Main configuration file: plugins/PromoPlugin/config.yml
Example: Daily Rewards
daily-rewards:
enabled: true
streak-bonuses:
7: "DIAMOND:1"
14: "DIAMOND:3"
30: "EMERALD:1"
Example: Discord Notifications
notifications:
discord:
enabled: true
webhook-url: "YOUR_WEBHOOK_URL"
Example: Auto-Promo Codes
auto-promo-codes:
enabled: true
hourly:
enabled: true
prefix: "H"
max-uses: 100
price: 50.0
? Key Features Explained
? Daily Reward System
Encourage player retention with daily login rewards:
- Track consecutive login streaks
- Bonus rewards at 7, 14, and 30 days
- Fully customizable reward items
- Automatic database tracking
? Leaderboard System
Competitive player tracking:
- Top spenders leaderboard
- Top code creators leaderboard
- Real-time statistics updates
- Customizable display limits
? Auto-Promo Code Generation
Automate your promo code distribution:
- Hourly or daily automatic codes
- Unique code generation
- Customizable rewards per schedule
- Admin notifications on creation
? Multi-Channel Notifications
Stay informed across platforms:
- In-Game: Notify admins of important events
- Discord: Webhook integration for server alerts
- Telegram: Bot notifications for mobile access
? Promo Shop System
Monetize your promo codes:
- Create packaged promo code products
- Set daily purchase limits
- Custom rewards per product
- Automatic inventory management
?️ Database
PromoPlugin uses SQLite for all data storage:
Tables Created:
promo_codes - All promo codes and settings
transactions - Purchase records
daily_rewards - Player streak tracking
player_stats - Activity statistics
leaderboard - Ranking data
promo_shop - Shop items
promo_purchases - Purchase history
Location: plugins/PromoPlugin/promo.db
All tables are created automatically on first launch.
? Changelog
v1.1.0 - Latest Release
- ✨ Added daily rewards system
- ✨ Added leaderboard functionality
- ✨ Added auto-promo code generation
- ✨ Added notification system (Discord, Telegram)
- ✨ Added promo shop system
- ? Fixed database connection issues
- ? Improved error handling
v1.0.0
- ✨ Initial release
- ✨ Core promo code system
- ✨ SQLite database support
- ✨ GUI statistics viewer
? Troubleshooting
Common Issues
Problem: "database connection closed"
Solution: Plugin auto-recovers connections. Ensure v1.1.0+ is installed.
Problem: Commands not working
Solution: Check permissions and ensure plugin is enabled (/plugins)
Problem: Discord notifications not sending
Solution: Verify webhook URL is valid and not expired
Problem: Promo codes not activating
Solution: Check code spelling and ensure it exists in database
? Support & Resources
? License
This project is licensed under the MIT License. See LICENSE for details.
? Credits
- Developer: Muliccki
- PaperMC - For the Paper API
- Community - For testing and feedback
⭐ Star History
If you find this plugin useful, please star the repository and rate it on Modrinth! It helps others discover the plugin.
Made with ❤️ for the Minecraft Community
Download on Modrinth • Join Discord
评论 0
登录后参与评分
还没有评论,来抢沙发吧