SpawnChestPlugin
带有自定义战利品、传奇物品、守护者以及完整可视化战利品编辑器的自动宝箱事件。
GitHub | Discord | Wiki
功能
- 自动生成宝箱,支持可配置的计时器和批量生成
- 可视化战利品编辑器 —— 直接在图形界面中拖放物品
- 三种宝箱等级,拥有不同的战利品和守护者数量
- 九件具有独特能力的传奇物品(可选)
- 开启前倒计时 —— 首次点击即开始一场奔向宝箱的竞赛
- 宝箱保护区域 —— 阻止在活跃宝箱附近破坏方块
- 四种召唤苹果类型 —— 按需强制指定特定等级
- 世界苹果掉落 —— 作为物理物品在世界中生成并显示坐标
- 保护插件集成 —— 宝箱会自动跳过已被占用的领地
- 基于权限的广播 —— 精细控制谁能看到哪些信息
- BossBar HUD —— 显示倒计时和活跃宝箱计时器
- 统计信息、成就和排行榜
- 10 种语言翻译

兼容性
| 平台 |
支持情况 |
| Spigot |
完全支持 |
| Paper |
完全支持 + 异步区块加载 |
| Purpur |
完全支持 |
| Pufferfish |
完全支持 |
| Folia |
完全支持 |
Minecraft 1.18 – 1.21.x 以及 26.1 / 26.1.1(Mojang 的新版本号)。服务器类型和版本将在启动时自动检测。

宝箱等级
| 等级 |
概率 |
守护者数量 |
守护者类型 |
| 普通 (Common) |
50% |
1 |
僵尸 |
| 稀有 (Rare) |
35% |
2 |
骷髅 |
| 传奇 (Legendary) |
15% |
3 |
凋灵骷髅 |
所有概率均可配置。守护者可以完全禁用。
生成系统
- 距 0,0 的距离:400–2000 格(可配置)
- 高度范围:Y 50–200(可配置)
- 表面排除项:阻止宝箱在水、熔岩、冰、树叶等表面上生成
- 若未被打开,30 分钟后自动消失(可配置)
- 批量生成 —— 每个间隔内生成多个宝箱,每次之间有延迟
settings:
chest-count-per-interval: 3 # 一次生成 3 个宝箱
chest-spawn-delay-seconds: 5 # 每个之间间隔 5 秒
开启前倒计时
宝箱生成后初始处于锁定状态。首位右键点击的玩家将启动一个在聊天和 BossBar 中可见的可配置倒计时。只有倒计时结束后,任何人都可以打开宝箱 —— 让每个人都有机会奔跑去争夺它。
- 仅在可配置半径内的玩家会收到倒计时消息
- 宝箱被打开后,消失计时器重新开始计算
- 完全可选 —— 可通过
pre-open-timer.enabled: false 禁用
pre-open-timer:
enabled: true
duration-seconds: 30
notify-radius: 20.0
宝箱保护区域
活跃宝箱周围的方块受到保护,非 OP 玩家无法破坏或放置方块。当宝箱消失或被打开时,该区域会自动移除。
- 如果安装了 WorldGuard,则使用真实的 WorldGuard 区域
- 否则回退到内置的
BlockBreakEvent / BlockPlaceEvent 拦截机制
- 半径可配置
chest-protection-zone:
enabled: true
radius: 5 # 宝箱周围 11×11 的区域
保护插件集成
宝箱永远不会生成在被占领或受保护的区域内。启动时自动检测 —— 无需额外配置。
支持: WorldGuard · GriefPrevention · GriefDefender · Lands

