About MimiKoth

Supported Minecraft Versions: 1.21-26.1.2

Required Java Version: 21 or higher

DISCORD

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> [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.