SpawnChestPlugin v2.6 – English Documentation

SpawnChestPlugin v2.6 is a fully balanced, Minecraft 1.21-ready plugin for automatic, world-wide chest events.

New in v2.6

• 8 legendary items with true custom abilities and visible cooldowns.
• Improved cooldown tracking with the /cooldowns command.
• Safer asynchronous location search for lag-free chest placement.
• Persistent timer with better crash-recovery logic.

---

Quick Start

1. Drop the JAR into your Paper/Spigot 1.21+ server’s plugins folder.
2. Edit config.yml to adjust timer, messages, or spawn settings.
3. Reload with /reloadchestconfig — no server restart required.

---

Player Commands

Command	Aliases	Description	Example
/nextchest	/nc, /chest	Shows time until the next chest spawn	/nextchest
/cheststats	/cstats	Displays drop chances, zone info, and plugin version	/cheststats
/cooldowns	–	Lists remaining ability cooldowns for all legendary items	/cooldowns

---

Admin Commands

Command	Aliases	Permission	Description
/spawnchestnow	/chestnow	spawnchest.spawnchestnow	Instantly spawns a chest event
/setchesttimer <sec>	/settimer, /timer	spawnchest.setchesttimer	Changes the automatic spawn interval
/reloadchestconfig	/ccr	spawnchest.reloadchestconfig	Reloads the config file
/testchestzone	–	spawnchest.testchestzone	Prints five random valid spawn coordinates
/getlegendaryitems	/getlegendary, /testgear	spawnchest.getlegendaryitems	Gives every legendary item for testing

---

Chest Tiers

Tier	Chance	Loot & Guardians	Effects
Common	70 %	Basic loot & gear, 1 Zombie	Simple particles, chest-open sound
Rare	25 %	Valuable materials & enchanted equipment, 2 Skeletons	Enchantment particles, beacon sound
Legendary	5 %	Epic treasures & all custom items, 3 Wither Skeletons	Dragon breath, lightning, dragon-explosion sound

• Spawn Range: X/Z ±500–2000, Y 60–200
• Persistence: Timer saved to timer.txt for restarts
• Warnings: Broadcast at 20 min, 10 min, 5 min, 3 min, 1 min, and every 10 sec in the final minute
• Pre-opening Effects: Spiral particles, ambient sounds every 30 s, auto-despawn 5 min after first opening

---

Legendary Items

• Dragon Slayer Blade – +4 damage, sets enemies ablaze (3 s cooldown)
• Master Pickaxe – Auto-smelts ores and can double drops (1 s cooldown)
• Titan Axe – Fells entire trees or adds +3 damage (4 s / 6 s cooldowns)
• Void Shovel – 3×3 excavation with auto-collection (5 s cooldown)
• Storm Hammer – Lightning strike and AoE damage (8 s cooldown)
• Guardian Bow – Double-shot with homing arrows (2 s cooldown)
• Book of Ancient Wisdom – Enchants all gear in inventory with balanced high-level enchants
• Phoenix Feather – Grants resurrection and fire immunity while held

---

Permission Nodes

Player (default true)

• spawnchest.nextchest – Use /nextchest
• spawnchest.cheststats – Use /cheststats
• spawnchest.cooldowns – Use /cooldowns

Admin (default op)

• spawnchest.spawnchestnow
• spawnchest.setchesttimer
• spawnchest.reloadchestconfig
• spawnchest.testchestzone
• spawnchest.getlegendaryitems

Master

• spawnchest.* – Grants all commands

---