自定义战利品编辑器
通过 /putintothechest 打开。无需触碰任何 YAML 文件即可可视化配置战利品。
- 直接将物品拖放到宝箱 GUI 中
- 在单箱(27 槽位)和双箱(54 槽位)之间切换
- 掉落率控制:全部 · 1/2 · 1/3 · 1/4 … 1/10
- 按等级配置(普通 / 稀有 / 传奇)
- 两步重置确认 —— 重置时物品会掉落在你的脚下
- 保留附魔、自定义名称、描述文本和 NBT 数据
掉落率示例
| 比率 |
保存的物品数 |
每次生成的物品数 |
| 1/3(默认) |
30 |
10 个随机 |
| 1/2 |
30 |
15 个随机 |
| 全部 |
30 |
全部 30 个 |
召唤苹果
四种不同的苹果类型,每种都能强制指定特定的宝箱等级或随机选择一个。所有四种都可以通过命令获取、通过 /getlegendaryitems 获得,并可配置为独立地在宝箱中掉落。
| 命令 |
结果 |
/giveapple random <player> |
随机等级宝箱 |
/giveapple common <player> |
总是普通 |
/giveapple rare <player> |
总是稀有 |
/giveapple legendary <player> |
总是传奇 |
世界苹果掉落
启用后,每次生成宝箱时都会在世界中作为一个物理物品生成一个召唤苹果。玩家在聊天中看到坐标并争相拾取。该物品在未收集前永远不会消失。
world-apple-drop:
enabled: false
spawn-method: near-chest # near-chest | near-player | with-chest
radius: 15
BossBar
可选的 HUD,显示下一个宝箱的倒计时或当前活跃宝箱的信息。自动在三种状态间切换:
- 黄色 —— 下一次生成的倒计时(在最后 N 分钟内显示)
- 粉色 —— 开启前倒计时(首位玩家激活了宝箱)
- 绿色 —— 活跃宝箱:等级、坐标、直到消失的时间
- 灰色 —— 宝箱已被打开,显示消失计时器
features:
bossbar:
enabled: false # 需手动开启
countdown-show-minutes-before: 5
基于权限的广播
所有公告都会检查单独的权限节点。在所有权限默认被拒绝的服务器上,向默认组授予 spawnchest.notify.* 节点。
| 权限 |
控制项 |
默认值 |
spawnchest.notify.spawn |
生成公告 + 标题 |
true |
spawnchest.notify.coordinates |
公告中的坐标 |
true |
spawnchest.notify.disappear |
消失公告 |
true |
spawnchest.notify.countdown |
倒计时警告 |
true |
spawnchest.notify.bossbar |
BossBar 可见性 |
true |
没有 spawnchest.notify.coordinates 权限的玩家仍会收到生成消息——只是省略了坐标。
传奇物品
九种具有特殊能力的独特物品。完全可选——在配置文件中禁用整个系统或单个物品。
| 物品 |
能力 |
冷却时间 |
| Dragon Slayer |
+4 伤害,点燃目标 |
3s |
| Master Pickaxe |
自动熔炼,50% 双倍掉落 |
1s |
| Titan Axe |
砍伐树木,+3 战斗伤害 |
4–6s |
| Void Shovel |
3×3 区域挖掘,自动收集 |
5s |
| Storm Hammer |
+5 伤害,闪电,范围冲击波 |
8s |
| Guardian Bow |
双发射,追踪箭矢 |
2s |
| Book of Ancient Wisdom |
附魔背包内所有装备 |
一次性使用 |
| Phoenix Feather |
自动复活,被动火焰免疫 |
5 分钟 |
| Poseidon's Trident |
命中时产生闪电,降雨光环 |
10s |
所有物品均包含经验修补(Mending)和最高等级附魔。所有冷却时间、伤害数值和行为均可配置。
自定义药水
完全可选——在配置文件中禁用整个系统或单个物品。
| 药水 |
效果 |
持续时间 |
稀有度 |
| Strength III |
+6 攻击力 |
2 分钟 |
稀有,传说 |
| Haste II |
挖掘速度 |
3 分钟 |
稀有,传说 |
| Luck II |
战利品提升 |
5 分钟 |
传说 |
| Dolphin's Grace |
游泳速度 |
3 分钟 |
稀有,传说 |
| Turtle Master Extended |
抗性提升 III + 缓慢 IV |
1 分钟 |
传说 |
| Wither Resistance |
再生 II + 抗性提升 II |
30–60 秒 |
传说 |

