PhantomVouchers
PhantomVouchers is a Minecraft plugin that provides a robust, flexible voucher system for servers. It focuses on simplicity, performance and extensibility, allowing server admins to create and manage vouchers with ease. The plugin supports custom actions, base64 textures, an admin preview GUI, cooldowns, region/world restrictions, PlaceholderAPI and full YAML configuration.

Features

• Voucher system: create vouchers with unique properties and actions
  
• Custom actions: run commands, play sounds, give items, etc.
  
• Base64 support: use Base64-encoded textures for custom item appearances
  
• Admin preview menu: paginated GUI to view/manage vouchers
  
• Confirmation system: two-step confirmation to avoid accidental redemptions
  
• Cooldown management: efficient caching of cooldowns for performance
  
• Region & world support: restrict voucher usage by region or world
  
• Randomized rewards: chance-based rewards and infinite structure possibilities
  
• PlaceholderAPI integration: dynamic content using placeholders
  
• Fully configurable via YAML files

Installation

1. Download the latest PhantomVouchers.jar from the project releases page or from spigotmc.
   
2. Put the .jar into your server's plugins folder.
   
3. Restart the server to generate configuration files.
   
4. Edit the YAML files in plugins/PhantomVouchers to configure the plugin.

Configuration
PhantomVouchers uses several config files to control behavior:

• settings.yml - general plugin settings
  
• commands.yml - command aliases and permissions
  
• messages.yml - customizable plugin messages
  
• vouchers/ - folder containing individual voucher files

Example voucher file (place in vouchers/):
material: PAPER
display-name: "&6Special Voucher"
lore:
- "&7Right-click to redeem!"
base64: "(Base64_String_here)"
redeem-actions:
- "[RANDOM] 10:[SOUND] BLOCK_BREWING_STAND_BREW;0.5;0.5|[COMMAND] give %player% diamond 1"
- "[RANDOM] 5:[COMMAND] give %player% emerald 1"

Commands

• /voucher give <player> <voucher> — give a voucher to a player
  
• /voucher reload — reload plugin configuration
  
• /voucher preview — open the admin preview menu

Permissions

• phantomvouchers.give — use /voucher give
  
• phantomvouchers.reload — use /voucher reload
  
• phantomvouchers.preview — use /voucher preview

Developer notes

• Add custom actions by implementing the IAction interface.
  
• Use the existing ItemBuilder utility to build voucher items.
  
• Use the ActionManager to register and execute custom actions.

Contributing
Contributions welcome. Please fork the repository on GitHub and submit a pull request. Follow existing code style and include documentation for changes.

License
PhantomVouchers is licensed under the MIT License.