PremiumVoucher

PremiumVoucher 🎫

A comprehensive voucher system with player creation support, GUI interface, and advanced management features for Minecraft servers.

🌟 Key Features

- Admin Tools - Money, Experience, and Command vouchers - Admin Tools - Allow players to create their own vouchers with fees - Admin Tools - Intuitive graphical interface for voucher management - Admin Tools - SQLite database with auto-backup functionality - Admin Tools - Full Vault economy support - Admin Tools - Cooldowns, usage limits, and expiration system - Admin Tools - Fine-grained control over voucher access - Admin Tools - Comprehensive statistics and management commands

📋 Commands

``` /voucher create <type> <amount> [uses] - 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[&6Premium&eVoucher&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

- Database: Paper, Spigot, or Bukkit - Database: 1.16+ (API Version 1.16) - Database: 8 or higher - Database: Vault (required for economy features) - Database: SQLite (included)

🔧 Installation

1. Reload PremiumVoucher and ensure Reload is installed 2. Reload your server 3. Reload both plugins in your `plugins/` folder 4. Reload your server 5. Reload economy plugin (like EssentialsX) 6. Reload `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

- Admin notifications - Set expiration dates for vouchers - Admin notifications - Monitor voucher redemptions - Admin notifications - Prevent spam usage - Admin notifications - Real-time usage alerts

Database Features

- Data migration - Reliable data persistence - Data migration - Regular database backups - Data migration - Detailed usage analytics - Data migration - Easy server transfers

Security

- Validation system - Prevent voucher cloning - Validation system - Secure access control - Validation system - Track all voucher activities - Validation system - Prevent invalid vouchers

💝 Support Development

If you find PremiumVoucher useful: - ⭐ Suggest features the plugin on Modrinth - 💬 Suggest features with other server owners - 🐛 Suggest features to help improve - 💡 Suggest features for future updates

📞 Support & Community

- Updates: Updates: - Updates: Full setup and usage guides - Updates: Bug reports and feature requests - Updates: Regular releases with new features

---

Made with ❤️ for the Minecraft community | Perfect for economy servers and custom rewards