RandomChestSpawner

# 📦 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.