SchackCrates

插件

· 作者 Schack0

带有完整游戏内 GUI 编辑器的动态宝箱:12 种动画(包括 3D)、箱子对战、保底机制、奖励上限、统计信息以及 PlaceholderAPI 支持。

0 本站下载 0 关注 更新于 3 天前

最新 1.3.0 · 26.3 · Paper / Purpur

一键开服(送7天)

SchackCrates

适用于 Paper 服务器的动画宝箱,无需离开游戏即可设置。

你只需创建一个宝箱,在背包中点击物品以添加为奖励,选择一种动画效果,然后将宝箱放置在你想要的任何位置。如果你不想操作 YAML 文件,完全可以做到。当然,如果你喜欢配置文件,所有内容依然清晰排列并带有注释。

除了普通宝箱外,还有宝箱对战(Case Battles)。2 到 4 名玩家同时开启相同的宝箱,总价值最高者赢得所有奖励。

功能

  • 12 种开箱动画:6 种在 GUI 界面中,5 种在宝箱上方的 3D 空间,以及一种即时选项
  • 所有内容均可在游戏中编辑:宝箱、奖励、概率、稀有度、钥匙、全息图、粒子、事件和全局设置
  • 支持 2-4 人的宝箱对战,设有大厅、实时滚轮和共享奖池
  • 限时活动(如 Happy Hour),可暂时提高稀有奖励的掉落率,通过命令或定时任务启动,并显示 Boss 条
  • 季节性宝箱,仅在指定日期开启,例如每年 12 月的圣诞宝箱
  • 获奖展示:最后一次大奖会在宝箱上方旋转播放,并显示获胜者名字
  • 钥匙赠送功能,玩家可通过 /keys gift 将虚拟钥匙送给朋友,即使对方离线也可行
  • 开启要求:经验等级、在线时长、已开启宝箱数、权限或任意 PlaceholderAPI 值
  • 保底系统:经过 X 次未获得理想奖励后,玩家必定获得指定稀有度的奖励
  • 全服奖励上限(例如,服务器内最多只能赢得 5 个信标)
  • 自定义纹理:ItemsAdder、Oraxen 和 Nexo 的物品可作为奖励和钥匙使用
  • 统计与历史记录:个人与全服统计数据、近期获奖记录、排行榜,以及实际概率与配置概率的对比
  • 内置全息图和闲置粒子效果,使用显示实体(display entities),无需额外安装全息图插件
  • 虚拟钥匙与物理钥匙。虚拟钥匙可发送给离线玩家,非常适合商店和投票系统
  • 批量开启:Shift + 右键点击宝箱,可选择一次性开启的数量(最多 10 个)
  • 提供 37 个 PlaceholderAPI 占位符(PAPI 为可选依赖)
  • 默认支持英文和波兰语。翻译简便,语言文件更新不会覆盖你的修改
  • 玩家永远不会丢失奖励。奖励在动画开始前就已确定,因此退出、关闭 GUI、重载或重启都不会导致奖励丢失

动画

动画 类型 描述
Roulette GUI 经典的 CS:GO 式物品滚动条,指针下停并减速停止
Wheel GUI 发光的选择器围绕一圈物品旋转
Shuffle GUI 中间槽位循环切换奖励,边框闪烁
Cascade GUI 物品蛇形滑入中心位置
Choice GUI 玩家从几个隐藏奖励中选择一个
Slots GUI 三轴老虎机,逐个停止
Spin 3D 物品从宝箱中升起,旋转展示可能的奖励
Orbit 3D 奖励环绕宝箱上方旋转,最终撞击合并成获胜奖励
Meteor 3D 陨石撞击宝箱,奖励从冲击点浮现
Vortex 3D 物品像龙卷风一样向上旋转,随后坍缩为奖励
Carousel 3D 幸运转盘出现在宝箱上方,面向玩家
Instant none 直接给予奖励,无动画效果

你可以在 animations.yml 中调整每种动画的速度、声音、颜色和大小。

游戏内编辑器

运行 /crates editor,所有设置一目了然。

奖励。 点击背包中的任意物品即可添加。你可以设置其权重、稀有度、数量、名称和描述,添加额外物品、控制台命令、消息或广播,设定价值,并设置全局上限。

宝箱。 显示名称、动画(有预览按钮可先查看)、钥匙物品、全息图文本、粒子及其图案、冷却时间、权限、开启要求、季节限制、获奖展示、批量开启和预览菜单。

事件。 创建自定义事件,设置其对稀有奖励的提升幅度及适用宝箱,安排时间表,或直接通过点击开始/停止。

位置。 使用 /crates set <crate> 或可放置的宝箱方块来放置宝箱。你也可以在此处传送至已保存的位置或删除它们。

