ABestCrates
ABestCrates 是一款面向 Paper 服务器的现代化、以 GUI 为核心的箱子插件。它允许服务器管理员直接在游戏内创建和管理箱子、钥匙、奖励、概率、动画、全息显示和消息,而无需手动编辑配置文件。
功能特性
- 完全可配置的箱子,通过游戏内 GUI 进行管理
- 支持实体钥匙、虚拟钥匙以及可放置的箱子物品
- 在箱子全息显示下方显示每个玩家的虚拟钥匙计数器
- 完整支持 Nexo、ItemsAdder、Oraxen、ExecutableItems、MMOItems 及类似插件的 ItemStack 元数据
- 物品组合包(最多 27 个物品)、无限命令或混合奖励
- GAMBLE(赌博)箱子带有加权抽取,CHOOSE(选择)箱子提供可选奖励
- 每个箱子拥有自定义的预览和开启标题
- 提供 Roll/CSGO、Casino、Cosmic、Roulette、Wheel、Wonder、经典、快速和即时等多种动画效果
- 渐进式 Roll 减速、可配置音效,每次开启最多展示 9 个动画奖励
- 居中的分页预览界面,包含“打开”和“全部打开”按钮
- 分页的箱子/奖励菜单,支持拖拽或 Shift+点击编辑奖励物品
- 在已放置的箱子上方显示名称全息图
- 环形、螺旋形、螺旋线(Helix)和戴森球粒子效果
- 自定义箱子方块材质
- 箱子颜色预设
- 支持 Shift+左键点击批量开启
- 右键预览,左键开启
- 已放置的箱子受到保护,防止被破坏和爆炸伤害
- 稀有奖励广播提示
- 烟花特效
- 里程碑、全局/玩家专属奖励限制以及专用的奖励日志
- 每个箱子支持独立的冷却时间、Vault 开启费用、权限要求、多重钥匙需求以及击退效果
- 每个奖励支持必需的权限和禁止的权限
- PlaceholderAPI 占位符支持
- 自定义消息
- 命令、玩家、箱子和钥匙数量的 Tab 补全
箱子编辑
管理员可以通过 GUI 配置箱子:
- 显示名称
- 技术用箱子名称
- 箱子颜色
- 方块类型
- 全息显示行内容
- 奖励列表
- 钥匙物品
- 无钥匙时的提示信息
- 开启动画
- 奖励预览
- GAMBLE/CHOOSE 类型
- 粒子效果和虚拟钥匙显示设置
- 权限、冷却时间、Vault 费用和击退设置
- 多重钥匙需求
- 预览/开启 GUI 标题
- 里程碑
- 可放置的箱子物品
可以通过手持物品并点击目标槽位,或将物品拖入 GUI 来分配物品。自定义钥匙物品会复制原始物品的属性,但仅替换钥匙名称。
奖励
每个奖励可以设置:
- 自定义显示物品
- 掉落物品
- 执行的命令
- 真实概率
- 显示概率
- 稀有度文本
- 广播开关
- 烟花开关
- 权重和稀有度倍率
- 最多 27 个奖励物品
- 无限数量的命令
- 必需/禁止的权限
- 全局/玩家专属限制
这使得对外显示的 odds 可以与内部真实的抽取概率分开显示。
命令
主命令:
/abestcrates
别名:
/abc
/acrates
管理员命令:
/abc gui
/abc reload
/abc create <name>
/abc delete <name>
/abc deletecrate
/abc spawncrate <name>
/abc edit <name>
/abc givekey <player> <crate> <amount>
/abc giveall <crate> <amount> [physical|virtual]
/abc givecrate <player> <crate> <amount>
/abc addkeys <player> <crate> <amount>
/abc removekeys <player> <crate> <amount>
/abc forceopen <player> <crate>
权限
abestcrates.admin
abestcrates.use
abestcrates.open
abestcrates.create
abestcrates.givekey
abestcrates.reload
玩家需要 abestcrates.use 权限才能开启箱子。
玩家交互
- 右键点击已放置的箱子以预览奖励
- 左键点击已放置的箱子以开启它
- Shift+左键点击已放置的箱子以开启所有匹配的钥匙
赠送钥匙 菜单无需使用命令即可完成整个物理/虚拟钥匙的工作流程:选择钥匙类型、箱子、在线玩家,并在聊天栏中输入数量。
集成
- Vault 是可选的,仅在箱子需要开启费用时才需要。
- PlaceholderAPI 是可选的。可用的占位符包括
%abestcrates_virtual_<crate>%、%abestcrates_physical_<crate>%、%abestcrates_total_<crate>%和%abestcrates_opened_<crate>%。 - 自定义物品插件通过完整的 Bukkit
ItemStack元数据克隆和序列化来实现兼容。
兼容性
ABestCrates 需要 Java 21 和以下版本的 Paper:
- 26.x
- 1.21.x
许可证
GPL 3.0
ABestCrates
ABestCrates is a modern, GUI-first crates plugin for Paper servers. It lets server owners create and manage crates, keys, rewards, chances, animations, holograms, and messages directly in-game without manually editing configuration files.
Features
- Fully configurable crates managed from an in-game GUI
- Physical keys, virtual keys, and placeable crate items
- Per-player virtual key counter below crate holograms
- Full ItemStack metadata support for Nexo, ItemsAdder, Oraxen, ExecutableItems, MMOItems, and similar plugins
- Item bundles (up to 27 items), unlimited commands, or mixed rewards
- GAMBLE crates with weighted rolls and CHOOSE crates with selectable rewards
- Custom preview and opening titles per crate
- Roll/CSGO, Casino, Cosmic, Roulette, Wheel, Wonder, classic, fast, and instant animations
- Progressive Roll slowdown, configurable sounds, and up to 9 animated rewards per opening
- Centered paginated previews with Open and Open All buttons
- Paginated crate/reward menus and drag-or-shift-click reward item editing
- Display-name holograms above placed crates
- Ring, spiral, helix, and Dyson Sphere particle effects
- Custom crate block material
- Crate color presets
- Bulk opening with shift-left click
- Right-click preview and left-click opening
- Protected placed crates against breaking and explosions
- Rare reward broadcasts
- Firework effects
- Milestones, global/per-player reward limits, and dedicated reward logs
- Per-crate cooldown, Vault opening cost, permission, multiple key requirements, and pushback
- Required and blocked permissions per reward
- PlaceholderAPI placeholders
- Custom messages
- Tab completion for commands, players, crates, and key amounts
Crate Editing
Administrators can configure crates from the GUI:
- Display name
- Technical crate name
- Crate color
- Block type
- Hologram lines
- Rewards
- Key item
- No-key message
- Opening animation
- Reward preview
- GAMBLE/CHOOSE type
- Particle effect and virtual key display
- Permission, cooldown, Vault cost, and pushback
- Multiple key requirements
- Preview/opening GUI titles
- Milestones
- Placeable crate items
Items can be assigned by holding them in hand, clicking the target slot, or dragging an item into the GUI. Custom key items copy the original item attributes while replacing only the key name.
Rewards
Each reward can have:
- Custom display item
- Dropped item
- Commands
- Real chance
- Display chance
- Rarity text
- Broadcast toggle
- Firework toggle
- Weight and rarity multiplier
- Up to 27 reward items
- Unlimited commands
- Required/blocked permissions
- Global/per-player limits
This allows public-facing odds to be shown separately from the real internal roll chance.
Commands
Main command:
/abestcrates
Aliases:
/abc
/acrates
Admin commands:
/abc gui
/abc reload
/abc create <name>
/abc delete <name>
/abc deletecrate
/abc spawncrate <name>
/abc edit <name>
/abc givekey <player> <crate> <amount>
/abc giveall <crate> <amount> [physical|virtual]
/abc givecrate <player> <crate> <amount>
/abc addkeys <player> <crate> <amount>
/abc removekeys <player> <crate> <amount>
/abc forceopen <player> <crate>
Permissions
abestcrates.admin
abestcrates.use
abestcrates.open
abestcrates.create
abestcrates.givekey
abestcrates.reload
Players need abestcrates.use to open crates.
Player Interaction
- Right-click a placed crate to preview rewards
- Left-click a placed crate to open it
- Shift-left-click a placed crate to open all matching keys
The Give Keys To menu performs the entire physical/virtual key workflow without a command: select the key type, crate, online player, and enter the amount in chat.
Integrations
- Vault is optional and is required only for crates with an opening cost.
- PlaceholderAPI is optional. Available placeholders are
%abestcrates_virtual_<crate>%,%abestcrates_physical_<crate>%,%abestcrates_total_<crate>%, and%abestcrates_opened_<crate>%. - Custom item plugins work through complete Bukkit
ItemStackmetadata cloning and serialization.
Compatibility
ABestCrates requires Java 21 and Paper version:
- 26.x
- 1.21.x
License
GPL 3.0
下载 A Best Crates
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 A Best Crates
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 A Best Crates
下载 A Best Crates
下载 A Best Crates
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 A Best Crates
下载 A Best Crates
下载 A Best Crates
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 A Best Crates
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 A Best Crates
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
ABestCrates 1.2.4
现在支持通过 Discord Webhook 为单个箱子奖励发送公告。
新增
- 每个奖励的编辑器菜单中增加了 在 Discord Webhook 中广播 开关,独立于游戏内的“广播”设置。
- 可在
config.yml中配置 Webhook URL、嵌入标题、描述以及可选的玩家头像缩略图。 - 标题和描述中均支持
%player%、%item%、%crate%和%chance%占位符。%chance%使用奖励的显示概率;请在模板中添加百分号。 - 常规开启、批量开启、CHOOSE(选择)箱子和里程碑奖励的公告均可发送至 Discord。
- 复制箱子或导入/导出模板时,Discord 公告设置将被保留。现有奖励默认禁用公告功能。
更改
- Webhook 请求在服务端线程之外运行,采用有界队列并限制重试次数以应对 Discord 的频率限制。
- Webhook 发送失败时会记录日志,但不会暴露 Webhook Token,且不影响奖励发放。
- 现有配置会自动获取新的 Webhook 设置。请使用
/abc reload应用配置更改。
配置
设置 Webhook URL,然后为你希望发送公告的奖励启用 在 Discord Webhook 中广播。
discord-webhook:
url: ''
show-player-head: true
title: '玩家掉落了稀有物品!'
description: '玩家 %player% 从 %crate% 中以 %chance% 的概率获得了 %item%!'
添加对 26.1 版本的支持
ABestCrates 1.2.2
版本 1.2.2 为 Paper 1.20.x 分支添加了管理员维护工具、箱子模板、配置版本控制、统计 GUI 改进以及发布优化。
新增
- 用于重置玩家冷却时间、已开启次数统计、玩家奖励计数器和全局奖励计数器的管理员命令与 GUI 工具。
- 管理员工具统计 GUI,可查看玩家的箱子历史、打开过指定箱子的玩家、玩家总数以及被打开次数最多的箱子。
- 支持通过
/abc duplicate <crate> <newName>复制箱子。 - 支持通过
/abc export <crate> [file]和/abc import <file> [newName]导出/导入箱子模板。 - 模板文件存储在
plugins/ABestCrates/templates目录下。 - 生成的配置文件包含
config-version: 2标记。 - 集成 bStats,由
config.yml中的metrics.enabled和metrics.plugin-id控制。 - 在玩家统计和发放钥匙的 GUI 流程中增加昵称查找功能。
- 增加了针对箱子 ID、安全值钳制、奖励设置以及零概率奖励抽取的单元测试覆盖。
更改
- 聊天提示、命令帮助、受保护箱子、管理员及模板相关的消息现在统一存放在
messages.yml中。 - 玩家开启数据现存储最后已知的玩家名称,以便于离线状态下查询统计信息。
修复
- 加载箱子文件前会对现代 Paper 序列化的
ItemStack字段进行规范化处理,以避免出现Material cannot be null(材质不能为空)的启动错误。 - 现有的内置配置文件不再在启动时重新复制,从而消除了令人困扰的“文件已存在”警告。
要求
- Paper 1.20.1-1.20.6。
- Paper 1.20.1-1.20.4 需要 Java 17。
- Paper 1.20.5-1.20.6 和 1.21.x 需要 Java 21。
- Vault 和 PlaceholderAPI 仍为可选依赖。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