CrazyCrates 抽奖箱插件

CrazyCrates 抽奖箱插件

> 服务端最经典的抽奖箱系统：把奖励装进箱子里，用钥匙开启，权重决定稀有度，附带十多种箱型与开奖动画。
基本信息

| 项目 | 信息 |
| --- | --- |
| 插件名称 | CrazyCrates |
| 开发者 | Crazy Crew |
| 最新版本 | 5.2.0（2026-07-18，面向 26.1.2 – 26.2）|
| 许可协议 | MIT |
| 兼容版本 | 最新构建 26.1.2 – 26.2；1.21.x 等旧版本请选对应旧构建（项目最老支持到 1.8.8）|
| 运行平台 | Paper、Purpur、Folia（及其分支）|
| 运行环境 | Paper 26.x 及以上 + Java 25 |
| 前置依赖 | 无 |
| 项目地址 | https://modrinth.com/plugin/crazycrates |
| 官方文档 | https://docs.crazycrew.us/mods/crazycrates/ |
简介

CrazyCrates 把"抽奖"做成了一套完整系统：管理员把奖励（物品、命令、消息等）配置进箱子，玩家用实体钥匙或虚拟钥匙开启，奖励按权重抽取稀有度，还支持备选奖励。目前提供十多种箱型（转盘、CSGO 开箱、轮盘、Cosmic、Wonder、Warcrate、QuickCrate 等），每种都有自己的表现方式，是抽奖、活动奖励、赞助回馈这类玩法的常用组件。

配置都在服务端的 crates 文件夹里，每个箱子一个文件，支持 MiniMessage 格式；奖励可以广播、可以设置重抽（带权限次数上限，且可跨重启保留），钥匙的发放与回收支持玩家离线时操作，所有开箱与钥匙变动都会记录日志，方便排查纠纷。注意当前版本要求 Paper 26.x + Java 25，服务端版本较老时要挑对应的旧构建。
核心特性
权重抽奖：按权重决定奖励稀有度，支持设置备选奖励
十多种箱型：转盘、CSGO、轮盘、Cosmic、Wonder、Warcrate、QuickCrate 等，各有专属表现
虚拟与实体钥匙：两种钥匙形式可混用，支持给离线玩家发放或回收
奖励可重抽：按权限限制重抽次数，并可选择跨重启保留
音效与广播：可使用自定义音效（含材质包音效），支持开奖广播
高度可配置：从箱体外观到奖励内容均可改，支持 MiniMessage 格式
全程留痕：所有开箱与钥匙操作都会记录日志
调试命令：/crazycrates debug 可快速测试奖励配置是否正常
环境要求

| 项目 | 要求 |
| --- | --- |
| 服务端 | Paper、Purpur、Folia 及其分支（官方要求至少 Paper）|
| Minecraft | 最新构建 26.1.2 – 26.2；旧版本服务端需选对应旧构建 |
| Java 版本 | Java 25（当前版本硬性要求）|
| 前置依赖 | 无 |
| 配置文件 | 生成在服务端 plugins/CrazyCrates/ 下的 crates 文件夹 |
安装方法
确认服务端为 Paper 26.x 及以上、且运行在 Java 25
从 Modrinth 下载对应版本的 jar
放入服务端 plugins/ 目录并重启
在生成的 crates 文件夹里新建箱子配置文件，可参考目录中已有的示例文件
用 /crazycrates debug 测试奖励是否能正常抽出
放置箱子并配置钥匙获取方式（命令、商店或其它插件联动）
使用提示
服务端版本对不上时游戏内会报错，先在 Modrinth 版本列表里挑对应 MC 版本的构建（旧版本用 4.x、5.0 等）
Java 25 是硬要求，JDK 版本不够会直接启动失败，这是最常见的坑
奖励里的物品与命令建议先用 debug 跑一遍，避免正式开奖时发错东西
重抽功能记得配合权限上限使用，否则容易变成刷奖励
钥匙的发放与回收支持离线玩家，做活动补偿时不用等人上线
出问题优先查官方文档与 Discord，配置文件写法在文档里都有示例
相关链接
Modrinth 项目页：https://modrinth.com/plugin/crazycrates
官方文档（配置与命令）：https://docs.crazycrew.us/mods/crazycrates/
源码仓库：https://github.com/Crazy-Crew/CrazyCrates
最新构建（CI）：https://ci.crazycrew.us/job/CrazyCrates/
Discord 社区：https://discord.gg/badbones-s-live-chat-182615261403283459