A pro version of the
End Portal Timer plugin, now with more features and up-to-date improvements.
Tired of players rushing to the End before you’ve even placed your first block? End Portal Timer lets you control when the portal opens, so the dragon doesn’t get clapped before the server even has a chance to team up. Set a timer, keep the portal locked, and send a message letting everyone know when the big fight is going down. Give players time to enjoy the game instead of speedrunning past it!
---
Key Features
Advanced Access Control
• Smart Portal Locking: Prevents players from placing Eyes of Ender in End Portal frames until unlock conditions are met
• Bypass Permissions: Allow trusted players or staff to access the portal anytime
• Cooldown Management: Prevents message spam with configurable player-specific cooldowns
Scheduling System
• Single-Time Unlocks: Set a specific date and time for portal access
• Recurring Schedules: Choose from multiple schedule types:
◦
Daily: Multiple access windows throughout the day
◦
Weekly: Different times for different days of the week
◦
Interval: Regular access windows every X hours
◦
Custom: Create named access windows with specific conditions
Enhanced Player Experience
• Real-Time Countdown: Beautiful, customizable countdown displays
• Visual Effects: Configurable particles and sounds when players interact with locked portals
• Hologram Integration: Optional support for DecentHolograms plugin
• Informative Messages: Players always know when the portal will unlock
Professional Configuration
• Clean, well-organized configuration files
• Extensive Customization: Over 40 configurable options
• Timezone Support: Works with any
timezone worldwide
Automation & Integration
• Access Commands: Execute custom commands when portal unlocks
• Debug Mode: Comprehensive logging for troubleshooting
• Hot Reloading: Reload configuration without server restart
---
Commands & Permissions
Main Commands:
• /eptp help - Show available commands
• /eptp status - Check current plugin status
• /eptp reload - Reload configuration (admin)
• /eptp setdate <date> <time> - Set unlock time (admin)
• /eptp schedule - Manage recurring schedules (admin)
Key Permissions:
• endportaltimerpro.use - Basic usage (default: true)
• endportaltimerpro.bypass - Bypass portal restrictions (default: op)
• endportaltimerpro.admin - Full administrative access (default: op)
--
Make sure to configure this first!
Config
Code (Text):
# =================================================
# EndPortalTimerPro Configuration
# Version: 1.0
# =================================================
# Plugin general settings
plugin:
enabled: true
debug-mode: false
version-check: true
version: "1.0"
# Date and time configuration for portal unlock (single-time mode)
unlock-schedule:
date: "12-31-2049"
time: "00:00:00"
timezone: "UTC"
# Format: MM-dd-yyyy HH:mm:ss
# Example: 12-31-2024 23:59:59
# Recurring schedule configuration (overrides single-time mode when enabled)
schedule:
# Enable recurring schedule system
enabled: false
# Schedule type: daily, weekly, interval, custom
type: "interval"
# Timezone for schedule calculations
timezone: "UTC"
# Duration of each access window in minutes
access-duration: 60
# Daily schedule configuration (when type = daily)
access-times:
- "00:00"
- "06:00"
- "12:00"
- "18:00"
# Weekly schedule configuration (when type = weekly)
weekly-times:
monday: ["09:00", "21:00"]
tuesday: ["09:00", "21:00"]
wednesday: ["09:00", "21:00"]
thursday: ["09:00", "21:00"]
friday: ["09:00", "21:00"]
saturday: ["12:00", "20:00"]
sunday: ["12:00", "20:00"]
# You can also use: weekdays, weekends, all
# Interval schedule configuration (when type = interval)
interval-hours: 4
start-time: "00:00"
# Custom schedule configuration (when type = custom)
custom-windows:
- name: "Morning Access"
start-time: "08:00"
end-time: "10:00"
weekdays: ["weekdays"]
- name: "Evening Access"
start-time: "20:00"
end-time: "22:00"
weekdays: ["all"]
- name: "Weekend Special"
start-time: "14:00"
end-time: "16:00"
weekdays: ["weekends"]
# Display and formatting settings
display:
countdown-format: "&eTime until End Portal opens: &f%days%d %hours%h %minutes%m %seconds%s"
# Available placeholders: %days%, %hours%, %minutes%, %seconds%
# Use & for color codes (e.g., &a = green, &c = red)
# Player interaction settings
interaction:
cooldowns:
message: 5 # Seconds before another message can be sent to the same player
hologram: 30 # Seconds before another hologram can be created
# Effects when players interact with locked portal
block-effects:
sound:
enabled: true
type: "ENTITY_ENDERMAN_TELEPORT"
volume: 2.0
pitch: 0.5
particles:
enabled: true
type: "DRAGON_BREATH"
count: 50
offset:
x: 1.0
y: 1.0
z: 1.0
# Effects when portal frame is filled (legacy support)
effects:
sound:
enabled: true
name: "BLOCK_END_PORTAL_FRAME_FILL"
volume: 2.0
pitch: 0.5
particles:
enabled: true
type: "DRAGON_BREATH"
count: 50
offset: 1.0
# Commands to execute when portal unlocks
access-commands:
- "broadcast &aThe End Portal is now open!"
- "give @a ender_pearl 16"
# Add more commands as needed
# Use console commands (no leading /)
# Player messages (for custom messages in config)
message:
- "&cThe End Portal is currently locked!"
- "&e%countdown%"
- "&7Unlock date: %endportaltimer_date% at %endportaltimer_time% %endportaltimer_timezone%"
# Available placeholders:
# %countdown% - Formatted countdown timer
# %endportaltimer_date% - Configured unlock date
# %endportaltimer_time% - Configured unlock time
# %endportaltimer_timezone% - Configured timezone
# System messages (used internally)
messages:
portal-open: "&aThe End Portal is now open!"
portal-locked: "&cThe End Portal is still locked!"
invalid-date: "&cInvalid date/time format! Use MM-dd-yyyy HH:mm:ss"
no-permission: "&cYou don't have permission to do that!"
# Hologram settings (requires DecentHolograms)
holograms:
enabled: true
duration: 3 # Seconds to display hologram
# Note: Holograms will use the same messages as player messages
---
Dependency (optional)
DecentHolograms
- Displays hologram in front of the player while trying to place an ender eye into the end portal frame.
---
Requirements
• Minecraft: 1.20+ (tested up to 1.21.7)
• Server: Spigot, Paper, or any Spigot-based server
• Java: 17 or higher
---
Installation
1. Download and place EndPortalTimerPro.jar in your plugins folder
2. Start your server (config files auto-generated)
3. Configure settings in config.yml
4. Reload with
/eptp reload
---
Demo
Need Support? Join our discord server!
-
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!