PromoPlugins

<div align="center"> # 🎫 PromoPlugin ### Powerful Promo Code Management System for Minecraft Servers (https://img.shields.io/modrinth/dt.promoplugin?color=00AF5C&logo=modrinth)](https://modrinth.com/plugin/promoplugin) (https://img.shields.io/modrinth/v.promoplugin?color=blue)](https://modrinth.com/plugin/promoplugin) (https://img.shields.io/badge/MC-1.20.4%2B-green)](https://modrinth.com/plugin/promoplugin) (https://img.shields.io/badge/license-MIT-yellow)](https://github.com/yourusername/promoplugin) **The ultimate solution for managing promo codes, daily rewards, and player engagement on your Paper/Spigot server!** </div> --- ## ✨ 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 1. **Download** the latest `PromoPlugin.jar` from Modrinth 2. **Place** it in your server's `plugins/` folder 3. **Restart** your server 4. **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 ` | View top players | ### For Administrators | Command | Description | |---------|-------------| | `/createpromocod <name> ` | 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 ```yaml daily-rewards: enabled: true streak-bonuses: 7: "DIAMOND:1" 14: "DIAMOND:3" 30: "EMERALD:1" ``` ### Example: Discord Notifications ```yaml notifications: discord: enabled: true webhook-url: "YOUR_WEBHOOK_URL" ``` ### Example: Auto-Promo Codes ```yaml 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