Found an issue or have a question? Please contact me through the EzPlugins Discord server.

Why Server Owners Love EzCountdown

• Perfect for flash sales & events - Instantly set up countdowns for shop discounts, launches, or any special event.
• Multiple countdown types - Fixed dates, durations, recurring schedules, or manual timers. Great for launches, resets, or surprise sales.
• Flexible displays - Show timers in action bar, boss bar, title, chat, or scoreboard. Make sure every player sees the excitement.
• Firework shows - Optional, configurable firework displays for celebration moments. (new)
• Permission control - Limit visibility or management to specific ranks. Keep control in the hands of your staff or VIPs.
• PlaceholderAPI support - Use %ezcountdown_<name>_formatted% and time-part placeholders in any plugin or message.
• Config-driven - Tune update intervals, messaging, and defaults in YAML. No coding required, just edit and reload.

Quick Start

• Drop EzCountdown.jar into plugins/ and start your server.
• Edit plugins/EzCountdown/countdowns.yml to define flash sales, events, or launches.
• Use /countdown list to verify active countdowns.
• Reload changes instantly with /countdown reload.

Commands & Permissions

Command	Description	Permission
/countdown create <name> <date|duration|manual|recurring>	Create a countdown.	ezcountdown.admin
/countdown start <name>	Start a countdown.	ezcountdown.admin
/countdown stop <name>	Stop a countdown.	ezcountdown.admin
/countdown delete <name>	Delete a countdown.	ezcountdown.admin
/countdown list	List countdowns.	ezcountdown.use
/countdown info <name>	Show countdown details.	ezcountdown.use
/countdown reload	Reload configuration files.	ezcountdown.admin
/countdown location <add/delete> <name>	Location management	ezcountdown.location.<add/delete>

Example: Flash Sale Countdown
Start the sale with /countdown start flash_sale and watch the timer appear everywhere!

Countdown Types

• Fixed Date: Counts down to a specific date and time. Use for launches, holidays, or scheduled events. Example: /countdown create new_year 2026-01-01 00:00.
• Duration: Runs for a set length of time (e.g., 30 minutes), starting immediately or when triggered. Perfect for flash sales or timed events. Example: /countdown create flash_sale duration 30m.
• Manual: Defines a duration that only runs when manually started. Useful for surprise events or staff-triggered timers.
• Recurring: Repeats at a set interval (annually, monthly, weekly). Great for regular sales or events.

Display Types

• ACTION_BAR: Subtle, always-on timer above the hotbar.
• BOSS_BAR: Dramatic bar at the top of the screen.
• TITLE: Large center-screen titles for big moments.
• CHAT: Periodic chat messages.
• SCOREBOARD: Sidebar timer for ongoing events.

Mix and match display types per countdown!

Advanced Features

• Teleport players at countdown start/end using named locations.
• Firework shows for celebration moments.
• Custom messages and commands for every countdown event.
• PlaceholderAPI – Use %ezcountdown_<name>_formatted% and more in any plugin.

Locations & Fireworks

• Set teleport locations: /ezcd locations add <name>
• Configure fireworks and teleports in countdowns.yml under teleport: and firework: sections.

PlaceholderAPI

• %ezcountdown_<name>_formatted%
• %ezcountdown_<name>_days%
• %ezcountdown_<name>_hours%
• %ezcountdown_<name>_minutes%
• %ezcountdown_<name>_seconds%