🌌 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 |