全局设置。 语言、钥匙规则、广播、全息图、粒子及其他少量设置。

更改立即保存,无需重载。所有文本均支持 MiniMessage(渐变、十六进制颜色)以及传统的 & 代码。

宝箱对战

对战流程如下:

  1. 某人运行 /battle 并设置对战:选择哪些宝箱作为回合、玩家人数(2-4 人),以及是否公开。
  2. 每位玩家放入相同数量的钥匙,插件会保管这些钥匙直到对战结束。公开对战会在聊天中发布带可点击 [JOIN] 按钮的公告。
  3. 大厅满员后,所有玩家在共享 GUI 中同时开启相同的宝箱。每位玩家拥有独立的滚轮,依次停止。
  4. 总价值最高者赢得所有玩家的奖励。若出现平局,则通过抛硬币决定胜负。

如果对战被取消,所有玩家将收回自己的钥匙。玩家可以在对战中途离开而不损失任何东西;如果某个奖励无法放入某玩家的背包,它将被存入他们的储物柜(/crates claim)。奖励的价值默认由其稀有度决定,但你也可以为每个奖励手动设定价值。

事件

在活动进行期间,选定稀有度或更高的奖励掉落几率会增加。例如,史诗级及以上奖励在一小时内掉落几率翻倍。Happy Hour 随插件自带,你也可以通过 /crates editor → Events 或 events.yml 创建任意数量的自定义事件:

events:
  happyhour:
    display-name: "<gradient:#ff9a00:#ff3d77><bold>Happy Hour</bold></gradient>"
    multiplier: 2.0        # 2 = 概率翻倍
    min-rarity: epic       # 稀有度达到此等级或更高时获得加成
    crates: []             # 空列表 = 所有箱子
    schedule:              # 可选,事件自动开始的时间表
      - "SATURDAY 18:00-20:00"
      - "FRIDAY 22:00-02:00"
    default-duration: 1h
    broadcast: true
    bossbar:
      enabled: true
      color: PINK

你也可以随时通过 /crates event start happyhour 2h 手动启动一个事件。玩家会在 Boss 栏中看到事件信息及剩余时间,箱子的预览界面也会显示加成后的概率。Happy Hour 默认没有时间表,因此除非你为其配置了时间表,否则它不会自动启动。

季节性箱子

你可以设置箱子仅在特定日期开放,例如每年 12 月 20 日至 1 月 6 日的圣诞节箱子。你可以在编辑器或箱子配置文件中设置:

season:
  enabled: true
  from: "12-20"         # 每年有效;"2026-12-20" 仅生效一次;"12-20 18:00" 可设定具体小时
  to: "01-06"           # 若未指定时间,则包含整天;时间段可以跨年度
  hide-outside: true    # 关闭期间不显示全息图和粒子效果
  broadcast: true       # 在聊天中公告开始和结束

在非赛季期间,任何人都无法打开该箱子或在开箱对战中使用它,但玩家会保留他们的钥匙。预览界面和 /keys 命令会显示开始或结束时间,而 %season% 变量会在全息图中添加倒计时。日期遵循服务器的时区,除非你在 config.yml 中设置了 seasons.timezone。

获奖者展示

在编辑器中为任意箱子启用此功能。选定稀有度(例如史诗或更高)的最后一次奖励会旋转展示在箱子上方,同时显示获奖者的名字以及他们获奖距今的时间。无论是否开启箱子的全息图,此功能均可正常工作。

钥匙赠送

/keys gift <player> <crate> [amount] 会将部分你的虚拟钥匙发送给其他玩家。接收者无需在线,他们在下次加入服务器时会收到一条消息。你可以在 config.yml 的 gifts 部分禁用赠送功能或阻止特定箱子的赠送。

开启要求

可在编辑器或箱子配置文件中设置。玩家必须满足所有条件才能开箱(在使用钥匙前进行检查,包括创建或加入开箱对战时),预览界面会显示尚未满足的要求。

requirements:
  - "level: 10"
  - "playtime: 2h"
  - "opened: common 50"                    # 通过开启其他箱子来解锁当前箱子
  - "permission: group.vip | VIP rank"     # | 后面的文本是玩家看到的内容
  - "placeholder: %vault_eco_balance% >= 1000 | 账户余额至少 1000 金币"

保底、限制与统计

保底(Pity) 是针对每个箱子设置的。例如,你可以设置连续 30 次非酋抽奖必定获得史诗或更高稀有度的奖励。玩家可以在预览界面和 /keys 中查看自己距离保底还有多远。

全局限制(Global limits) 类似于库存机制。一旦某个奖励被抽中的次数达到其设定的上限,它将从箱子中移除并显示为“已售罄”。

