---

✨ GuardianOfNether

A fully configurable Nether Guardian boss with 3 phases, custom armor drop, and Nether access control.

---

🧠 Concept

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.

---

⚔️ Features

• 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

---

🔧 Installation

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

---

🎮 Commands

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

---

🔑 Permissions

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

---

⚙️ Configuration

Everything is configurable in config.yml — no code editing needed.

# 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.

---