SpinCrates

SpinCrate

一个完全自包含的宝箱/战利品箱系统，专为服务器管理员设计——一切都可以在游戏内或内置的本地网页面板中配置，无需任何外部工具。

SpinCrate 能将任何原版箱子变成战利品箱：玩家使用钥匙启动老虎机式轮盘，赢取随机选择的奖励，奖励的权重由管理员配置的稀有度等级决定。它的每一个部分——稀有度、奖励、钥匙、冷却时间、音效、特效——都可以针对每个箱子独立配置，并且能容纳任何东西：原版物品、其他已安装模组的物品、完整保留 NBT 的物品（例如，通过可选的 Cobblemon 集成捕获的宝可梦），甚至是服务器命令。

开启宝箱

• 实体钥匙 —— 一种自定义物品，每种宝箱对应一种，必须握在主手中才能开启。万能钥匙可以开启任何宝箱；“作弊”钥匙保证在指定稀有度范围内获得结果。
• 虚拟钥匙 —— 每个玩家对每种宝箱各有一个余额，与实体钥匙共存。可以将实体钥匙存入虚拟余额，也可以取回，或者直接用 Shift + 右键 开启宝箱。没有实体钥匙时普通右键点击不会消耗任何东西——只会显示概率和奖励的预览。
• 预览界面 —— 没有钥匙（或处于冷却中）的玩家仍然可以看到奖池中的具体内容和每个物品的真实掉落概率。

稀有度与奖励

• 每个宝箱最多可有 9 个稀有度等级，每个等级拥有独立可配置的权重（可精确到百分比的小数）和专属颜色。
• 任何物品都可以作为简单的 物品 + 数量 添加，或者作为完整解析的 NBT 物品（通过游戏内 GUI 构建）添加，以保留附魔、自定义数据，或一只完整的被捕获宝可梦。
• 命令型奖励（以任何服务器/控制台命令作为奖品——经济发放、自定义效果、任何内容）。
• 支持“空结果”结果，因此一个稀有度区块可以代表空奖励而不会影响其他概率的计算。
• 当有玩家获得足够稀有的奖励时，会向全服务器广播消息。

气氛效果

• 绑定的箱子周围持续播放环境粒子，提供多种图案（光环、火焰、喷泉、火花、光束、双螺旋、漩涡、螺旋），每种宝箱都可独立配置。
• 一个隐藏光源让宝箱始终可见，同时避免粒子泛滥。
• 一个漂浮的全息文字显示宝箱的名称。
• 可配置的揭晓音效，根据获奖的稀有度分级。

玩家限制与经济

• 可选的每玩家开启冷却时间（“每 M 分钟开启 N 次”）。
• 可选的定期赠送：按设定间隔自动向所有已知玩家发放虚拟钥匙。
• 完整的开启历史和排行榜：“运气指数”（根据每次结果的惊讶程度加权，而不仅仅是你最好的那次）、最活跃玩家，以及每个宝箱的顶级玩家。

管理员工具

以上所有内容都可以通过两种方式进行配置：

1. 游戏内：完整的命令集（/crates admin ...）加上一个双箱子风格的 GUI 用于构建奖励池。
2. 内置本地网页面板 —— 这是最突出的功能。SpinCrate 运行自己的轻量级网页服务器（仅回环地址，不向主机外部暴露任何内容），无需任何设置，也不需要外部托管：
   • 一个仪表板，一眼查看所有宝箱（稀有度数量、总权重、物品数量、冷却/赠送状态）。
   • 一个完整的宝箱编辑器，带实时物品搜索（按 ID 或 翻译名称，覆盖所有已安装模组），显示真实的物品图标，以及一个可搜索的音效选择器。
   • 一个“全局设置”面板，可以一次性将某个设置（特效、音效、冷却时间）推送到所有宝箱，无需逐一修改。
   • 虚拟钥匙管理：查看每个玩家的总余额，深入查看任何玩家的每种宝箱余额并直接编辑。
   • 一个统计仪表板：全局排行榜以及每个玩家的细分数据（总开启次数、运气指数、每种宝箱的计数、分页的开启历史）。
   • 所有更改即时生效——无需重载，无需重启。

为应对崩溃而生

• 奖励在老虎机动画开始前 就已 掷出并安全写入磁盘。服务器崩溃、旋转中掉线或重启永远不会丢失或重复奖励——玩家重新上线的那一刻就会收到。
• 已绑定的箱子（及其标记/光源）在链接状态下无法被玩家破坏，防止活跃宝箱被意外破坏。