SpawnChestPlugin

Automatic treasure chest events with custom loot that you can change!

GitHub | Discord | Wiki

---

Features

• Automatic chest spawns with configurable timer
• Visual loot editor - drag & drop items in GUI
• Three chest tiers with different guardian counts
• Nine legendary items with special abilities (optional)
• Statistics, achievements, and leaderboards
• Custom potions and Summoner Apple
• 10 language translations
• Full Folia/Paper/Spigot support

---

---

Compatibility

Platform	Support Level
Spigot	Full Support
Paper	Full Support + Async Features
Purpur	Full Support
Pufferfish	Full Support
Folia	Full Support

Auto-detects server version. Paper servers use async chunk loading for zero-lag spawning.

---

Core Features

Chest Tiers

  guardians:
      enabled: true #false - to turn off

Tier	Spawn Chance	Guardians	Guardian Type
Common	50%	1	Zombie
Rare	35%	2	Skeleton
Legendary	15%	3	Wither Skeleton

Spawn Configuration

• Distance from center: 400-2000 blocks (configurable)
• Height range: Y 50-200 (configurable)
• Auto-despawn after 30 minutes (configurable)
• World whitelist support
• Beacon beam and particle effects
• Proximity sound cues

---

---

Custom Loot Editor

Open with /putintothechest to configure loot drops visually.

Main Features

• Drag & drop items in GUI - no YAML editing
• Toggle single/double chest (27 or 54 slots)
• Drop rate control: All, 1/2, 1/3, 1/4...1/10
• Two-step reset confirmation
• Per-tier configuration (Common/Rare/Legendary)
• Keeps enchantments, names, lore, NBT data

Drop Rate System

Configure how many items spawn per chest:

Setting	Items Spawned	Use Case
All	100%	OP legendary chests
1/2	50%	Balanced loot
1/3	33%	Recommended default
1/4 - 1/10	25% - 10%	Economy servers

Items are shuffled randomly on each spawn.

Example Setup

Balanced Rare Chest:

30 configured items + 1/3 drop rate = 10 random items per spawn

OP Legendary Chest:

All legendary items + All drop rate = every item every time

---

Legendary Items (Optional)

Nine unique items with special abilities. Can be completely disabled in config.

Item	Effect	Cooldown
Dragon Slayer	+4 damage, ignites targets	3s
Master Pickaxe	Auto-smelt, 50% double drops	1s
Titan Axe	Tree felling, +3 damage	4-6s
Void Shovel	3x3 excavation	5s
Storm Hammer	Lightning strike, AoE damage	8s
Guardian Bow	Dual arrows, homing	2s
Ancient Wisdom	Enchant all equipment	One use
Phoenix Feather	Auto-resurrection, fire immunity	5min
Poseidon's Trident	Lightning on hit	10s

All items include Mending and max-level enchantments.

Disable legendary items if not needed:

legendary-items:
  enabled: true #false - to turn off: Use custom loot editor for standard drops only

Individual items can also be toggled:

legendary-items:
  dragon-slayer-sword:
    enabled: true #false - to turn off
    drop-in-chests: false

---

---

Custom Potions

Potion	Effect	Duration	Tier
Strength III	+6 Attack	2min	Rare, Legendary
Haste II	Mining Speed	3min	Rare, Legendary
Luck II	Loot Boost	5min	Legendary
Dolphin's Grace	Swim Speed	3min	Rare, Legendary
Turtle Master	Resistance III + Slowness IV	1min	Legendary
Wither Resistance	Regen II + Resistance II	30-60s	Legendary

---

Summoner Apple

summoner-apple:
  enabled: true #false - to turn off

Instantly spawns a treasure chest at random location.

• Full guardian protection and effects
• Does not reset main spawn timer
• 5% drop chance in Legendary chests
• Give via /giveapple <player> [amount]
• Ideal for donator rewards

---

---

Statistics & Achievements

Tracked Stats

• Total chests opened (by tier)
• Legendary items found
• Guardians killed
• Summoner Apples used

Achievements

Achievement	Requirement	XP Reward
First Find	Open 1 chest	50 XP
Treasure Hunter	Open 10 chests	200 XP
Chest Master	Open 50 chests	500 XP
Legendary Finder	Find 1 legendary item	300 XP
Guardian Slayer	Kill 25 guardians	400 XP

Server-wide announcements on unlock.

---

Commands

Player Commands

Command	Aliases	Description
/nextchest	/nc	Time until next spawn
/mystats	/stats	View statistics
/leaderboard	/lb, /top	Server leaderboard
/cooldowns	/cd	Legendary item cooldowns

Admin Commands

Command	Description
/chestnow	Spawn chest immediately
/setchesttimer <seconds>	Change spawn interval
/chestconfig reload	Reload config and languages
/giveapple <player> [amount]	Give Summoner Apple
/getlegendaryitems	Receive all legendary items
/togglelegendary [item]	Toggle legendary items
/putintothechest	Open custom loot editor

Examples

Spawn chest and check stats:

/chestnow
/cheststats

Give Summoner Apples to players:

/giveapple Steve 5
/giveapple Alex 3

Configure balanced rare chest:

/putintothechest
[Select Rare > Add 30 items > Set 1/3 drop rate > Save]

Disable all legendary items:

/togglelegendary

---

Permissions

Permission	Description	Default
spawnchest.use	Player commands	Everyone
spawnchest.legendary	Receive legendary items	Everyone
spawnchest.apple	Use Summoner Apple	Everyone
spawnchest.admin	Admin commands + loot editor	OP
spawnchest.bypass	Bypass cooldowns	OP

---

Configuration

language: en

settings:
  spawn-interval-seconds: 14400  # 4 hours
  chest-disappear-minutes: 30
  spawn-zone:
    min-distance: 400
    max-distance: 2000
    min-height: 50
    max-height: 200
    bury-in-ground: false
  chest-chances:
    common: 0.50
    rare: 0.35
    legendary: 0.15

features:
  guardians:
    enabled: true
    common-count: 1
    rare-count: 2
    legendary-count: 3
  effects:
    particles: true
    sounds: true
    chest-beacon-beam: true

# Disable legendary items if you only need standard loot
legendary-items:
  enabled: true #false - to turn off: set to false to disable special items

statistics:
  enabled: true
  achievements:
    enabled: true

summoner-apple:
  enabled: true #false - to turn off
  drop-chance: 0.05

---

Localization

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

Language	Code
English	en
Russian	ru
Ukrainian	ua
Spanish	es
German	de
French	fr
Chinese	zh
Portuguese	pt
Polish	pl
Italian	it

language: en  # Change to your language code

---

Installation

1. Download latest JAR
2. Place in plugins folder
3. Start/restart server
4. (Optional) Edit config.yml
5. Reload with /chestconfig reload
6. Configure loot with /putintothechest

---

Links

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

---