关于 MimiKoth
支持的 Minecraft 版本:1.21-26.1.2
所需 Java 版本:21 或更高版本
为什么选择 MimiVouchers?
大多数代金券插件依赖于不安全的项目重命名(lore/name 检查)或被过时的遗留代码拖累。MimiVouchers 改变了这一现状。
此插件保证 100% 防复制和防伪造安全性。玩家无法使用铁砧伪造代金券,服务器卡顿/崩溃也不会导致奖励被复制。
无论你需要简单的经济代金券、带有概率百分比的复杂神秘宝箱,还是带有自定义模型数据的专属高级钥匙,MimiVouchers 都能完美处理。
核心功能
- 坚不可摧的安全性
- PDC 标记:代金券通过不可见的、不可伪造的 NBT 数据进行标识。
- 防复制架构:在执行任何命令之前,项目会从库存中移除。告别基于卡顿的双重兑换问题。
- 防放置:防止玩家将
PLAYER_HEAD 类型的代金券意外放置在地板上。
- 堆叠控制:你可以明确选择哪些代金券可以堆叠,哪些不能,并通过动态 UUID 注入强制禁止堆叠。
高级奖励系统
基于概率的机会:设置精确的概率(例如,5% 几率获得大奖,100% 几率获得基础货币)。
奖励类型:
multiples:每个动作独立计算其机会(玩家可以赢得多个物品)。
normal:系统评估权重并从列表中恰好选择一个奖励。
玩家与控制台执行:以服务器身份运行命令或强制玩家运行命令。
完全可定制的外观
- 现代文本格式:完全支持 MiniMessage 十六进制颜色 (
&#RRGGBB)、渐变和传统颜色代码。
- 自定义模型数据支持:轻松将你的代金券集成到你的服务器资源包中!只需在配置中添加
custom-model-data: 10001。
- Base64 头部贴图:内置对自定义
PLAYER_HEAD 纹理的支持。
- 发光效果:添加高级附魔辉光,而不会让丑陋的“绑定诅咒”文本破坏你的描述文本。
- 粒子与音效:在兑换时触发史诗般的视觉和听觉反馈。
生活化机制
- Shift + 点击批量兑换:允许玩家一次性兑换整个堆叠的物品(例如 64x 金钱代金券),并支持可配置的限额。
- 双击确认:防止在高价值物品(如高级钥匙或等级)上意外兑换。
- 库存空间检查:要求玩家在打开 - - - 宝箱代金券前拥有 X 个空闲槽位,以防止物品掉落在地上。
- 冷却时间:设置每个代金券的冷却时间(秒、小时或天),并持久保存到磁盘。
- 模块化配置:保持整洁。在
vouchers/ 文件夹内随意放入任意数量的 .yml 文件(例如 economy.yml, crates.yml),插件将自动加载它们!
命令与权限
主命令:/mimivoucher (别名:/mv, /voucher, /vouchers)
/mv give <player> <id> [amount] - 给予玩家一个代金券。
/mv list - 查看所有文件中加载的所有代金券。
/mv info <id> - 在游戏中检查代金券的配置。
/mv reload - 热重载配置、消息和代金券,无需重启。
权限:
mimivouchers.admin - 授予所有管理命令的访问权限。
mimivouchers.use - 允许玩家右键点击并使用代金券(默认启用)。
- 每个代金券的自定义权限(例如
mimivouchers.vouchervip)。
需求与挂钩
服务器版本:Paper / Purpur / Folia 1.21+(需要 Java 21)。
PlaceholderAPI(可选但推荐):在项目、描述文本和广播消息中提供完整的 PAPI 支持。
开发者 API(即将推出)
本着模块化理念构建。强大的管理器架构很快将提供完整的 API,用于自定义奖励挂钩和外部数据库同步。
About MimiKoth
Supported Minecraft Versions: 1.21-26.1.2
Required Java Version: 21 or higher
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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