MimiVouchers

Most voucher plugins rely on insecure item renaming (lore/name checks) or are bogged down by outdated legacy code. MimiVouchers changes the game.

This plugin guarantees 100% anti-duplication and anti-spoofing security. Players cannot forge vouchers using anvils, and server lag/crashes will never duplicate rewards.

Whether you need simple Economy Vouchers, complex Mystery Lootboxes with percentage chances, or exclusive Premium Keys with Custom Model Data, MimiVouchers handles it all flawlessly.

Core Features
Bulletproof Security
PDC Tagging: Vouchers are identified by invisible, unforgeable NBT data.
Anti-Dupe Architecture: Items are removed from the inventory *before* any commands are executed. Say goodbye to lag-based double-redemptions.
Anti-Placement: Prevents players from accidentally placing `PLAYER_HEAD` vouchers on the ground.
Stack Control: You can explicitly choose which vouchers can be stacked and which cannot, with dynamic UUID injection to force unstackability.

Advanced Reward System
Percentage-Based Chances: Set exact probabilities (e.g., 5% chance for a Jackpot, 100% chance for base money).
Reward Types:
- ` multiples`: Every action rolls its chance independently (players can win multiple things).
- ` normal`: The system evaluates weights and picks exactly *one* reward from the list.
Player & Console Execution: Run commands as the server or force the player to run them.




Fully Customizable Aesthetics
Modern Text Formatting: Full support for MiniMessage hex colors (`&#RRGGBB`), gradients, and legacy color codes.
Custom Model Data Support: Easily hook your vouchers into your server's Resource Pack! Just add `custom-model-data: 10001` to your config.
Base64 Heads: Built-in support for custom `PLAYER_HEAD` textures.
Glow Effects: Add that premium enchant-glint without ugly "Binding Curse" text ruining your lore.
Particles & Sounds: Trigger epic visual and audio feedback upon redemption.

Quality of Life Mechanics
Shift + Click Mass Redeem: Allow players to redeem entire stacks (e.g., 64x Money Vouchers) instantly with configurable limits.
Double-Click Confirmation: Prevent accidental redemptions on high-value items (like Premium Keys or Ranks).
Inventory Space Checks: Require players to have *X* amount of free slots before opening a Lootbox voucher so items don't drop on the floor.
Cooldowns: Set per-voucher cooldowns (seconds, hours, or days) saved persistently to disk.
Modular Configuration: Keep things clean. Drop as many `.yml` files as you want inside the `vouchers/` folder (e.g., `economy.yml`, `crates.yml`) and the plugin will auto-load them all!

Commands & Permissions

Main Command: `/mimivoucher` (Aliases: `/mv`, `/voucher`, `/vouchers`)

- `/mv give <player> <id> [amount]` - *Give a voucher to a player.*
- `/mv list` - *See all loaded vouchers across all files.*
- `/mv info <id>` - *Inspect a voucher's configuration in-game.*
- `/mv reload` - *Hot-reload configs, messages, and vouchers without restarting.*

Permissions:
- `mimivouchers.admin` - *Grants access to all admin commands.*
- `mimivouchers.use` - *Allows players to right-click and use vouchers (Enabled by default).*
- Custom per-voucher permissions (e.g., `mimivouchers.vouchervip`).

Requirements & Hooks
Server Version: Paper / Purpur / Folia 1.21+ (Requires Java 21).
PlaceholderAPI (Optional but recommended): Full PAPI support in items, lores, and broadcast messages.

Developer API (Coming Soon)
Built with modularity in mind. The robust manager architecture will soon feature a full API for custom reward hooks and external database synchronization.