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

Download PremiumVoucher and ensure Vault is installed
Stop your server
Place both plugins in your plugins/ folder
Start your server
Configure economy plugin (like EssentialsX)
Customize config.yml as needed
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

PremiumVoucher