👑 Zoryth AI Boss

Create intelligent, multi-phase Minecraft bosses.

---

🚀 Getting Started

When you first start your server, the plugin automatically creates the following directory:

plugins/
└── ZorythAIBoss/
    ├── config.yml
    └── bosses/

Files

• config.yml — Global plugin settings, arena rules, AI behavior, and loot settings.
• bosses/ — Stores all boss configuration files.

Create a Boss

1. Copy an existing boss file.
2. Rename it (e.g. my_boss.yml).
3. Edit the configuration.
4. Reload the plugin:

/zoryth reload

---

📜 Commands

Main command:

/zoryth

Aliases:

/zboss
/zab
/boss

Command	Permission	Description
/zoryth help	None	Shows the help menu.
/zoryth gui	zoryth.gui	Opens the interactive boss editor GUI.
/zoryth list	zoryth.list	Lists every loaded boss.
/zoryth spawn <id>	zoryth.spawn	Spawns a boss.
/zoryth giveegg <id> [player]	zoryth.giveegg	Gives a boss spawn egg.
/zoryth kill [id/all]	zoryth.kill	Removes active bosses.
/zoryth reload	zoryth.reload	Reloads all configs instantly.
/zoryth create <id>	zoryth.create	Creates a new boss config.
/zoryth delete <id>	zoryth.delete	Deletes a boss config.
/zoryth debug	zoryth.debug	Toggles debug mode.

---

⚔️ Boss Mechanics

Phases

Bosses become stronger as their health decreases.

Each phase can modify:

• Movement speed
• Attack damage
• Particle effects
• AI behavior
• Available abilities

---

Abilities

Every ability has its own cooldown and optional phase restrictions.

Available Abilities

• dash — Dash toward the target.
• leap — Jump high and slam the ground.
• fireball — Launch explosive fireballs.
• meteor_shower — Rain meteors from the sky.
• black_hole — Pull nearby players inward.
• ice_prison — Trap players inside packed ice.
• earthquake — Shake and damage nearby players.
• ground_slam — Massive area attack with knockback.
• life_steal — Damage enemies while healing the boss.
• clone — Summon weaker copies of the boss.

---

🏟️ Arenas

Enable an invisible combat arena for boss fights.

Setup

arena-enabled: true
leash-distance: 50.0

• arena-enabled enables the arena.
• leash-distance sets the arena radius.

Combat

• ⚔️ Arena activates when combat starts.
• 🔒 Players cannot leave the arena.
• 🚫 Crossing the border pulls players back.
• 🌀 Ender Pearls and Chorus Fruit can be blocked.
• ☠️ If all players die or disconnect, the boss despawns and the arena resets.

---

🛡️ How It Works

Once combat begins:

• ⚔️ The arena is automatically created when the boss attacks a player or a player attacks the boss.
• 📍 The boss's current location becomes the center of the arena.
• 🔒 Players inside the arena are locked into the encounter.
• 🚫 Players cannot escape by running away. Crossing the arena boundary will instantly pull them back toward the boss.
• 🌀 Ender Pearls and Chorus Fruit teleportation are automatically blocked while inside the arena (configurable in config.yml).
• ☠️ If every locked player dies or disconnects, the boss despawns automatically and the arena is removed.
• 🔄 The arena is fully reset, allowing the boss encounter to start fresh the next time it spawns.

---

💰 Loot

Loot is based on player contribution.

SHARED

Only the highest damage dealer receives loot.

PER_PLAYER

Every eligible player receives their own loot roll.

---

🌍 Auto Spawn

Bosses can automatically spawn in the world.

Features include:

• Fixed world coordinates
• Configurable respawn timers
• Persistent cooldowns after server restarts

---

📝 Example Config

Tip: Supports MiniMessage formatting (<red>, <gradient:blue:aqua>, etc.)

id: "example_boss"

display-name: "<red><bold>Fire Demon</bold></red>"

entity-type: "BLAZE"

attributes:
  max-health: 1000.0
  damage: 20.0
  speed: 0.3
  knockback-resistance: 1.0

auto-spawn:
  enabled: false
  world: world
  x: 100.5
  y: 65.0
  z: -250.5
  respawn-delay: 300

boss-bar:
  title: "{boss} - {phase} - <red>{health_percent}%</red>"
  color: RED
  style: SEGMENTED_10

loot:
  mode: SHARED
  entries:
    - type: ITEM
      chance: 1.0
      min-amount: 1
      max-amount: 1
      item:
        material: DIAMOND_BLOCK
        name: "<aqua>Demon Core"

phases:
  phase1:
    name: "<yellow>Warm Up</yellow>"
    threshold: 100

  phase2:
    name: "<dark_red>Enraged</dark_red>"
    threshold: 40
    speed-multiplier: 1.5

abilities:
  fireball_attack:
    type: fireball
    cooldown: 5
    damage: 15

  meteor_attack:
    type: meteor_shower
    cooldown: 20
    damage: 25
    conditions:
      phase: phase2

---

🔗 Integrations

Automatically integrates with:

• Vault — Economy rewards.
• PlaceholderAPI — Boss placeholders.
• WorldGuard — Prevent spawning inside protected regions.

---

🧟 Built-In Bosses

The plugin ships with 13 ready-to-use bosses:

• 👑 Skeleton King
• 👻 Sky Terror
• 🔥 Inferno Ghast
• ⚡ Storm Wither
• ❄ Frost Monarch
• 🗡 Shadow Assassin
• ☣ Toxic Alchemist
• 🦬 The Behemoth
• 🌌 Abyssal Warden
• 🌋 Magma Lord
• 🎭 Illusion Master
• 🌑 Void Walker
• 💀 Infernal Titan

---

✨ Features

• ✅ YAML-based boss creation
• ✅ Multi-phase boss fights
• ✅ Advanced combat AI
• ✅ Arena system
• ✅ Boss abilities
• ✅ Boss bars
• ✅ Auto spawning
• ✅ Loot tables
• ✅ Hot reload support
• ✅ Vault integration
• ✅ PlaceholderAPI support
• ✅ WorldGuard support
• ✅ Zero coding required