统计与成就
追踪的统计数据
- 开启的战利品箱总数及按稀有度分类的数量
- 找到的传奇物品数量
- 击杀的守卫者数量
- 使用的召唤者苹果数量
成就
| 成就 |
要求 |
经验值 |
| First Find |
开启 1 个箱子 |
50 |
| Treasure Hunter |
开启 10 个箱子 |
200 |
| Chest Master |
开启 50 个箱子 |
500 |
| Legendary Finder |
找到一个传奇物品 |
300 |
| Guardian Slayer |
击杀 25 个守卫者 |
400 |
命令
玩家命令
| 命令 |
别名 |
描述 |
/nextchest |
/nc |
距离下一次生成的时间 |
/mystats |
/stats |
查看你的统计数据 |
/leaderboard |
/lb, /top |
服务器排行榜 |
/cooldowns |
/cd |
传奇物品冷却时间 |
管理员命令
| 命令 |
描述 |
/chestnow |
立即生成一个箱子(尊重批量生成计数) |
/setchesttimer <seconds> |
更改生成间隔 |
/resettimer |
重置计时器——箱子将在 10 秒后生成 |
/reloadchestconfig |
重新加载配置文件和语言文件 |
/giveapple <random|common|rare|legendary> <player> [amount] |
给予一个召唤者苹果 |
/getlegendaryitems |
获得所有传奇物品 |
/togglelegendary [item] |
开启/关闭传奇物品 |
/togglefeature <feature> |
开启/关闭功能 |
/chestconfig get/set/toggle/reload/list |
实时修改配置 |
/putintothechest |
打开自定义战利品编辑器 |
/cheststats |
查看当前插件状态 |
/testchestzone |
预览 5 个随机的生成坐标 |
权限
| 权限 |
描述 |
默认值 |
spawnchest.use |
玩家命令 |
所有人 |
spawnchest.legendary |
接收传奇物品 |
所有人 |
spawnchest.apple |
使用召唤者苹果 |
所有人 |
spawnchest.admin |
所有管理员命令 |
OP |
spawnchest.config |
/chestconfig, /togglelegendary, /togglefeature |
OP |
spawnchest.bypass |
绕过物品冷却时间 |
OP |
spawnchest.notify.* |
公告可见性节点 |
所有人 |
本地化
包含 10 种语言。编辑 plugins/SpawnChestPlugin/lang/ 目录下的文件
| 代码 |
语言 |
en |
English |
ru |
Русский |
ua |
Українська |
es |
Español |
de |
Deutsch |
fr |
Français |
zh |
中文 |
pt |
Português |
pl |
Polski |
it |
Italiano |
安装
- 下载最新 JAR 文件
- 将其放入
plugins/ 文件夹
- 启动或重启服务器
- 根据需要编辑
plugins/SpawnChestPlugin/config.yml
- 运行
/reloadchestconfig 以应用更改
- 使用
/putintothechest 配置自定义战利品
链接
SpawnChestPlugin
Automatic treasure chest events with custom loot, legendary items, guardians, and a full visual loot editor.
GitHub | Discord | Wiki
Features
- Automatic chest spawns with configurable timer and batch spawning
- Visual loot editor — drag and drop items directly in a GUI
- Three chest tiers with different loot and guardian counts
- Nine legendary items with unique abilities (optional)
- Pre-open countdown timer — first click starts a race to the chest
- Chest protection zone — blocks cannot be broken near an active chest
- Four summoner apple types — force a specific tier on demand
- World apple drops — physical item that spawns in the world with coordinates
- Protection plugin integration — chests skip claimed territories automatically
- Permission-based broadcasts — fine control over who sees what
- BossBar HUD — countdown and active chest timer
- Statistics, achievements, and leaderboards
- 10 language translations

