🌌 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 with unique abilities, 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)
• 🐲 Dragon Abilities — aggressive AI, low-flight control, forced landing, aura effects (slowness, nausea, weakness, blindness), random curses, retaliation (lightning, launch, temporary blocks), web traps, and customizable minions (Endermen & Endermites) with hit punishment and death lightning
• 🛡️ Ultra-Stable Architecture — smart chunk loading prevents dragon despawns and memory leaks, ensuring a flawless event experience even if players temporarily leave the dimension
• 🚫 Anti-Abuse Protection — blocks ALL teleportation into The End when closed (ender pearls, chorus fruit, commands), not just portal entry
• 🌍 Distributed End Spawn — players are spread across the main End island using a Fibonacci spiral instead of stacking at 0/70/0, with automatic obsidian platform fallback
• 🧱 Vanilla Respawn Blocked — prevents players from placing crystals on the exit portal to respawn the dragon
• 🏆 Damage Ranking & Rewards — Top-3 damage dealers get configurable console command rewards after dragon death, with periodic damage-top broadcasts
• 🎁 Offline Rewards with Retry — rewards saved to pending_rewards.yml, retry mechanism on login, configurable delays between commands
• 🚪 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, periodic checks catch fast Elytra flyers, teleportation blocked beyond border, removed automatically after death
• ⏰ Flexible & Smart Schedules — one-time dates (2026-06-15 18:00) or weekly recurring events with duration, timezone support, auto-removal of expired one-time events, SCHEDULED status shown only within 7 days
• 🔮 Hologram Timer — optional countdown hologram above the stronghold portal (DecentHolograms via reflection, soft dependency, auto-spawn on plugin start)
• 🎵 Custom Sound System — configurable sounds for open, close, portal block, teleport, countdown tick, and damage top
• 📊 PlaceholderAPI Support — display The End status (%endevent_status%) and timer (%endevent_time%) anywhere on your server
• ⚡ PlugMan Safe Reload — safely reload the plugin on the fly, detects an alive dragon and restarts tracking without breaking the event or duplicating dragons
• 🗺️ Force-Loaded Chunks — 7x7 chunk grid force-loaded around End center, unloaded on close/death, with double-load protection
• 🎨 Fully Configurable — all messages use MiniMessage with HEX colors, gradients, bold, italic, underline, strikethrough and obfuscated formatting

---

🔧 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, teleport, portal block, countdown tick, and damage top
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, with timezone support
holograms	Hologram text and position
bypass	Nicknames or permissions that bypass portal protection
dragon	Dragon HP, aggressiveness, crystal placement blocking
dragon.abilities	Dragon combat abilities: aggressive AI, aura, landing, retaliation, minions, web traps
world-border	Border radius, center, teleport location, messages, sounds
end-spawn	Distributed spawn on main End island (Fibonacci spiral, safe location search, fallback platform)
placeholders	Custom text for %endevent_status% and %endevent_time% placeholders

---

📦 Dependencies

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