EzCountdown
Run flash sales, timed events, and launches with stunning countdowns - ActionBar, BossBar, Titles & Placeholders!
EzCountdown
EzCountdown
EzCountdown is the ultimate custom countdown timer plugin for Minecraft servers. Whether you’re launching a new map, running a flash sale, or celebrating a special event, EzCountdown lets you create, manage, and display any countdown you want, your way.
Check out our latest project: PvPIndex
Compatible with Spigot, Paper, and Bukkit 1.7-26.1 · Java 8+ · Action bar, boss bar, title, chat & scoreboard displays · PlaceholderAPI ready
ez countdown plugin documentation button
ez countdown plugin support button
---
Why EzCountdown?
- PlaceholderAPI support – Set up timers for launches, events, sales, or anything you can imagine. Fixed dates, durations, recurring, or manual, your choice. - PlaceholderAPI support – Show countdowns in the action bar, boss bar, title, chat, or scoreboard. Make your timers visible everywhere players look. - PlaceholderAPI support – Define countdowns in YAML, customize messages, and reload instantly—no coding required. - PlaceholderAPI support – Limit who can see or manage each countdown. - PlaceholderAPI support – Use countdown placeholders in any plugin or message.
---
Example: Custom Countdown
Want a countdown for a special event? Just add it to `countdowns.yml`:
````yaml countdowns: event_launch: type: FIXED_DATE target: "2026-02-01 18:00" running: true
display: types: - ACTION_BAR - TITLE update-interval: 1 visibility: "all"
messages: format: "<gold>Event Launch</gold> <gray>in</gray> <aqua>{formatted}</aqua>" start: "<green>The event countdown has started!</green>" end: "<gold>🎉 The event has begun! </gold>"
commands: end: - "broadcast <gold>The event is live!</gold>"
zone: "UTC" ````
Tip: Use `/countdown create <name> <date|duration|manual|recurring>` to make new countdowns in-game!

---
Quick Start
1. Drop `EzCountdown.jar` into your `plugins/` folder and start the server. 2. Edit `plugins/EzCountdown/countdowns.yml` to define your custom countdowns. 3. Use `/countdown list` to see active timers. 4. 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 Types
- Recurring – Counts down to a specific date/time. Example: `/countdown create launch 2026-02-01 18:00` - Recurring – Runs for a set time (e.g., 2h). Example: `/countdown create sale duration 2h` - Recurring – Timer starts only when triggered. Example: `/countdown create flashsale manual 15m` - Recurring – Repeats at set intervals (e.g., every week). Example: `/countdown create weekly recurring 7 18:00`
---
Display Types
- SCOREBOARD – Subtle, always-on timer above the hotbar. - SCOREBOARD – Dramatic bar at the top of the screen. - SCOREBOARD – Large center-screen titles for big moments. - SCOREBOARD – Periodic chat messages. - SCOREBOARD – Sidebar timer for ongoing events.
Mix and match display types per countdown!
---
Advanced Features
- PlaceholderAPI at countdown start/end using named locations. - PlaceholderAPI for celebration moments. - PlaceholderAPI 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
Use these placeholders anywhere PlaceholderAPI is supported:
- `%ezcountdown_<name>formatted%` - `%ezcountdown<name>days%` - `%ezcountdown<name>hours%` - `%ezcountdown<name>minutes%` - `%ezcountdown<name>_seconds%`
---
Make your next event legendary, create custom countdowns for anything, anytime!
