OneSpawner: Wave Survival

# 🌌 OneSpawner: Wave Survival

**OneSpawner** is a unique and addictive survival game mode where everything you own, build, and achieve stems from **one single spawner block** in an empty void. 

Instead of roaming a massive world for resources, your entire progression relies on your ability to spawn, fight, and conquer increasingly difficult waves of mobs right on your secure void platform!

---

## 🎮 What is the Gameplay?

1. **The Core Spawner:** You auto-generate your own private void island upon joining. Your single Spawner is your lifeline. 
2. **Fight the Waves:** Left-click your spawner to trigger custom mob waves. Each wave brings tougher enemies, larger groups, and better rewards.
3. **Automatic Inventory Looting:** Defeating wave mobs automatically funnels common, uncommon, and rare resources straight into your inventory so you can keep the action going.
4. **Unlock & Progress:** Open the multi-page wave management GUI (Shift + Right-Click the spawner) to select and unlock hundreds of unique progression tiers.

---

## ✨ Key Features

• **🔄 Infinite Prestige Scaling:** Once you beat the final wave, the game loops back with dynamic multipliers—boosting mob health, attack damage, and double-drop rates infinitely!
  * **🛡️ Absolute Island Security:** Your spawner is locked exclusively to your UUID—visitors cannot interact with your core! Islands are also 100% immune to griefing (Creepers, TNT, Ghasts, Endermen, and Pistons cannot break your arena).
  * **🚪 Dynamic Structure Doors:** Rare drops have a hidden chance to roll as a **Structure Door**. Place the door to teleport to randomized vanilla structures (Villages, Bastions, Ancient Cities) with massive coordinate offsets—meaning you get a fresh, unexplored structure every single time!
  * **🎁 Admin Custom Loot Injector:** Server admins can inject their own custom items (keys, tokens, custom gear) into specific waves in-game!
  * **📖 Multi-Page Wave GUI:** Easily browse through up to 500+ waves using a clean, paginated menu that automatically calculates pages and displays exact drop percentages.
  * **✨ Functional Enchantment Drops:** Loot tables natively drop functional Enchanted Books with randomized, leveled vanilla enchantments (Sharpness, Fortune, Protection, etc.) and auto-enchant dropped gear based on your prestige tier.
  * **The Event Matrix: Admins can inject custom "Mystery Events" into any wave. Drop a standard Vanilla Spawn Egg or a renamed Name Tag onto the pedestal to seamlessly trigger MythicMobs bosses on player islands.

---

## ⚙️ Commands & Permissions

Players have access to a clean, dynamic help menu by typing `/onespawner`.

**Player Commands:**
* `/onespawner home` — Instantly teleport back to your void island.
* `/onespawner fix` — Instantly repair your physical island blocks if they are ever missing, without losing your wave progress.
* `/onespawner return` — Safely return early from an active structure door excursion.

**Admin Commands (Requires `onespawner.admin`):**
* `/onespawner loot - Open the visual Drag-and-Drop Loot Forge!
* `/onespawner fix <player>` — Repair another player's island blocks.
* `/onespawner fixall` — Rebuilds the physical blocks for every single saved island on the server.
* `/onespawner givedoor <player> <type>` — Give a specific Structure Door.
* `/onespawner setwave <player> <wave>` — Set a player's max unlocked wave.
* `/onespawner reset <player>` — Completely wipe a player's island, inventory, and wave progress.
* `/onespawner info <player>` — Check a player's island status.
* `/onespawner reload` — Reload configuration settings.

* `/onespawner matrix - Open the Mystery Event Matrix to inject custom bosses into waves.