MimiVouchers

# About MimiKoth Supported Minecraft Versions: 1.21-26.1.2 Required Java Version: 21 or higher (https://discord.gg/dMqbVMFa5v) ### (https://www.paypal.com/paypalme/casqi) # Why 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> ` - *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.