Compatibility
| Platform |
Support |
| Spigot |
Full support |
| Paper |
Full support + async chunk loading |
| Purpur |
Full support |
| Pufferfish |
Full support |
| Folia |
Full support |
Minecraft 1.18 – 1.21.x and 26.1 / 26.1.1 (Mojang's new versioning). Server type and version are detected automatically at startup.

Chest Tiers
| Tier |
Chance |
Guardians |
Guardian Type |
| Common |
50% |
1 |
Zombie |
| Rare |
35% |
2 |
Skeleton |
| Legendary |
15% |
3 |
Wither Skeleton |
All chances are configurable. Guardians can be disabled entirely.
Spawn System
- Distance from 0,0: 400–2000 blocks (configurable)
- Height range: Y 50–200 (configurable)
- Surface exclusions: block chests from spawning on water, lava, ice, leaves, and more
- Auto-despawn after 30 minutes if unopened (configurable)
- Batch spawning — spawn multiple chests per interval with a delay between each
settings:
chest-count-per-interval: 3 # spawn 3 chests at once
chest-spawn-delay-seconds: 5 # 5 s between each
Pre-Open Timer
Chests start locked after spawning. The first player to right-click starts a configurable countdown visible in chat and BossBar. Only after it ends can anyone open the chest — giving everyone a chance to run for it.
- Countdown messages sent only to players within a configurable radius
- Chest-disappear timer starts fresh after the chest is opened
- Fully optional — disable with
pre-open-timer.enabled: false
pre-open-timer:
enabled: true
duration-seconds: 30
notify-radius: 20.0
Chest Protection Zone
Blocks around an active chest are protected from breaking and placing by non-op players. The zone is removed automatically when the chest disappears or is opened.
- Uses real WorldGuard regions when WorldGuard is installed
- Falls back to built-in
BlockBreakEvent / BlockPlaceEvent blocking otherwise
- Radius is configurable
chest-protection-zone:
enabled: true
radius: 5 # 11×11 area around the chest
Protection Plugin Integration
Chests never spawn inside claimed or protected areas. Detected automatically at startup — no extra configuration required.
Supported: WorldGuard · GriefPrevention · GriefDefender · Lands

Custom Loot Editor
Open with /putintothechest. Configure loot visually without touching any YAML.
- Drag and drop items directly into the chest GUI
- Toggle between single (27 slots) and double (54 slots) chest
- Drop rate control: All · 1/2 · 1/3 · 1/4 … 1/10
- Per-tier configuration (Common / Rare / Legendary)
- Two-step reset confirmation — items drop at your feet on reset
- Preserves enchantments, custom names, lore, and NBT data
Drop Rate Examples
| Rate |
Items Saved |
Items per Spawn |
| 1/3 (default) |
30 |
10 random |
| 1/2 |
30 |
15 random |
| All |
30 |
All 30 |
Summoner Apples
Four distinct apple types, each forcing a specific chest tier or picking one at random. All four can be given via command, obtained through /getlegendaryitems, and configured to drop inside chests independently.
| Command |
Result |
/giveapple random <player> |
Random-tier chest |
/giveapple common <player> |
Always Common |
/giveapple rare <player> |
Always Rare |
/giveapple legendary <player> |
Always Legendary |
World Apple Drop
When enabled, a Summoner Apple spawns as a physical item in the world with each chest. Players see the coordinates in chat and race to pick it up. The item never despawns until collected.
world-apple-drop:
enabled: false
spawn-method: near-chest # near-chest | near-player | with-chest
radius: 15
BossBar
Optional HUD showing next chest countdown or active chest information. Switches between three states automatically:
- Yellow — countdown to next spawn (shows during last N minutes)
- Pink — pre-open countdown (first player activated the chest)
- Green — active chest: tier, coordinates, time until despawn
- Grey — chest was opened, showing despawn timer
features:
bossbar:
enabled: false # opt-in
countdown-show-minutes-before: 5
Permission-Based Broadcasts
All announcements check individual permission nodes. On servers where all permissions are denied by default, grant the spawnchest.notify.* nodes to the default group.
| Permission |
Controls |
Default |
spawnchest.notify.spawn |
Spawn announcement + title |
true |
spawnchest.notify.coordinates |
Coordinates in announcement |
true |
spawnchest.notify.disappear |
Disappear announcement |
true |
spawnchest.notify.countdown |
Countdown warnings |
true |
spawnchest.notify.bossbar |
BossBar visibility |
true |
Players without spawnchest.notify.coordinates still receive the spawn message — coordinates are just omitted.
Legendary Items
Nine unique items with special abilities. Entirely optional — disable the whole system or individual items in config.
| Item |
Ability |
Cooldown |
| Dragon Slayer |
+4 damage, ignites targets |
3s |
| Master Pickaxe |
Auto-smelt, 50% double drops |
1s |
| Titan Axe |
Tree felling, +3 combat damage |
4–6s |
| Void Shovel |
3×3 area excavation, auto-collect |
5s |
| Storm Hammer |
+5 damage, lightning, AoE shockwave |
8s |
| Guardian Bow |
Double shot, homing arrows |
2s |
| Book of Ancient Wisdom |
Enchant all gear in inventory |
One use |
| Phoenix Feather |
Auto-resurrect, passive fire immunity |
5 min |
| Poseidon's Trident |
Lightning on hit, rain aura |
10s |
All items include Mending and max-level enchantments. All cooldowns, damage values, and behaviours are configurable.
Custom Potions
Entirely optional — disable the whole system or individual items in config.
| Potion |
Effect |
Duration |
Tier |
| Strength III |
+6 Attack |
2 min |
Rare, Legendary |
| Haste II |
Mining Speed |
3 min |
Rare, Legendary |
| Luck II |
Loot Boost |
5 min |
Legendary |
| Dolphin's Grace |
Swim Speed |
3 min |
Rare, Legendary |
| Turtle Master Extended |
Resistance III + Slowness IV |
1 min |
Legendary |
| Wither Resistance |
Regen II + Resistance II |
30–60s |
Legendary |

Statistics & Achievements
Tracked Stats
- Chests opened (total and per tier)
- Legendary items found
- Guardians killed
- Summoner Apples used
Achievements
| Achievement |
Requirement |
XP |
| First Find |
Open 1 chest |
50 |
| Treasure Hunter |
Open 10 chests |
200 |
| Chest Master |
Open 50 chests |
500 |
| Legendary Finder |
Find a legendary item |
300 |
| Guardian Slayer |
Kill 25 guardians |
400 |
Commands
Player Commands
| Command |
Aliases |
Description |
/nextchest |
/nc |
Time until next spawn |
/mystats |
/stats |
View your statistics |
/leaderboard |
/lb, /top |
Server leaderboard |
/cooldowns |
/cd |
Legendary item cooldowns |
Admin Commands
| Command |
Description |
/chestnow |
Spawn a chest immediately (respects batch count) |
/setchesttimer <seconds> |
Change spawn interval |
/resettimer |
Reset timer — chest spawns in 10 seconds |
/reloadchestconfig |
Reload config and language files |
/giveapple <random|common|rare|legendary> <player> [amount] |
Give a Summoner Apple |
/getlegendaryitems |
Receive all legendary items |
/togglelegendary [item] |
Toggle legendary items on/off |
/togglefeature <feature> |
Toggle features on/off |
/chestconfig get/set/toggle/reload/list |
Modify config live |
/putintothechest |
Open custom loot editor |
/cheststats |
View current plugin status |
/testchestzone |
Preview 5 random spawn coordinates |
Permissions
| Permission |
Description |
Default |
spawnchest.use |
Player commands |
Everyone |
spawnchest.legendary |
Receive legendary items |
Everyone |
spawnchest.apple |
Use Summoner Apple |
Everyone |
spawnchest.admin |
All admin commands |
OP |
spawnchest.config |
/chestconfig, /togglelegendary, /togglefeature |
OP |
spawnchest.bypass |
Bypass item cooldowns |
OP |
spawnchest.notify.* |
Announcement visibility nodes |
Everyone |
Localization
10 languages included. Edit files in plugins/SpawnChestPlugin/lang/
| Code |
Language |
en |
English |
ru |
Русский |
ua |
Українська |
es |
Español |
de |
Deutsch |
fr |
Français |
zh |
中文 |
pt |
Português |
pl |
Polski |
it |
Italiano |
Installation
- Download the latest JAR
- Place it in your
plugins/ folder
- Start or restart the server
- Edit
plugins/SpawnChestPlugin/config.yml if needed
- Run
/reloadchestconfig to apply changes
- Configure custom loot with
/putintothechest
Links
评论 0
登录后参与评分
还没有评论,来抢沙发吧