? TCrates — 下一代奖励引擎
⚡ 什么是 TCrates?
大多数 Minecraft 的箱子插件设计于近十年前——它们严重占用主服务器线程,充斥着过时的库,缺乏玩家留存机制,且使用已过时的文本格式。
TCrates 是一个完全现代化、高性能的奖励与箱子引擎,专为现代 Paper 和 Purpur 服务器(1.21+)从头构建。它采用零延迟异步架构、生产级连接池以及现代的 Adventure MiniMessage 文本系统,将普通的开箱体验转化为令人上瘾、公平且引人入胜的游戏化体验。
✨ 核心功能与游戏机制
? 1. 公平抽卡与保底系统(保证掉落)
让你的玩家不再经历无尽的非酋时刻:
- 动态保底计数器:在配置的非稀有抽取次数后,自动保证获得更高阶的奖励。
- 透明掉落概率:玩家可以实时查看每个奖励的确切计算概率。
- 重复保护:自动检测玩家是否已拥有独家奖励,并将重复物品转换为碎片、游戏货币或安慰性钥匙。
? 2. 碎片与炼金融合
赋予无用的掉落物实际用途:
- 不想要或低阶的箱子奖励可以生成或被拆解为碎片(
COMMON, UNCOMMON, RARE, EPIC, LEGENDARY)。
- 交互式炼金 GUI(
/tcrates shards)允许玩家将 10 个低阶碎片合成为 1 个高阶碎片,创造出一条令人满意的长期成长路径。
? 3. 渐进式社区奖池
- 每开启一个箱子都会向全局服务器范围的奖池贡献一小部分资金。
- 当幸运玩家中奖时,服务器将通过广播公告、粒子效果和可自定义的奖池 payout 进行庆祝。
? 4. 交互式箱子任务与里程碑
- 每日和每周开启任务(例如,“开启 5 个新手箱子”或“融合 3 个稀有碎片”)。
- 玩家可以通过 GUI 中的清晰进度条(
/tcrates missions)跟踪进度并领取独家奖励。
? 5. 离线与溢出邮箱
- 由于背包已满或突然断开连接,玩家永远不会丢失箱子奖励。
- 未交付的物品会自动路由到其个人安全的虚拟邮箱(
/tcrates mailbox),随时可访问。
?️ 6. 即时左键点击奖励预览
- 玩家可以左键点击世界中的任何实体箱子方块,打开一个交互式多页奖励预览,显示物品描述、稀有度等级和确切的中奖概率。
- 右键点击消耗一把钥匙并启动开箱动画。
? 7. 蒙特卡洛模拟引擎(面向管理员)
⚡ 8. 现代视觉效果与零延迟架构
- MiniMessage 渐变:清晰、高对比度的现代渐变排版,无任何不必要的原版斜体效果。
- 异步数据库:由 HikariCP 驱动,支持非阻塞 SQLite 和 MySQL。
- 轻量级体积:超优化的 JAR 包(< 550 KB),不包含不必要的阴影依赖。
? 60 秒快速设置
- 放入
plugins/ 目录并启动你的 Paper 1.21+ 服务器。
- 在世界中放置任意方块(例如末影箱、箱子或信标)。
- 直接注视该方块并将其注册为箱子:
/tcrates create starter
- 给自己一把钥匙以进行测试:
/tcrates key starter
- 左键点击箱子以预览奖励,或使用钥匙右键点击来开启!
? 命令参考
| 指令 |
权限 |
描述 |
/tcrates preview <crate> |
tcrates.player |
打开奖励预览 GUI。 |
/tcrates open <crate> |
tcrates.player |
使用可用钥匙虚拟开启一个箱子。 |
/tcrates bulkopen <crate> <amount> |
tcrates.player |
一次性批量开启多个箱子。 |
/tcrates shards |
tcrates.player |
打开碎片炼金与融合 GUI。 |
/tcrates missions |
tcrates.player |
打开箱子任务与里程碑菜单。 |
/tcrates jackpot |
tcrates.player |
显示当前服务器大奖池及历史记录。 |
/tcrates mailbox |
tcrates.player |
打开待领取奖励的邮箱。 |
/tcrates pity [crate] |
tcrates.player |
检查距离保底奖励所需的剩余抽取次数。 |
/tcrates collection [crate] |
tcrates.player |
打开已解锁奖励收藏册。 |
/tcrates history |
tcrates.player |
显示个人开启历史日志。 |
/tcrates create <crate> |
tcrates.admin |
将目标方块链接到箱子。 |
/tcrates remove |
tcrates.admin |
注销目标物理箱子方块。 |
/tcrates givekey <player> <crate> [qty] [phys/virt] |
tcrates.admin |
给予玩家实体或虚拟钥匙。 |
/tcrates luck boost <player> <multiplier> <seconds> |
tcrates.admin |
为玩家提供临时的幸运倍率加成。 |
/tcrates simulate <crate> <iterations> |
tcrates.admin |
运行蒙特卡洛经济平衡模拟。 |
/tcrates backup |
tcrates.admin |
创建数据库的即时热备份。 |
/tcrates reload |
tcrates.admin |
热重载所有配置、箱子和稀有度设置。 |
? 权限说明
tcrates.player — 授予所有核心玩家指令、GUI 和箱子交互的访问权限(默认:true)。
tcrates.admin — 授予创建、编辑、模拟、发放钥匙和重载的完整管理权限(默认:op)。
? PlaceholderAPI 占位符
| 占位符 |
描述 |
%tcrates_keys_<crate>% |
某箱子的总钥匙数(虚拟 + 背包)。 |
%tcrates_virtual_keys_<crate>% |
存储在玩家账户中的虚拟钥匙数量。 |
%tcrates_pity_<crate>% |
当前累积用于保底的抽取次数。 |
%tcrates_jackpot% |
当前累计大奖池金额。 |
%tcrates_shards_<tier>% |
特定等级碎片的玩家余额。 |
%tcrates_opened_total% |
玩家终生开启的箱子总数。 |
%tcrates_luck_multiplier% |
激活的临时幸运倍率(例如 1.5x)。 |
⚙️ 配置预览
箱子在 plugins/TCrates/crates/*.yml 中清晰定义。添加奖励和配置保底机制非常简单:
id: "starter"
name: "<gradient:#55ffff:#00aaff><bold>STARTER CRATE</bold></gradient>"
description: "A well-balanced starter crate for new adventurers."
key:
name: "<aqua><bold>Starter Key</bold></aqua>"
material: "TRIPWIRE_HOOK"
glowing: true
pity:
enabled: true
threshold: 15
guaranteed-rarity: "RARE"
rewards:
- id: "god_sword"
rarity: "LEGENDARY"
weight: 5
item:
material: "DIAMOND_SWORD"
name: "<gradient:#ffaa00:#ff5500><bold>Excalibur</bold></gradient>"
commands:
- "broadcast <gold><player></gold> found <yellow>Excalibur</yellow>!"
?️ 要求与兼容性
- 服务端软件:Paper、Purpur 或兼容分支。
- Minecraft 版本:1.21.x(支持 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4)。
- Java 版本:Java 21 或更高版本。
- 可选挂钩:PlaceholderAPI、Vault(用于经济/货币重复转换)。
? TCrates — The Next-Generation Reward Engine
⚡ What is TCrates?
Most crate plugins in Minecraft were designed almost a decade ago — heavy on the main server thread, bloated with obsolete libraries, lacking player-retention mechanics, and using outdated formatting.
TCrates is a completely modern, high-performance reward and crate engine designed from the ground up for modern Paper and Purpur servers (1.21+). Built with zero-lag asynchronous architectures, production-grade connection pooling, and modern Adventure MiniMessage text, it transforms ordinary crate opening into an addictive, fair, and engaging gamified experience.
✨ Key Features & Game Mechanics
? 1. Fair Gacha & Pity System (Guaranteed Rewards)
No more endless bad-luck streaks for your players:
- Dynamic Pity Counters: Automatically guarantees higher-tier rewards after a configurable number of non-rare rolls.
- Transparent Drop Odds: Players can see their exact calculated percentage chance for every reward in real-time.
- Duplicate Protection: Automatically detects if a player already owns an exclusive reward and converts duplicates into shards, in-game currency, or consolation keys.
? 2. Shards & Alchemy Fusion
Give worthless drops real purpose:
- Unwanted or low-tier crate rewards can grant or be dismantled into Shards (
COMMON, UNCOMMON, RARE, EPIC, LEGENDARY).
- Interactive Alchemy GUI (
/tcrates shards) lets players fuse 10 lower-tier shards into 1 higher-tier shard, creating a satisfying long-term progression path.
? 3. Progressive Community Jackpots
- Every crate opened contributes a small portion to a global, server-wide Jackpot Pool.
- When a lucky player hits the jackpot, the server celebrates with broadcast announcements, particle effects, and customizable jackpot payouts.
? 4. Interactive Crate Missions & Milestones
- Daily and weekly opening quests (e.g., "Open 5 Starter Crates" or "Fuse 3 Rare Shards").
- Players track their progress through clean progress bars in the GUI (
/tcrates missions) and claim exclusive rewards.
? 5. Offline & Overflow Mailbox
- Players will never lose crate rewards due to a full inventory or sudden disconnects.
- Undelivered items are automatically routed to their personal secure Virtual Mailbox (
/tcrates mailbox), accessible anytime.
?️ 6. Instant Left-Click Rewards Preview
- Players can Left-Click any physical crate block in the world to open an interactive, multi-page rewards preview showing item lore, rarity tiers, and exact win percentages.
- Right-Click consumes a key and launches the opening animation.
? 7. Monte Carlo Simulation Engine (For Admins)
⚡ 8. Modern Visuals & Zero-Lag Architecture
- MiniMessage Gradients: Crisp, high-contrast, modern gradient typography with zero unwanted vanilla italics.
- Asynchronous Database: Powered by HikariCP with non-blocking SQLite and MySQL support.
- Featherweight Footprint: Ultra-optimized JAR (< 550 KB) without unneeded shaded dependencies.
? How to Setup in 60 Seconds
- Drop into
plugins/ and start your Paper 1.21+ server.
- Place any block in the world (e.g., Ender Chest, Chest, or Beacon).
- Look directly at the block and register it as a crate:
/tcrates create starter
- Give yourself a key to test:
/tcrates key starter
- Left-Click the crate to preview rewards, or Right-Click with the key to open!
? Commands Reference
| Command |
Permission |
Description |
/tcrates preview <crate> |
tcrates.player |
Opens the rewards preview GUI. |
/tcrates open <crate> |
tcrates.player |
Virtually opens a crate using available keys. |
/tcrates bulkopen <crate> <amount> |
tcrates.player |
Bulk opens multiple crates in a single instant click. |
/tcrates shards |
tcrates.player |
Opens the Shard Alchemy & Fusion GUI. |
/tcrates missions |
tcrates.player |
Opens the Crate Missions & Milestones menu. |
/tcrates jackpot |
tcrates.player |
Displays the current server jackpot pool & history. |
/tcrates mailbox |
tcrates.player |
Opens your pending reward mailbox. |
/tcrates pity [crate] |
tcrates.player |
Checks current rolls until guaranteed pity reward. |
/tcrates collection [crate] |
tcrates.player |
Opens your unlocked rewards collector album. |
/tcrates history |
tcrates.player |
Displays your personal opening history log. |
/tcrates create <crate> |
tcrates.admin |
Links the targeted block to a crate. |
/tcrates remove |
tcrates.admin |
Unregisters the targeted physical crate block. |
/tcrates givekey <player> <crate> [qty] [phys/virt] |
tcrates.admin |
Gives physical or virtual keys to a player. |
/tcrates luck boost <player> <multiplier> <seconds> |
tcrates.admin |
Grants a temporary luck multiplier to a player. |
/tcrates simulate <crate> <iterations> |
tcrates.admin |
Runs a Monte Carlo economic balance simulation. |
/tcrates backup |
tcrates.admin |
Creates an instant hot-backup of the database. |
/tcrates reload |
tcrates.admin |
Hot-reloads all configs, crates, and rarities. |
? Permissions
tcrates.player — Grants access to all core player commands, GUIs, and crate interactions (Default: true).
tcrates.admin — Grants full administrative access to creation, editing, simulation, key giving, and reloads (Default: op).
? PlaceholderAPI Placeholders
| Placeholder |
Description |
%tcrates_keys_<crate>% |
Total keys (virtual + inventory) for a crate. |
%tcrates_virtual_keys_<crate>% |
Virtual keys stored in player account. |
%tcrates_pity_<crate>% |
Current rolls accumulated towards pity. |
%tcrates_jackpot% |
Current progressive jackpot pool amount. |
%tcrates_shards_<tier>% |
Player balance for a specific shard tier. |
%tcrates_opened_total% |
Total lifetime crates opened by the player. |
%tcrates_luck_multiplier% |
Active temporary luck multiplier (e.g. 1.5x). |
⚙️ Configuration Preview
Crates are cleanly defined in plugins/TCrates/crates/*.yml. Adding rewards and configuring pity is dead simple:
id: "starter"
name: "<gradient:#55ffff:#00aaff><bold>STARTER CRATE</bold></gradient>"
description: "A well-balanced starter crate for new adventurers."
key:
name: "<aqua><bold>Starter Key</bold></aqua>"
material: "TRIPWIRE_HOOK"
glowing: true
pity:
enabled: true
threshold: 15
guaranteed-rarity: "RARE"
rewards:
- id: "god_sword"
rarity: "LEGENDARY"
weight: 5
item:
material: "DIAMOND_SWORD"
name: "<gradient:#ffaa00:#ff5500><bold>Excalibur</bold></gradient>"
commands:
- "broadcast <gold><player></gold> found <yellow>Excalibur</yellow>!"
?️ Requirements & Compatibility
- Server Software: Paper, Purpur, or compatible forks.
- Minecraft Version: 1.21.x (Supports 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4).
- Java Version: Java 21 or higher.
- Optional Hooks: PlaceholderAPI, Vault (for economy/currency duplicate conversions).
评论 0
登录后参与评分
还没有评论,来抢沙发吧