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!

Try the other Minecraft plugins in the EzPlugins series