🌌 EndPortal

EndPortal is a powerful Paper plugin that gives server admins full control over The End dimension. Open and close The End manually or on a schedule, fight a custom dragon, reward top damage dealers, and protect your portal — all fully configurable.

---

✨ Features

• 🕹️ Manual & Scheduled Control — open/close The End with a command or set it up on a weekly/one-time schedule
• ⏳ 30-second Countdown — with Titles, sounds, and a live BossBar visible to all players
• 🐉 Dragon System — custom HP (default: 500❤), clean auto-respawn (no duplicated dragons!), and flawless dual BossBars (Event Status + live Dragon HP simultaneously)
• 🛡️ Ultra-Stable Architecture — smart chunk loading prevents dragon despawns and memory leaks, ensuring a flawless event experience even if players temporarily leave the dimension
• 🏆 Damage Ranking & Rewards — Top-3 damage dealers get configurable console command rewards after dragon death
• 🎁 Offline Rewards — players who disconnect before the dragon dies will automatically receive their earned loot upon their next login
• 🚪 Portal Protection — blocks entry when The End is closed, auto-teleports players to spawn on close or reconnect
• 🌍 World Border — 300-block radius enforced while dragon is alive; removed automatically after death
• 📅 Flexible Schedules — one-time dates (2026-06-15 18:00) or weekly recurring events with duration
• 🔮 Hologram Support — optional countdown hologram above the stronghold portal (requires DecentHolograms)
• 📊 PlaceholderAPI Support — display The End status and timer anywhere on your server
• ⚡ PlugMan Compatible — safely reload the plugin on the fly without breaking the event or duplicating dragons
• 🎨 Fully Configurable — all messages use MiniMessage with HEX/gradient support

---

🔧 Commands

Command	Description	Permission
/endevent open	Open The End (with 30s countdown)	endportal.admin
/endevent close	Close The End (teleports all players to spawn)	endportal.admin
/endevent reload	Safely reload config.yml	endportal.admin
/endevent status	Show current End status and timer	endportal.admin
/ende	Alias for /endevent	endportal.admin
/endportal	Alias for /endevent	endportal.admin

---

🔐 Permissions

Permission	Description	Default
endportal.admin	Access to all commands	OP
endportal.bypass	Enter The End even when it's closed	None

---

📊 PlaceholderAPI Placeholders

Placeholder	Description	Example Output
%endevent_status%	Current End status	Open / Closed / Countdown... / Scheduled
%endevent_time%	Time until next status change	2h 30m 15s / —

---

⚙️ Configuration

The plugin is fully configurable via config.yml. Key sections:

Section	Description
settings	Event duration, countdown time, world name, intervals
messages	All messages using MiniMessage (HEX & gradients supported)
sounds	Sounds for open, close, and countdown
bossbar	Color, style, and visibility of the status BossBar
titles	Enable/disable Titles, fadeIn/stay/fadeOut timing
rewards	Console commands for 1st, 2nd, 3rd place
schedules	One-time and weekly schedule entries
holograms	Hologram text and position
bypass	Nicknames or permissions that bypass portal protection
dragon	Dragon HP, aggressiveness, crystal placement blocking
world-border	Border radius, center, messages, sounds

---

📦 Dependencies

Plugin	Type	Purpose
Paper 1.21.1	Required	Server API
PlaceholderAPI	Optional	Placeholders support
DecentHolograms	Optional	Countdown hologram