📦 Random Chest Spawner

Bring your Minecraft server to life with Random Chest Spawner!

This plugin automatically spawns treasure chests throughout your world, rewarding adventurous players with exciting loot and encouraging exploration, competition, and player interaction.

Whether you're running a Survival, SMP, Factions, or PvP server, every chest spawn becomes a new adventure.

---

✨ Features

🎯 Balanced Loot System

Every spawned chest contains randomly generated rewards divided into four rarity tiers:

Rarity	Chance	Typical Rewards
🟢 Common	58%	Building blocks, wood, stone, food, basic resources
🔵 Uncommon	30%	Iron, gold, tools, redstone items, better food
🟣 Rare	9%	Diamond equipment, rare music discs, valuable utilities
🟠 Epic	3%	Netherite gear, Elytra, Totem of Undying, Nether Star

To keep gameplay fair and balanced:

• 🛡️ Maximum 1 Epic item per chest
• 💎 Maximum 2 Rare items per chest
• ⚖️ Designed to prevent economy inflation and loot abuse

---

🌍 Intelligent Chest Spawning

Chests are placed intelligently to create a natural survival experience.

✔️ Spawn on the highest solid block (never floating)

✔️ Random distance between 200 and 2000 blocks from online players

✔️ World boundaries are respected

✔️ Automatically searches for a safe and valid spawn location

Every chest feels like a hidden treasure waiting to be discovered.

---

⏰ Dynamic Spawn Cycle

Keep players constantly exploring with automatic loot events.

• Random spawn every 20–35 minutes
• Timer runs continuously
• Chests only spawn when players are online
• Fully automatic — no manual intervention required

---

📢 Global Announcements

Players will never miss an event.

When a chest appears:

📍 Everyone in the world receives its coordinates.

When the chest has been completely looted:

🗑️ A broadcast announces that it has disappeared.

This creates exciting races across the map as players compete for the rewards.

---

🎮 Perfect for Survival Servers

Random Chest Spawner adds an entirely new gameplay loop to your server.

It encourages players to:

• 🌍 Explore unexplored areas
• ⚔️ Compete for valuable loot
• 🤝 Interact with other players
• 💰 Introduce valuable resources into your economy
• ⭐ Stay active and keep coming back

Every chest spawn becomes a memorable event.

---

🚀 Why You'll Love It

✅ Lightweight and optimized

✅ Works out of the box

✅ Balanced loot progression

✅ Automatic random events

✅ Great for Survival, SMP, PvP, Factions and custom game modes

✅ Keeps your world feeling alive

---

📦 Requirements

• Minecraft: 1.21+
• Server Software: Paper or Spigot
• Java: 17 or newer

---

⚡ Installation

1. Download the plugin.
2. Place the .jar file into your server's plugins folder.
3. Restart your server.
4. Enjoy automatic treasure hunts!

No complicated setup required.

---

🔥 How It Works

1. A player joins the server.
2. A random timer begins.
3. A treasure chest spawns somewhere in the world.
4. All players receive the chest coordinates.
5. Players race to claim the loot.
6. Once emptied, the chest disappears automatically.
7. The cycle repeats forever.

Simple, exciting, and perfect for keeping your players engaged.