🐉 DragonAbilities — GODLY Dragon Egg

Adds an INSANE overpowered DragonEgg with 5 different abilities

DragonAbilities transforms the Dragon Egg into the most powerful held item on your server. Whoever holds it commands time, tears reality, erupts with void energy, exiles enemies to a pocket dimension, and executes targets with fracture clones. Every ability is fully configurable, every cooldown is tweakable, and the holder's identity can be kept completely hidden from the server.

---

🥚 The Dragon Egg

The Dragon Egg is a custom tagged item given via command. It cannot be placed — attempting to do so is blocked with a message. Picking it up or receiving it broadcasts a server-wide announcement (showing a configurable name).

To give the egg:

/egg give <player> [display name]

The optional display name appears on the item's lore and in the give broadcast. Requires the dragonabilities.give permission (default: OP).

---

⚡ Abilities Overview

Ability I — Time Fracture

Command: /egg ability 1 — Default cooldown: 90 seconds

Spoiler

Shatters time itself. Closest nearby player within a configurable radius are completely frozen in place. The holder of the egg moves freely through the frozen world for a configurable duration (default 10 seconds).

When the duration ends, all frozen entities unfreeze simultaneously, projectiles resume their original velocity, and a dramatic ring explosion of particles signals the return of time.

---

Ability II — Reality Rip

Command: /egg ability 2 — Default cooldown: 40 seconds

Spoiler

Tears a dimensional blade through space in the direction you're facing. The blade travels up to a configurable distance (default 25 blocks), dealing true damage (default 4.5 hearts) to every entity it passes through — ignoring armor and shields entirely.

Any player struck is Silenced for a configurable duration (default 60 seconds). Silenced players cannot use Ender Pearls, Wind Charges, or Cobwebs — their escape tools are locked.

The blade also leaves a persistent rift in the air at every point it travelled. The rift remains visible and active for a configurable duration (default 30 seconds), dealing damage per second to any entity that walks through it.

---

Ability III — Void Pulse

Command: /egg ability 3 — Default cooldown: 35 seconds

Spoiler

Erupts dragon energy outward in seven cascading pulses over 7 seconds, hitting every entity within a configurable radius (default 8 blocks):

• Pulse 1 — immediate, deals 3 hearts (configurable)
• Pulse 2 — 1 second later, deals 2 hearts (configurable)
• Pulses 3–7 — once per second for 5 more seconds, 1 heart each (configurable)

Every pulse pulls enemies toward you, applies Wither I for a configurable duration (default 5 seconds), and erupts with thick expanding rings of Dragon Breath and Portal particles. The holder gains a dense 4-arm spiral particle aura for the full 7 seconds.

---

Ability IV — Dragon's Domain: Exile

Activation: Press F (Swap Hands key) — Default cooldown: 80 seconds

Spoiler

The most crowd-control ability in the kit. On activation, all players within a configurable radius (default 20 blocks) are instantly teleported to a configurable coordinate (default 3000, 200, 3000 — ideal for a custom arena build- the build/domain must be built by you). The holder follows 5 ticks later.

Reccomended build: https://www.minecraft-schematics.com/schematic/20048/

While inside the Domain:

• Exiled players are set to Adventure mode and cannot build
• Every exiled player receives Darkness II, Slowness II, and Mining Fatigue V, refreshed every 5 seconds — effect levels are all configurable
• All exiled players are constantly pulled toward the holder with a configurable pull strength, with a particle trail drawn between them and the holder each tick
• The holder deals a configurable damage multiplier (default ×1.5) against all exiled players
• The Domain lasts a configurable duration (default 20 seconds)

When the Domain collapses, all exiled players are returned to exactly where they were standing before exile, their game modes are restored, and all effects are removed.

---

Ability V — Fracture Clone Execution

Activation: Hold Shift + Press F (Swap Hands key) — Default cooldown: 120 seconds

Spoiler

A cinematic, three-phase execution sequence targeting the entity on your crosshair within a configurable range (default 25 blocks).

Phase 1 — Lock-On (5 seconds): The target is frozen in place. A rotating sigil of Dragon Breath and Portal particles expands beneath them. They cannot move, teleport, or escape. Ascending sound cues build tension.

Phase 2 — Timeline Assault (5 seconds): Five fracture clones materialise around the frozen target in rapid succession, each performing two slash attacks. Every hit deals configurable clone damage (default 1.5 hearts per hit, 10 hits total across all 5 clones). The clones flicker, leave afterimages, and vanish after striking. Ender Pearls and Wind Charges are blocked for the target during this phase.

