EggHolder

End War — Dragon Egg PvP Event

EggHolder is a Paper plugin that introduces a Dragon Egg-based PvP event in Minecraft. Players fight in the End to take control of the Dragon Egg. The player carrying the egg becomes the EggHolder and becomes the primary target of the match.

The event features team-based combat, custom hunter kits, live player tracking, spectator features, and several gameplay mechanics designed to keep matches active.

---

Overview

The main objective of End War is to capture and hold the Dragon Egg for as long as possible.

Once a player picks up the egg, they become the EggHolder. Their location is tracked, their status is announced to everyone, and they receive special equipment and effects.

Other participants must work together or compete against each other to eliminate the holder and take control of the egg.

As the match progresses, additional mechanics introduce new challenges and prevent gameplay from becoming stagnant.

Features

Dragon Egg / EggHolder System

• Automatic EggHolder detection.
• Manual holder assignment and removal.
• Global holder announcements.
• Custom titles and chat announcements.
• Player name and tab list customization.
• Special equipment and potion effects.
• Visual item display above the holder.

Live Bossbar Tracking

• Real-time EggHolder tracking.
• Coordinate display.
• Configurable bossbar colors and styles.
• Adjustable update intervals.

Team System

• Create and manage teams.
• Team invitations and management.
• Custom team colors with hex support.
• Team leader functionality.
• Individual and team kill tracking.
• Teammate health display.
• Automatic solo team assignment.
• Team changes locked when the match begins.

Kits support configurable equipment, potion effects, enchantments, and hotbar layouts.

Custom EggHolder Equipment

• Configurable weapons and equipment.
• Custom item names and lore.
• Enchantments.
• Unbreakable items.
• Custom combat modifiers.

Spectator System

• Automatic spectator mode after elimination.
• Invisibility to active participants.
• Spectator flight.
• Custom tab list styling.
• Recovery Compass teleportation GUI.
• Administrator-controlled revivals.
• Revival restrictions during Merciless Endgame.

Custom Scoreboard

The sidebar can display:

• Current match phase.
• Current EggHolder.
• Player kills.
• Team kills.
• Kill streaks.
• Teammate health.

Competitive Event Mechanics

Additional mechanics can be enabled, disabled, or triggered during an event.

Feature	Description
Anti-Camp Detector	Detects players camping in one location.
Revenge Mark	Marks players involved in revenge combat.
Center No-Build Ring	Restricts building around the center.
Combat Momentum	Adds combat-related bonuses.
Egg Shockwave	Triggers an effect around the Dragon Egg.
End Crystal Objectives	Adds End Crystal-based objectives.
Panic Phase	Introduces an additional pressure phase.
Overtime	Extends the match under specific conditions.
End Storms	Introduces environmental pressure.
Hotspot Rotations	Changes active combat locations.
Bridge Collapse	Collapses designated bridges.
Anti-Clean Mechanic	Discourages immediately engaging players after fights.
Merciless Endgame	Activates the final match phase.
Egg Burn Timer	Adds a timer associated with the Dragon Egg.
Supply Drops	Introduces additional resources during the match.

---

Commands

Administrator Commands

Command	Description
/eggholder add <player>	Assign a player as EggHolder.
/eggholder remove <player>	Remove EggHolder status.
/eggholder reload	Reload plugin configurations.
/revive <player>	Revive an eliminated player when permitted.
/start	Start the event.
/endwar start	Start the event.
/endwar stop	Stop the active event.
/endwar feature <feature> <on|off|trigger>	Control event mechanics.
/endwar audience <open|close|resolve>	Manage audience voting.
/endwar world prepare	Prepare the managed End world.
/endwar world status	Display End world information.

Player Commands

Command	Description
/team create [name]	Create a team.
/team invite <player>	Invite a player.
/team accept <player|team>	Accept a team invitation.
/team leave	Leave your current team.
/team kick <player>	Remove a team member.
/team disband	Disband your team.
/team menu	Open the team management menu.

---

Permissions

Permissions are divided into administrative and player functionality.

Access	Description
Administrator	Event management, EggHolder controls, match controls, world management, audience voting, and configuration reloading.
Player	Team creation, invitations, team management, and other participant features.

Note: Exact permission node strings were not included in the provided plugin documentation. They should be added from the actual plugin permission registrations rather than guessed.

---

Configuration

EggHolder provides separate configuration files for different parts of the event.

File	Description
config.yml	Main gameplay settings, event timing, bossbars, and feature toggles.
messages.yml	Chat messages, announcements, titles, and subtitles.
kits.yml	Hunter kit loadouts, items, icons, and enchantments.
scoreboard.yml	Sidebar scoreboard titles and lines.

---

Compatibility

• Paper 1.21.1+
• Java 21
• Purpur and Pufferfish supported.
• Folia and vanilla Spigot are not supported.

---