SpawnChestPlugin v2.0 - English Documentation

SpawnChestPlugin v2.0 is a completely rewritten and balanced plugin for automatic spawning of chests with epic loot throughout the world. It includes 8 unique legendary items with real custom effects, a chest tier system, guardians, and numerous technical improvements.

Usage Examples

• /nextchest – Players can see when the next chest will appear.
• /spawnchestnow – Admins can trigger an event chest instantly!
• /setchesttimer 600 – Chests will spawn every 10 minutes.
• /reloadchestconfig – Apply changes to messages or timer in config.yml without restarting

👥 Player Commands:

Command	Aliases	Description	Example
/nextchest	/nc, /chest	Shows time until next chest	/nextchest
/cheststats	/cstats, /cheststat	Shows statistics and plugin information	/cheststats

🛠️ Administrator Commands:

Command	Aliases	Permission	Description
/spawnchestnow	/chestnow, /spawnchest	spawnchest.spawnchestnow	Instantly creates a chest
/setchesttimer <seconds>	/settimer, /timer	spawnchest.setchesttimer	Changes spawn interval
/reloadchestconfig	/chestconfigreload, /ccr	spawnchest.reloadchestconfig	Reloads config
/testchestzone	-	spawnchest.testchestzone	Tests spawn zone
/getlegendaryitems	/getlegendary, /testgear	spawnchest.getlegendaryitems	Gives all custom items

Chest Types

🤍 Common Chest (70% chance)

• Loot: Basic items, regular weapons and armor
• Guardians: 1 zombie
• Effects: Simple particles, chest opening sound

💙 Rare Chest (25% chance)

• Loot: Valuable materials, enchanted equipment
• Guardians: 2 skeletons with bows
• Effects: Enchantment particles, beacon sound

💛 Legendary Chest (5% chance)

• Loot: Epic treasures, custom items
• Guardians: 3 wither skeletons
• Effects: Dragon breath, lightning, dragon explosion sound

📍 Spawn Zone:

• Range: 500 to 2000 blocks from world center (0,0)
• Height: Y: 60-200 (surface only)
• Algorithm: 100 attempts to find suitable location

⏰ Timer:

• Default interval: 30 minutes (1800 seconds)
• Restart persistence: Yes, saved to timer.txt file
• Warnings: At 20, 10, 5, 3, 1 minutes and last 60 seconds

✨ Pre-opening Effects:

• Circular particles around chest
• Periodic sounds every 30 seconds
• Automatic shutdown after first opening
• Maximum duration: 5 minutes

🔐 Permission System

👥 Player Permissions (default: true):

• spawnchest.nextchest - /nextchest command
• spawnchest.cheststats - /cheststats command

🛠️ Administrator Permissions (default: op):

• spawnchest.spawnchestnow - Instant chest spawn
• spawnchest.setchesttimer - Change interval
• spawnchest.reloadchestconfig - Reload config
• spawnchest.testchestzone - Test zone
• spawnchest.getlegendaryitems - Get all items

🌟 Master Permission:

• spawnchest.* - Access to all commands