Phase 3 — Final Erasure (2 seconds): The target is unfrozen. Then the final strike lands, dealing configurable erasure damage (default 5 hearts).

• If the target dies: a server-wide death broadcast fires and a massive particle explosion erupts at their location.
• If the target survives: they are permanently Marked for a configurable duration (default 30 seconds). While Marked, the holder deals a configurable bonus damage multiplier against them (default +25%). The target glows, and receives Weakness, Slowness, Darkness, Mining Fatigue, Wither, and Hunger for the mark duration.

---

🔧 Commands

Command	Description	Permission
/egg give <player> [name]	Gives the Dragon Egg	dragonabilities.give (OP)
/egg ability 1	Activate Time Fracture	dragonabilities.ability
/egg ability 2	Activate Reality Rip	dragonabilities.ability
/egg ability 3	Activate Void Pulse	dragonabilities.ability
/egg nodeath <player>	Toggle ability no-death for a player	dragonabilities.nodeath (OP)
/egg reload	Reload config.yml live	dragonabilities.reload (OP)

Pressing F (Swap Hands) activates Ability IV — Dragon's Domain: Exile. Pressing Shift + F activates Ability V — Fracture Clone Execution. The egg never actually swaps hands; the swap is intercepted and cancelled automatically.

---

🛡️ Damage System

All ability damage goes through a shared pipeline that respects:

1. Absorption hearts — drained before real health. Abilities cannot bypass absorption.
2. Totem of Undying — if a hit would be lethal and the target holds a Totem in either hand, it pops exactly like vanilla, granting Absorption IV, Regeneration II, and Fire Resistance I.
3. No-Death protection — players flagged with /egg nodeath are silently floored at half a heart by ability damage and cannot be killed. They can still pop totems normally above that floor. All other damage sources are also blocked at half a heart for these players.

---

⌨️ Binding Abilities to Keybinds

Abilities I, II, and III are triggered by commands, which means they can be bound to any key using a Command Keys mod (such as Command Keys for Fabric, or similar options for Forge/NeoForge).

Example bindings:

• Bind /egg ability 1 to R → instant Time Fracture
• Bind /egg ability 2 to G → instant Reality Rip
• Bind /egg ability 3 to V → instant Void Pulse

Abilities IV and V are already on dedicated keybinds (F and Shift+F) with no mod required — they fire the moment you press the key as long as you're holding the Dragon Egg.

---

⚙️ Configuration

Everything is editable in config.yml and applies instantly after restarting the server.

# Name shown in all server broadcasts instead of the holder's real name
anonymous-name: "Unknown Player"

# Master volume multiplier for all ability sound effects (1.0 = full, 0.5 = half)
master-sound-volume: 0.55

time-fracture:
  cooldown: 90          # seconds
  duration: 10          # seconds the freeze lasts
  blink-uses: 3         # right-click teleports available per activation
  blink-max-distance: 40
  freeze-radius: 30     # blocks around the holder

reality-rip:
  cooldown: 25
  travel-blocks: 25
  true-damage: 12.0     # HP (2 HP = 1 heart)
  silence-duration-seconds: 60
  rift-duration-seconds: 30
  rift-damage-per-second: 2.0

void-pulse:
  cooldown: 35
  radius: 8
  first-pulse-damage: 6.0
  second-pulse-damage: 4.0
  repeat-pulse-damage: 2.0
  wither-duration-seconds: 5

dragons-domain:
  cooldown: 80
  duration: 20
  capture-radius: 20
  domain-x: 3000
  domain-y: 200
  domain-z: 3000
  damage-multiplier: 1.5
  darkness-amplifier: 1     # effect level - 1 (1 = Level II)
  slowness-amplifier: 1
  mining-fatigue-amplifier: 4  # 4 = Level V
  pull-strength: 0.10

fracture-clone:
  cooldown: 120
  target-range: 25
  clone-damage-per-hit: 3.0
  final-hit-damage: 10.0
  mark-duration-seconds: 30
  mark-damage-multiplier: 1.25

---

📋 Requirements

• Paper (or a Paper fork) 1.21.x
• Java 21+
• No client-side mods required for any server-side features
• Optional: a Command Keys mod on the client to bind abilities 1–3 to keys

---

🔌 Installation

1. Drop DragonAbilities.jar into your server's plugins/ folder
2. Restart the server — config.yml is generated automatically with all defaults
3. Give the egg with /egg give <player> [name]
4. Bind /egg ability 1/2/3 to keys on the client if desired
5. Edit config.yml to tune any values, then restart server