
ChestSpawnPlugin is a flexible and fully customizable plugin for Paper Spigot Bukkit Purpur servers that automatically spawns random loot chests at configurable intervals and locations.
Automatic treasure chest events with custom loot, legendary items, guardians, and a full visual loot editor.

| 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.

| 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.
settings:
chest-count-per-interval: 3 # spawn 3 chests at once
chest-spawn-delay-seconds: 5 # 5 s between each
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.
pre-open-timer.enabled: falsepre-open-timer:
enabled: true
duration-seconds: 30
notify-radius: 20.0
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.
BlockBreakEvent / BlockPlaceEvent blocking otherwisechest-protection-zone:
enabled: true
radius: 5 # 11×11 area around the chest
Chests never spawn inside claimed or protected areas. Detected automatically at startup — no extra configuration required.
Supported: WorldGuard · GriefPrevention · GriefDefender · Lands

Open with /putintothechest. Configure loot visually without touching any YAML.
| Rate | Items Saved | Items per Spawn |
|---|---|---|
| 1/3 (default) | 30 | 10 random |
| 1/2 | 30 | 15 random |
| All | 30 | All 30 |
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 |
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
Optional HUD showing next chest countdown or active chest information. Switches between three states automatically:
features:
bossbar:
enabled: false # opt-in
countdown-show-minutes-before: 5
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.
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.
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 |

| 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 |
| Command | Aliases | Description |
|---|---|---|
/nextchest |
/nc |
Time until next spawn |
/mystats |
/stats |
View your statistics |
/leaderboard |
/lb, /top |
Server leaderboard |
/cooldowns |
/cd |
Legendary item cooldowns |
| 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 |
| 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 |
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 |
plugins/ folderplugins/SpawnChestPlugin/config.yml if needed/reloadchestconfig to apply changes/putintothechest