# SpawnChestPlugin<\/p>\n
Automatic treasure chest events with custom loot, legendary items, guardians, and a full visual loot editor.<\/p>\n
GitHub | Discord | Wiki<\/p>\n
—<\/p>\n
## Features<\/p>\n
– Automatic chest spawns with configurable timer and batch spawning
\n– Visual loot editor \u2014 drag and drop items directly in a GUI
\n– Three chest tiers with different loot and guardian counts
\n– Nine legendary items with unique abilities (optional)
\n– Pre-open countdown timer \u2014 first click starts a race to the chest
\n– Chest protection zone \u2014 blocks cannot be broken near an active chest
\n– Four summoner apple types \u2014 force a specific tier on demand
\n– World apple drops \u2014 physical item that spawns in the world with coordinates
\n– Protection plugin integration \u2014 chests skip claimed territories automatically
\n– Permission-based broadcasts \u2014 fine control over who sees what
\n– BossBar HUD \u2014 countdown and active chest timer
\n– Statistics, achievements, and leaderboards
\n– 10 language translations<\/p>\n
—<\/p>\n
<\/p>\n
—<\/p>\n
## Compatibility<\/p>\n
| Platform | Support |
\n|—|—|
\n| Spigot | Full support |
\n| Paper | Full support + async chunk loading |
\n| Purpur | Full support |
\n| Pufferfish | Full support |
\n| Folia | Full support |<\/p>\n
Minecraft **1.18 \u2013 1.21.x** and **26.1 \/ 26.1.1** (Mojang’s new versioning). Server type and version are detected automatically at startup.<\/p>\n
—<\/p>\n
<\/p>\n
—<\/p>\n
## Chest Tiers<\/p>\n
| Tier | Chance | Guardians | Guardian Type |
\n|—|—|—|—|
\n| Common | 50% | 1 | Zombie |
\n| Rare | 35% | 2 | Skeleton |
\n| Legendary | 15% | 3 | Wither Skeleton |<\/p>\n
All chances are configurable. Guardians can be disabled entirely.<\/p>\n
—<\/p>\n
## Spawn System<\/p>\n
– Distance from 0,0: 400\u20132000 blocks (configurable)
\n– Height range: Y 50\u2013200 (configurable)
\n– Surface exclusions: block chests from spawning on water, lava, ice, leaves, and more
\n– Auto-despawn after 30 minutes if unopened (configurable)
\n– **Batch spawning** \u2014 spawn multiple chests per interval with a delay between each<\/p>\n
“`yaml
\nsettings:
\n chest-count-per-interval: 3 # spawn 3 chests at once
\n chest-spawn-delay-seconds: 5 # 5 s between each
\n“`<\/p>\n
—<\/p>\n
## Pre-Open Timer<\/p>\n
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 \u2014 giving everyone a chance to run for it.<\/p>\n
– Countdown messages sent only to players within a configurable radius
\n– Chest-disappear timer starts fresh after the chest is opened
\n– Fully optional \u2014 disable with `pre-open-timer.enabled: false`<\/p>\n
“`yaml
\npre-open-timer:
\n enabled: true
\n duration-seconds: 30
\n notify-radius: 20.0
\n“`<\/p>\n
—<\/p>\n
## Chest Protection Zone<\/p>\n
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.<\/p>\n
– Uses real **WorldGuard regions** when WorldGuard is installed
\n– Falls back to built-in `BlockBreakEvent` \/ `BlockPlaceEvent` blocking otherwise
\n– Radius is configurable<\/p>\n
“`yaml
\nchest-protection-zone:
\n enabled: true
\n radius: 5 # 11\u00d711 area around the chest
\n“`<\/p>\n
—<\/p>\n
## Protection Plugin Integration<\/p>\n
Chests never spawn inside claimed or protected areas. Detected automatically at startup \u2014 no extra configuration required.<\/p>\n
**Supported:** WorldGuard \u00b7 GriefPrevention \u00b7 GriefDefender \u00b7 Lands<\/p>\n
—<\/p>\n
<\/p>\n
—<\/p>\n
## Custom Loot Editor<\/p>\n
Open with `\/putintothechest`. Configure loot visually without touching any YAML.<\/p>\n
– Drag and drop items directly into the chest GUI
\n– Toggle between single (27 slots) and double (54 slots) chest
\n– Drop rate control: All \u00b7 1\/2 \u00b7 1\/3 \u00b7 1\/4 \u2026 1\/10
\n– Per-tier configuration (Common \/ Rare \/ Legendary)
\n– Two-step reset confirmation \u2014 items drop at your feet on reset
\n– Preserves enchantments, custom names, lore, and NBT data<\/p>\n
### Drop Rate Examples<\/p>\n
| Rate | Items Saved | Items per Spawn |
\n|—|—|—|
\n| 1\/3 (default) | 30 | 10 random |
\n| 1\/2 | 30 | 15 random |
\n| All | 30 | All 30 |<\/p>\n
—<\/p>\n
## Summoner Apples<\/p>\n
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.<\/p>\n
| Command | Result | ### World Apple Drop<\/p>\n 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.<\/p>\n “`yaml —<\/p>\n ## BossBar<\/p>\n Optional HUD showing next chest countdown or active chest information. Switches between three states automatically:<\/p>\n – **Yellow** \u2014 countdown to next spawn (shows during last N minutes) “`yaml —<\/p>\n ## Permission-Based Broadcasts<\/p>\n All announcements check individual permission nodes. On servers where all permissions are denied by default, grant the `spawnchest.notify.*` nodes to the default group.<\/p>\n | Permission | Controls | Default | Players without `spawnchest.notify.coordinates` still receive the spawn message \u2014 coordinates are just omitted.<\/p>\n —<\/p>\n ## Legendary Items<\/p>\n Nine unique items with special abilities. Entirely optional \u2014 disable the whole system or individual items in config.<\/p>\n | Item | Ability | Cooldown | All items include Mending and max-level enchantments. All cooldowns, damage values, and behaviours are configurable.<\/p>\n —<\/p>\n ## Custom Potions<\/p>\n Entirely optional \u2014 disable the whole system or individual items in config.<\/p>\n | Potion | Effect | Duration | Tier | —<\/p>\n <\/p>\n —<\/p>\n ## Statistics & Achievements<\/p>\n ### Tracked Stats<\/p>\n – Chests opened (total and per tier) ### Achievements<\/p>\n | Achievement | Requirement | XP | —<\/p>\n ## Commands<\/p>\n ### Player Commands<\/p>\n | Command | Aliases | Description | ### Admin Commands<\/p>\n | Command | Description | —<\/p>\n ## Permissions<\/p>\n | Permission | Description | Default | —<\/p>\n ## Localization<\/p>\n 10 languages included. Edit files in `plugins\/SpawnChestPlugin\/lang\/`<\/p>\n | Code | Language | —<\/p>\n ## Installation<\/p>\n 1. Download the latest JAR —<\/p>\n ## Links<\/p>\n – **Wiki:** Full Documentation 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.<\/p>\n","protected":false},"featured_media":39351,"template":"","meta":{"_minecraft_slug":"chest-spawn","_minecraft_project_id":"AOhB9MQL","_minecraft_author":"bogdan6736","_minecraft_license":"MIT","_minecraft_downloads":952,"_minecraft_follows":8,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"chest-spawn.zip","_minecraft_size_bytes":2233404,"_minecraft_version_count":17,"_minecraft_updated_at":"2026-05-16T08:46:07.915507Z","_minecraft_date_created":"2025-05-12T01:17:48.094350Z","_minecraft_date_modified":"2026-05-12T18:58:45.835200Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/chest-spawn","_minecraft_icon_attachment_id":39351,"_minecraft_imported_at":"2026-06-01T20:43:45+00:00","_minecraft_import_hash":"c27633dc50347d82ac3c76be136bc6b6","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,124,156,844,88,125,89,122,866,127,128,129,91],"mod_loader":[130,131,132,133,134],"minecraft_version":[118,49,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-39350","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-bukkit","mod_category-decoration","mod_category-economy","mod_category-equipment","mod_category-folia","mod_category-game-mechanics","mod_category-magic","mod_category-minigame","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-storage","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-16","minecraft_version-1-17","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n|—|—|
\n| `\/giveapple random
\n| `\/giveapple common
\n| `\/giveapple rare
\n| `\/giveapple legendary
\nworld-apple-drop:
\n enabled: false
\n spawn-method: near-chest # near-chest | near-player | with-chest
\n radius: 15
\n“`<\/p>\n
\n– **Pink** \u2014 pre-open countdown (first player activated the chest)
\n– **Green** \u2014 active chest: tier, coordinates, time until despawn
\n– **Grey** \u2014 chest was opened, showing despawn timer<\/p>\n
\nfeatures:
\n bossbar:
\n enabled: false # opt-in
\n countdown-show-minutes-before: 5
\n“`<\/p>\n
\n|—|—|—|
\n| `spawnchest.notify.spawn` | Spawn announcement + title | `true` |
\n| `spawnchest.notify.coordinates` | Coordinates in announcement | `true` |
\n| `spawnchest.notify.disappear` | Disappear announcement | `true` |
\n| `spawnchest.notify.countdown` | Countdown warnings | `true` |
\n| `spawnchest.notify.bossbar` | BossBar visibility | `true` |<\/p>\n
\n|—|—|—|
\n| Dragon Slayer | +4 damage, ignites targets | 3s |
\n| Master Pickaxe | Auto-smelt, 50% double drops | 1s |
\n| Titan Axe | Tree felling, +3 combat damage | 4\u20136s |
\n| Void Shovel | 3\u00d73 area excavation, auto-collect | 5s |
\n| Storm Hammer | +5 damage, lightning, AoE shockwave | 8s |
\n| Guardian Bow | Double shot, homing arrows | 2s |
\n| Book of Ancient Wisdom | Enchant all gear in inventory | One use |
\n| Phoenix Feather | Auto-resurrect, passive fire immunity | 5 min |
\n| Poseidon’s Trident | Lightning on hit, rain aura | 10s |<\/p>\n
\n|—|—|—|—|
\n| Strength III | +6 Attack | 2 min | Rare, Legendary |
\n| Haste II | Mining Speed | 3 min | Rare, Legendary |
\n| Luck II | Loot Boost | 5 min | Legendary |
\n| Dolphin’s Grace | Swim Speed | 3 min | Rare, Legendary |
\n| Turtle Master Extended | Resistance III + Slowness IV | 1 min | Legendary |
\n| Wither Resistance | Regen II + Resistance II | 30\u201360s | Legendary |<\/p>\n
\n– Legendary items found
\n– Guardians killed
\n– Summoner Apples used<\/p>\n
\n|—|—|—|
\n| First Find | Open 1 chest | 50 |
\n| Treasure Hunter | Open 10 chests | 200 |
\n| Chest Master | Open 50 chests | 500 |
\n| Legendary Finder | Find a legendary item | 300 |
\n| Guardian Slayer | Kill 25 guardians | 400 |<\/p>\n
\n|—|—|—|
\n| `\/nextchest` | `\/nc` | Time until next spawn |
\n| `\/mystats` | `\/stats` | View your statistics |
\n| `\/leaderboard` | `\/lb`, `\/top` | Server leaderboard |
\n| `\/cooldowns` | `\/cd` | Legendary item cooldowns |<\/p>\n
\n|—|—|
\n| `\/chestnow` | Spawn a chest immediately (respects batch count) |
\n| `\/setchesttimer
\n| `\/resettimer` | Reset timer \u2014 chest spawns in 10 seconds |
\n| `\/reloadchestconfig` | Reload config and language files |
\n| `\/giveapple
\n| `\/getlegendaryitems` | Receive all legendary items |
\n| `\/togglelegendary [item]` | Toggle legendary items on\/off |
\n| `\/togglefeature
\n| `\/chestconfig get\/set\/toggle\/reload\/list` | Modify config live |
\n| `\/putintothechest` | Open custom loot editor |
\n| `\/cheststats` | View current plugin status |
\n| `\/testchestzone` | Preview 5 random spawn coordinates |<\/p>\n
\n|—|—|—|
\n| `spawnchest.use` | Player commands | Everyone |
\n| `spawnchest.legendary` | Receive legendary items | Everyone |
\n| `spawnchest.apple` | Use Summoner Apple | Everyone |
\n| `spawnchest.admin` | All admin commands | OP |
\n| `spawnchest.config` | `\/chestconfig`, `\/togglelegendary`, `\/togglefeature` | OP |
\n| `spawnchest.bypass` | Bypass item cooldowns | OP |
\n| `spawnchest.notify.*` | Announcement visibility nodes | Everyone |<\/p>\n
\n|—|—|
\n| `en` | English |
\n| `ru` | \u0420\u0443\u0441\u0441\u043a\u0438\u0439 |
\n| `ua` | \u0423\u043a\u0440\u0430\u0457\u043d\u0441\u044c\u043a\u0430 |
\n| `es` | Espa\u00f1ol |
\n| `de` | Deutsch |
\n| `fr` | Fran\u00e7ais |
\n| `zh` | \u4e2d\u6587 |
\n| `pt` | Portugu\u00eas |
\n| `pl` | Polski |
\n| `it` | Italiano |<\/p>\n
\n2. Place it in your `plugins\/` folder
\n3. Start or restart the server
\n4. Edit `plugins\/SpawnChestPlugin\/config.yml` if needed
\n5. Run `\/reloadchestconfig` to apply changes
\n6. Configure custom loot with `\/putintothechest`<\/p>\n
\n– **Issues:** Report Bugs
\n– **Discord:** Get Support<\/p>\n","protected":false},"excerpt":{"rendered":"