🍩 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

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

License: MIT
Compatibility: Spigot/Paper 1.16+