统计数据(Stats) 可通过 /crates stats、/crates history 和 /crates top(最多开启的箱子和最多赢得的对战)查看。每个箱子也有独立的奖励统计,你可以查看实际掉落频率与你配置的百分比之间的对比。

自定义纹理

手持 ItemsAdder、Oraxen 或 Nexo 的物品,并在编辑器中像添加其他物品一样将其添加为奖励或钥匙。箱子会保留对该物品的引用,因此如果你在该插件中更改了物品,你的箱子也会同步更新。你也可以手动编写代码:

display-item:
  custom: "itemsadder:my_items:ruby"   # 或者 "oraxen:ruby", "nexo:ruby"
  amount: 3

如果无法创建此类物品(插件缺失或仍在加载中),则该奖励无法被抽取,控制台会告知原因。如果没有这些插件,你仍然可以使用 custom-model-data 和 item-model(Minecraft 1.21.2+)来实现资源包纹理。

命令

命令 描述
/crates editor [crate] 打开编辑器
/crates give <player|*> <crate> [amount] [virtual|physical] 给予钥匙
/crates take <player> <crate> [amount] 扣除虚拟钥匙
/crates set <crate> / /crates remove 将你看准的方块变成箱子,或删除它
/crates placer <crate> 获取一个可放置的箱子方块
/crates open <crate> [player] 免费开启一个箱子
/crates create <id> / /crates delete <id> 创建或删除箱子
/crates resetpity <player> <crate> 重置某人的保底计数器
/crates resetlimit <crate> <reward> 重置有限制奖励的已抽取次数
/crates event <list|start|stop> [event] [time] 管理事件
/crates language <code> 更改语言
/crates version 检查更新
/crates reload 重新加载所有文件
/crates preview <crate> 预览奖励
/keys 查看你的钥匙
/keys gift <player> <crate> [amount] 将你的虚拟钥匙赠送给其他玩家
/crates stats [player], /crates history [player|server], /crates top 统计数据
/crates claim 领取你的奖励
/battle 开箱对战大厅 (create, join <id>, leave, spectate <id>, invite <player>)

权限

权限 默认值 描述
schackcrates.admin op 编辑器及所有管理员命令(包含以下所有权限)
schackcrates.use everyone 开启宝箱
schackcrates.preview everyone 预览奖励
schackcrates.keys everyone 使用 /keys
schackcrates.gift everyone 使用 /keys gift
schackcrates.stats everyone 查看自己的统计信息、历史记录和排行榜
schackcrates.stats.others op 查看其他玩家的统计信息
schackcrates.battle everyone 创建、加入并观看宝箱对战
schackcrates.bypass.cooldown op 跳过宝箱冷却时间
schackcrates.bypass.requirements op 跳过宝箱要求
schackcrates.update op 更新通知和 /crates version

你也可以为每个宝箱设置独立的所需权限。

PlaceholderAPI

所有占位符均以 %schackcrates_ 开头。其中一些包括:

keys_<crate>、opened_total、pity_left_<crate>、cooldown_<crate>、last_win、rank、top_<n>_name、battles_won、limit_<crate>_<reward>、server_opened_total

用于赛季和活动:season_<crate>、season_open_<crate>、season_left_<crate>、season_seconds_<crate>、event、event_left、event_count、event_active_<event>、event_left_<event>

快速上手

  1. 将 jar 文件放入你的 plugins 文件夹并启动服务器。系统会自动为你创建两个示例宝箱。
  2. 看向任意方块,然后输入 /crates set common。
  3. 通过 /crates give <your name> common 5 给自己几把钥匙。
  4. 右键点击宝箱以开启它,左键点击查看内部内容,或按住 Shift + 右键点击以选择一次性开启的数量(最多 10 个)。
  5. 打开 /crates editor 并开始修改配置以适配你的服务器。

依赖要求

  • Paper 或其分支(如 Purpur),Minecraft 1.21.1
  • Java 21 或更高版本
  • 可选:PlaceholderAPI 用于占位符,ItemsAdder、Oraxen 或 Nexo 用于自定义物品

Spigot 无法运行,因为该插件依赖于 Paper 的 API。

其他信息

默认情况下,所有数据都以 YAML 格式保存在插件的 data/ 文件夹中。你可以在 config.yml 中切换至 MySQL 或 MariaDB,并且多个服务器可以共享同一个数据库。

插件会检查 Modrinth 上是否有新版本,并在有新版本时通知管理员。如果你不希望这样,请在 config.yml 中将 update-checker.enabled 设置为 false。

它还使用 bStats 收集匿名使用统计数据(服务器数量、版本、哪些功能被使用等)。你可以在 plugins/bStats/config.yml 中关闭所有插件的 bStats 功能。

如果你发现 bug 或有新想法,请告诉我!

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源