Chest Spawn

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

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

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

---

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.

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.

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.

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.

---

---

Statistics & Achievements

Tracked Stats

• Chests opened (total and per tier)
• Legendary items found
• Guardians killed
• Summoner Apples used

Achievements

---

Commands

Player Commands

Admin Commands

---

Permissions

---

Localization

10 languages included. Edit files in plugins/SpawnChestPlugin/lang/

---

Installation

1. Download the latest JAR
2. Place it in your plugins/ folder
3. Start or restart the server
4. Edit plugins/SpawnChestPlugin/config.yml if needed
5. Run /reloadchestconfig to apply changes
6. Configure custom loot with /putintothechest

---

Links

• Wiki: Full Documentation
• Issues: Report Bugs
• Discord: Get Support