Custom Boss Zoryth AI

# 👑 Zoryth AI Boss Create intelligent, multi-phase Minecraft bosses. <iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/xc0HIm77M2M" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe> --- # 🚀 Getting Started When you first start your server, the plugin automatically creates the following directory: ```text 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: ```text /zoryth reload ``` --- # 📜 Commands Main command: ```text /zoryth ``` Aliases: ```text /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> ` | `zoryth.giveegg` | Gives a boss spawn egg. | | `/zoryth kill ` | `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 ```yaml 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.) ```yaml 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