GuardianOfNether

<div align="center">

Paper

Purpur

</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 Chestplate of Guardian 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>

- Auto update checker — speed, size, armor, damage and regeneration increase with each phase - Auto update checker — the boss stays within a configurable radius around its spawn point - Auto update checker — wither skeleton minions spawn at the start and at regular intervals - Auto update checker — the Nether is inaccessible until the boss is defeated *(configurable)* - Auto update checker — dropped on death with: - Custom red armor trim - Curse of Vanishing *(disappears if the wearer dies)* - Permanent Auto update checker effect when worn - Cannot be removed from the armor slot - Cannot be stored in any container *(chest, ender chest, shulker box...)* - Auto update checker — phases, stats, drops, messages, all in `config.yml` - Auto update checker — 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 StackMob or StackMob 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 [x y z]` | 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 [player]` | 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>