🍩 DonutSpawners | High-Performance Spawner Remake

DonutSpawners is a professional-grade spawner management system inspired by the unique mechanics of DonutSMP. Engineered for modern server environments, it replaces lag-intensive vanilla mob spawning with a highly optimized, virtualized infrastructure.

---

🔬 Why DonutSpawners?

Standard Minecraft spawners cause significant server strain due to entity overcrowding and constant item-drop calculations. DonutSpawners solves this by shifting the logic from the physical world into a Virtual Data Buffer.

This results in:

• Lower MSPT (Milliseconds Per Tick): No more entity-cramming lag.
• Clean Chunks: No dropped items on the ground; everything is stored internally.
• Strategic Gameplay: Unique bonuses encourage smart base building over "chunk-stuffing".

---

✨ Core Mechanics & Technical Features

📦 Advanced Spawner Stacking (SBS)

Utilize our Single-Block-Stacking algorithm to consolidate your farm into a single coordinate.

• Efficient Interaction: * Right-Click: Add a single spawner to the stack.
  • Shift + Right-Click: Instantly dump your entire inventory stack into the block.
• Real-time Feedback: Updates are confirmed via a sleek Action-Bar notification.

💎 Virtualized Storage & Economy

Each spawner acts as a standalone "bank" for your resources.

• Anti-Lag Storage: Items and XP are generated directly into the spawner's internal inventory.
• EssentialsX Integration: Sell your farmed materials instantly through the GUI or collect them for crafting.
• XP Pooling: Withdraw experience points directly from the spawner's interface.

📈 The Isolation Bonus

We reward players who plan their farms. Spawners receive a Production Multiplier if they are placed with sufficient distance from other spawners, preventing massive lag-clusters and adding a layer of progression.

---

🛠️ Usage & Player Guide

For Players

• Accessing the Menu: Right-Click an active spawner with an empty hand to open the management GUI.
• Mining: Requires a tool with Silk Touch (Default).
• Deconstruction: * Break: Drops 1 spawner from the stack.
  • Shift + Break: Efficiently removes up to 64 spawners at once.

  • ⚠️ Warning: Breaking a spawner purges the internal buffer. All stored items and XP are lost!

For Administrators

Easily distribute spawners or customize the entire experience.

• Command: /givespawner <Player> <Type> [Amount]
• Permission: donutspawners.admin

---

⚙️ Configuration & Customization

The config.yml provides granular control for server owners:

• Natural Spawners: Toggle whether dungeon spawners automatically convert to the virtual system.
• Production Rates: Set custom intervals (in ticks) for every mob type.
• Economy Scaling: Define specific sell prices for items and XP values per cycle.
• Full Translation: 100% of messages and GUI titles can be localized.

---

📦 Installation

1. Ensure EssentialsX is installed (for economy features).
2. Download the latest .jar and place it in your /plugins/ folder.
3. Restart your server to generate the configuration files.
4. (Optional) Customize the config.yml to fit your server's economy.

License: MIT
Compatibility: Spigot/Paper 1.16+