Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 

Repository files navigation

🎁 RandomChestSpawner - Minecraft Survival Chest Plugin

Spigot/Paper 1.21+ Java 17+ MIT License

RandomChestSpawner is an exciting Spigot/Paper Minecraft plugin that brings a whole new layer of adventure to your survival servers! Randomly spawned chests appear across your world, filled with treasures ranging from common resources to legendary artifacts. Keep your players engaged and coming back for more!

⚡ Key Features

🎯 Loot by Rarity System

Experience a balanced and thrilling loot progression with 4 distinct rarity tiers, each with unique drop rates and quantities:

Rarity Chance Quantity Examples
Common 58% 16-64 items Stone, wood, dirt, basic food, building blocks
Uncommon 30% 4-16 items Iron, gold, tools, redstone components, decent food
Rare 9% 1-4 items Diamond gear, rare music discs, utility items
Epic 3% 1 item Netherite, Elytra, Totem of Undying, Nether Star

🛡️ Anti-Abuse Protection

  • Per-chest limits: Maximum 1 Epic item and 2 Rare items per chest
  • Prevents exploitation and maintains server economy balance
  • Ensures fair gameplay for all players

📍 Smart Placement Algorithm

  • Chests spawn on the ground on the highest solid block (never floating!)
  • Spawn distance: 200 to 2000 blocks from the center of online players
  • World boundaries respected: coordinates limited to -10,000 to +10,000 on X/Z axes
  • Searches from sky to bedrock to find the perfect spawn location

⏰ Dynamic Spawn Timing

  • Random interval: Every 20 to 35 minutes
  • Spawn cycle runs continuously (even when no players are online)
  • Chests only physically spawn when players are connected
  • Perfect balance between anticipation and reward

💬 Full Chat Notifications

  • Spawn announcement: All players in the same world get coordinates when a chest appears
  • Despawn notification: Everyone sees when a chest has been emptied and vanishes
  • Never miss an opportunity!

🗑️ Auto-Despawn System

  • Chests automatically disappear after being fully looted
  • Keeps your world clean and encourages exploration
  • Creates urgency and excitement among players

🎮 Perfect for Survival Servers

RandomChestSpawner transforms your survival world into an adventure-filled experience:

  • Exploration incentive: Players venture further to find rare loot
  • Economy boost: Resources flow through the server economy
  • Community engagement: Players share chest locations and compete
  • End-game goals: Legendary drops give meaning to late-game grinding
  • Fresh content: No manual management needed - it just works!

🛠️ Requirements

  • Java: 17 or higher
  • Server: Spigot or Paper 1.21+
  • World: Any survival world configuration

📦 Installation

  1. Download the latest RandomChestSpawner-X.X.X.jar from the releases page
  2. Copy the JAR file to your server's plugins folder
  3. Restart your server
  4. That's it! The plugin works out of the box with sensible defaults

🔧 Compilation

mvn clean package

The compiled JAR will be located at target/RandomChestSpawner-1.0.0.jar

📋 How It Works

  1. When the first player joins, a spawn timer begins
  2. Every 20-35 minutes (random), a chest spawns 200-2000 blocks away
  3. All players in that world are notified with exact coordinates
  4. Players race to find and loot the chest
  5. When emptied, the chest vanishes with a global notification
  6. The cycle continues automatically!

📄 License

Open source project under the MIT License.

About

Plugin Minecraft - Coffres aleatoires avec loot par rarete (Commun, Rare, Epique, Legendaire)

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages