DonutSMP Spawner

# 🍩 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 [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+