<div align="center"> (https://raw.githubusercontent.com/intergrav/devins-badges/v3/assets/cozy/supported/paper_vector.svg)](https://papermc.io/) (https://raw.githubusercontent.com/intergrav/devins-badges/v3/assets/cozy/supported/purpur_vector.svg)](https://purpurmc.org/) </div> --- <h1>✨ GuardianOfNether</h1> <h3>A fully configurable Nether Guardian boss with 3 phases, custom armor drop, and Nether access control.</h3> --- <h2>🧠 Concept</h2> The **Guardian of the Nether** is a powerful boss that guards access to the Nether. Players must defeat it to unlock the Nether portal. Upon death, it drops the **Chestplate of Guardian** — a cursed armor piece with unique powers that cannot be removed or stored. --- <h2>⚔️ Features</h2> - **3 configurable phases** — speed, size, armor, damage and regeneration increase with each phase - **Leash system** — the boss stays within a configurable radius around its spawn point - **Minion waves** — wither skeleton minions spawn at the start and at regular intervals - **Nether lock** — the Nether is inaccessible until the boss is defeated *(configurable)* - **Chestplate of Guardian** — dropped on death with: - Custom red armor trim - Curse of Vanishing *(disappears if the wearer dies)* - Permanent **Glowing** effect when worn - Cannot be removed from the armor slot - Cannot be stored in any container *(chest, ender chest, shulker box...)* - **Fully configurable** — phases, stats, drops, messages, all in `config.yml` - **StackMob support** — optional soft-depend to prevent boss/minion stacking - **Auto update checker** — notifies OPs on join if a new version is available --- <h2>🔧 Installation</h2> 1. Install a **PaperMC** or **Purpur** compatible server *(1.21+)* 2. Download `GuardianOfNether.jar` and place it in your `plugins/` folder 3. Restart the server 4. Edit `plugins/GuardianOfNether/config.yml` to your liking 5. *(Optional)* Install **StackMob** to prevent boss and minion stacking --- <h2>🎮 Commands</h2> | Command | Description | Permission | |---------|-------------|------------| | `/guardian-of-nether spawn ` | Spawns the Guardian of the Nether | `guardianofnether.spawn` | | `/guardian-of-nether reload` | Reloads the config without restart | `guardianofnether.reload` | | `/guardian-of-nether nether reset` | Re-locks the Nether for a new cycle | `guardianofnether.nether` | | `/guardian-items ` | Gives the Chestplate of Guardian | `guardianofnether.items` | **Aliases:** `/gon`, `/guardian` --- <h2>🔑 Permissions</h2> | Permission | Description | Default | |------------|-------------|---------| | `guardianofnether.spawn` | Spawn the boss | OP | | `guardianofnether.reload` | Reload the config | OP | | `guardianofnether.nether` | Manage the Nether lock | OP | | `guardianofnether.items` | Give the Chestplate | OP | --- <h2>⚙️ Configuration</h2> Everything is configurable in `config.yml` — no code editing needed. ```yaml # General boss settings Boss: name: "&4&lGuardian of the Nether" leash-radius: 20 # Max radius from spawn (blocks) minions-on-spawn: 5 # Minions spawned at the start minions-wave-count: 3 # Minions per wave minions-wave-interval: 60 # Interval between waves (seconds) # 3 fully configurable phases Phases: Phase-1: { hp: 300, speed: 0.22, scale: 1.0, damage-multiplier: 0.0, ... } Phase-2: { hp-threshold-percent: 60, speed: 0.28, scale: 1.3, ... } Phase-3: { hp-threshold-percent: 30, speed: 0.35, scale: 1.7, ... } # Reward on boss death Drop: Chestplate: name: "&cChestplate of Guardian" curse-of-vanishing: true trim: { material: REDSTONE, pattern: SENTRY } # Chestplate behavior when worn Chestplate-Behavior: glowing: true # Permanent Glowing effect lock-on-equip: true # Cannot be removed block-container-storage: true # Cannot be placed in containers # Nether access control Nether: nether-close: true # true = locked until the boss is defeated # On boss death effects On-Death: clear-inventory: false clear-enderchest: false kill-villagers: false give-chestplate: true ``` > The full `config.yml` is automatically generated on first launch. --- <div align="center"> *Made with ❤️ by Zyumie (aka AyanoBrz)* </div>