暗影宝箱

🌏 ShadowCrates

ShadowCrates 是一个适用于 Minecraft Fabric 服务器的完全可自定义宝箱系统。它允许服务器管理员创建、配置和管理宝箱，玩家可以使用特殊的宝箱钥匙开启它们。拥有可自定义的动画、音效和奖励！

📜 特性：

• ✅️ 完全可配置的宝箱 - 使用 JSON 格式定义宝箱，包括奖励、动画、音效、粒子效果和钥匙物品。
• ✅️ 自定义附魔与 NBT 支持 - 奖励保留所有物品属性，包括附魔、自定义模型数据和属性。
• ✅️ 可配置动画 - 为宝箱开启动画效果设置动画步数和间隔。
• ✅️ 粒子效果 - 为每个宝箱选择不同的粒子效果，打造视觉上引人注目的开启序列。
• ✅️ 基于权限的访问 - 使用 LuckPerms 或任何权限插件限制特定宝箱。
• ✅️ 命令执行 - 当玩家赢得奖励时运行自定义命令。
• ✅️ 自定义音效 - 在开启宝箱或赢得奖励时播放独特的音效。
• ✅️ 语言与消息自定义 - 编辑所有消息、GUI 标题和描述，支持完整的 RGB 颜色。
• ✅️ 宝箱位置系统 - 将宝箱分配到世界中的特定方块，允许物理宝箱位置。
• ✅️ 备份系统 – 在 /config/shadowcrates/backups/ 中自动和手动创建备份，支持 JSON 恢复。
• ✅️ 数据库支持 – 使用 SQLite 或 MySQL 存储所有宝箱数据（钥匙、奖品、宝箱方块）。包含自动迁移 + 备份。
• ✅️ 强大的 GUI 系统 – 预览宝箱、领取存储的奖品，并以完全可自定义的菜单查看虚拟钥匙。
• ✅️ 虚拟钥匙系统 – 玩家可以虚拟存储钥匙，防止复制漏洞。
• ✅️ 支持 Cobblemon 物品 – 将宝可梦物品（例如 pokemon:abra）渲染为奖品图标和 GUI 中的展示物品。

⚙️ 命令：

剧透

• /crate create <name> ➜ 创建一个新宝箱。
• /crate delete <name> ➜ 删除一个现有宝箱。
• /crate reload ➜ 重新加载所有配置文件。
• /crate set <name> ➜ 将宝箱设置在目标方块上。
• /crate unset <name> ➜ 从方块上移除宝箱。
• /crate key give <crate> <amt> <player> ➜ 给予虚拟或实体钥匙。
• /crate key storage ➜ 查看你存储的钥匙。
• /crate storage ➜ 领取存储的物品奖品。
• /crate clearstorage <player> ➜ 从存储中删除物品。
• /crate backup now ➜ 手动创建备份。
• /crate backup restore ➜ 从最新备份恢复。
• /crate key clear <player> ➜ 清除玩家的钥匙。
• /crate key count <player> <crate> ➜ 查看存储的钥匙数量。
• /crate key giveall <amount> <player> ➜ 将所有钥匙给予一名玩家。

🔒 权限：

剧透

• crate.create ➜ 用于 /crate create
• crate.delete ➜ 用于 /crate delete
• crate.reload ➜ 用于 /crate reload
• crate.set ➜ 用于 /crate set
• crate.unset ➜ 用于 /crate unset
• crate.storage ➜ 用于 /crate storage
• crate.clearstorage ➜ 用于 /crate clearstorage
• crate.key.give ➜ 用于 /crate key give
• crate.key.storage ➜ 用于 /crate key storage
• crate.key.clear ➜ 用于 /crate key clear
• crate.key.count ➜ 用于 /crate key count
• crate.key.giveall ➜ 用于 /crate key giveall
• crate.backup ➜ 用于 /crate backup now 和 /crate backup restore

🎞 动画：

开启宝箱的动画格式列表：

剧透

• default
• instant
• csgo
• slots
• vortex
• wheel
• pick
• meteor

闲置粒子的动画格式列表：

剧透

• orbit
• dual_orbit
• ring
• pulse
• spiral
• spring
• flower
• star
• rays
• rain
• stack
• sparkle
• meteor_rain
• ring_vertical
• burst
• comet

📂 配置文件：

• 📁/config/shadowcrates/config.json – 通用设置、消息和开关。

• 📁/config/shadowcrates/crates/*.json – 宝箱定义，包括物品、命令、概率和钥匙。

• 📁/config/shadowcrates/menu_preview.json – 预览 GUI 配置。

• 📁/config/shadowcrates/menu_storage.json – 宝箱奖励存储 GUI。

• 📁/config/shadowcrates/menu_key_storage.json – 虚拟钥匙存储 GUI。

• 📁/config/shadowcrates/data/ – 存储宝箱方块位置。

• 📁/config/shadowcrates/backups/ – 自动/手动备份文件夹