End Portal Timer helps server owners control when players are able to access the End Portal and fight the Ender Dragon. You can set a time limit for when the portal will become active, preventing players from rushing to the End too quickly. When the portal is inactive, players attempting to use it will receive a customizable message informing them of when it will become available.
This plugin is ideal for server owners who wish to schedule a grand Ender Dragon battle with many players for a more immersive and challenging experience. It also caters to those who prefer a more leisurely pace and want to ensure that players enjoy the game's content without rushing through it.
Features
- Timezone-aware unlocking — Configure an exact date, time, and IANA timezone.
- Relative countdowns — Open the portal in seconds, minutes, hours, days, or a combined duration.
- Portal Frame protection — Eye of Ender placement is blocked until the timer finishes.
- Clear player feedback — Customizable countdown messages, sounds, and particles explain why the portal is locked.
- Optional holograms — Temporary countdown holograms are available when DecentHolograms is installed.
- Admin controls — Reload, set the date, start a countdown, view status, or toggle locking without restarting the server.
- Bypass permission — Allow trusted players to use locked frames when necessary.
- Restart-safe announcements — The plugin remembers whether the current unlock has already been announced.
Supported versions
- Minecraft 1.20.x
- Minecraft 1.21.x
- Minecraft 26.1.x
- Minecraft 26.2.x
- Java 17 or newer
The distributed JAR is built against the oldest supported API so the same file can be used across all supported release lines.
Commands
| Command | Description |
|---|---|
/ept reload |
Reload config.yml and messages.yml |
/ept setdate <MM-dd-yyyy> <HH:mm:ss> |
Set an exact unlock date and time |
/ept countdown <duration> |
Start a relative unlock countdown |
/ept status |
View the timer and portal status |
/ept toggle |
Enable or disable portal locking |
/ept help |
Show commands available to the sender |
Countdown examples include 60s, 2m, 1h, 1d, and combined values such as 1d2h30m.
Permissions
| Permission | Description |
|---|---|
endportaltimer.* |
Grants every plugin permission |
endportaltimer.admin |
Grants every administrative permission |
endportaltimer.reload |
Reload the configuration |
endportaltimer.setdate |
Set the exact unlock date and time |
endportaltimer.countdown |
Set a relative countdown |
endportaltimer.status |
View timer status |
endportaltimer.toggle |
Toggle portal locking |
endportaltimer.bypass |
Place Eyes of Ender while the lock is active |
Administrative permissions default to server operators. The help menu and tab completion show every available command, while execution remains protected by the permissions above.
Quick setup
- Place the EndPortalTimer JAR in your server's
pluginsfolder. - Start the server once to generate
config.ymlandmessages.yml. - Configure
unlock-schedule.date,unlock-schedule.time, andunlock-schedule.timezone, or run/ept countdown 1d. - Run
/ept statusto confirm the timer.
Example:
unlock-schedule:
date: "12-31-2026"
time: "20:00:00"
timezone: "Asia/Manila"
Optional dependency
DecentHolograms enables temporary holograms when players interact with a locked portal frame. EndPortalTimer works normally without it.
Demo
Need Support? Join our discord server! https://discord.gg/GCxYsMG3u6
Hey there! Your feedback, suggestions, and bug reports would be super helpful in the thread. I would be really grateful if you could share your thoughts and help me improve the plugin. Don't be shy, let me know what you think!
