PremiumVoucher 🎫

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

🌟 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> [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

# 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

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 spam usage
• Admin notifications - Real-time usage alerts

Database Features

• SQLite storage - Reliable data persistence
• Auto-backup - Regular database backups
• Statistics tracking - Detailed usage analytics
• Data migration - Easy server transfers

Security

• Anti-duplication - Prevent voucher cloning
• Permission checks - Secure access control
• Audit logging - Track all voucher activities
• Validation system - Prevent invalid vouchers

💝 Support Development

If you find PremiumVoucher useful:

• ⭐ Rate the plugin on Modrinth
• 💬 Share with other server owners
• 🐛 Report issues to help improve
• 💡 Suggest features for future updates

📞 Support & Community

• Discord: Join our community
• Documentation: Full setup and usage guides
• Support: Bug reports and feature requests
• Updates: Regular releases with new features

---

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