Sueta

PremiumVoucher

1.0.0

PremiumVoucher is a comprehensive voucher system that allows servers to create and manage money, experience, and command vouchers.

·Plugin
  1. 1.0.0latestPremiumVoucher 1.0.0Aug 27, 2025

    PremiumVoucher 🎫

    A comprehensive voucher system with player creation support, GUI interface, and advanced management features for Minecraft servers. ![Version](https://img.shields.io/badge/Version-1.0.0-blue) ![Minecraft](https://img.shields.io/badge/Minecraft-1.16+-green) ![License](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> [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](https://discord.gg/NJVHMSMR6m) - 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
    310 downloads

Similar projects

Plugin →