PremiumVoucher

# PremiumVoucher 🎫 A comprehensive voucher system with player creation support, GUI interface, and advanced management features for Minecraft servers. !(https://img.shields.io/badge/Version-1.0.0-blue) !(https://img.shields.io/badge/Minecraft-1.21+-green) !(https://img.shields.io/badge/License-MIT-yellow) ## 🌟 Key Features - **Multiple Voucher Types** - Money, Experience, and Command vouchers - **Player Creation** - Allow players to create their own vouchers with fees - **GUI Interface** - Intuitive graphical interface for voucher management - **Database Support** - SQLite database with auto-backup functionality - **Economy Integration** - Full Vault economy support - **Advanced Management** - Cooldowns, usage limits, and expiration system - **Permission System** - Fine-grained control over voucher access - **Admin Tools** - Comprehensive statistics and management commands ## 📋 Commands ``` /voucher create <type> <amount> - Create a voucher /voucher give <player> <voucher_id> - Give voucher to player /voucher list - List all vouchers /voucher stats - View voucher statistics /voucher delete <voucher_id> - Delete a voucher /voucher info <voucher_id> - View voucher information /voucher reload - Reload configuration /voucher gui - Open voucher GUI /vouchergive <player> <type> <amount> - Quick give voucher ``` **Voucher Types:** - `money` - Give money to players - `exp` - Give experience points - `commands` - Execute custom commands ## ⚙️ Configuration ```yaml # PremiumVoucher Configuration config-version: 1 # Plugin prefix for messages prefix: "&8 &r" # Voucher Settings vouchers: cooldown: 30000 # Cooldown between uses (ms) max-uses-per-player: -1 # Max uses per player (-1 = unlimited) expire-check-interval: 300 # Check expired vouchers (seconds) auto-save-interval: 600 # Auto-save interval (seconds) # Player Creation Settings player-creation: enabled: true money: enabled: true fee-percentage: 0.1 # 10% fee for money vouchers exp: enabled: true fee-percentage: 0.1 # 10% fee for exp vouchers # Database Settings database: type: "SQLITE" auto-backup: true backup-interval: 86400 # 24 hours keep-backups: 7 # Security Settings security: prevent-duplication: true log-all-redemptions: true admin-notifications: true ``` ## 🔒 Permissions ```yaml permissions: voucher.*: description: "Access to all voucher commands" default: false voucher.admin: description: "Full administrative access" 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: "Basic permission to use vouchers" default: true voucher.create.*: description: "Permission to create all voucher types" children: voucher.create.money: true voucher.create.exp: true voucher.create.commands: true default: false voucher.create.money: description: "Create money vouchers" default: true voucher.create.exp: description: "Create experience vouchers" default: true voucher.create.commands: description: "Create command vouchers (admin only)" default: op ``` ## 💻 Requirements - **Server Type:** Paper, Spigot, or Bukkit - **Minecraft Version:** 1.16+ (API Version 1.16) - **Java Version:** 8 or higher - **Dependencies:** Vault (required for economy features) - **Database:** SQLite (included) ## 🔧 Installation 1. **Download** PremiumVoucher and ensure **Vault** is installed 2. **Stop** your server 3. **Place** both plugins in your `plugins/` folder 4. **Start** your server 5. **Configure** economy plugin (like EssentialsX) 6. **Customize** `config.yml` as needed 7. **Reload** with `/voucher reload` ## 🎮 Usage Examples ### Creating Vouchers ``` /voucher create money 1000 5 - Create $1000 voucher with 5 uses /voucher create exp 30 1 - Create 30 levels exp voucher (single use) /voucher create commands 1 -1 - Create unlimited command voucher ``` ### Player Creation (with fees) Players can create vouchers through GUI or commands, with automatic fee deduction from their balance/experience. ### GUI Interface - `/voucher gui` - Opens management interface - Create, manage, and distribute vouchers visually - Statistics and overview panels - Admin controls for advanced management ## 📊 Features Overview ### Voucher Management - **Auto-expiration** - Set expiration dates for vouchers - **Usage tracking** - Monitor voucher redemptions - **Cooldown system** - Prevent spa