[1.7 - 26.1.*] EzCountdown ⏳ | No-flash Dialog | API

[1.7 - 26.1.*] EzCountdown ⏳ | No-flash Dialog | API | Notifications -----

Run flash sales, timed events, and launches with countdowns - ActionBar, BossBar, Titles & more

Download Now
Via external site

[1.13 - 26.1.*] EzCountdown 2.0.1 - JitPack Bugfix

Fixed

JitPack build compatibility - corrected jitpack.yml Java selector to openjdk21 and pinned JitPack install to ./mvnw -B -ntp -DskipTests install so builds consistently use Java 21 when compiling against paper-api 1.21.11.
GitHub Actions version drift - updated workflow actions to current major versions across CI/release publishing (actions/checkout@v6, actions/setup-java@v5, actions/cache@v5, actions/upload-artifact@v7).
Paper/Folia smoke test resolution for 26.x - CI smoke jobs now resolve builds from fill.papermc.io/v3 and correctly include MC 26.1 with Java 25 where required.

Changed

Modrinth release step - replaced the legacy Kir-Antipov/mc-publish action invocation in release workflow with a direct Modrinth v2 API upload path for clearer failure diagnostics and up-to-date version resolution.

----------, May 22, 2026

[1.13 - 26.1.*] EzCountdown 2.0.0 - Compatibility

Added

Folia support - the plugin now runs on Folia (marked folia-supported: true in plugin.yml). Folia's GlobalRegionScheduler is used automatically when detected at runtime; Paper/Spigot continue to use the Bukkit scheduler.
compat/ package hierarchy - clean OOP abstraction layer:
- compat.platform.PlatformDetector - detects Folia vs. Paper/Spigot at startup via RegionizedServer class presence.
- compat.scheduler.SchedulerAdapter / TaskHandle - platform-agnostic scheduler interface (runTask, runTaskTimer, runTaskLater, runTaskAsync).
- compat.scheduler.BukkitSchedulerAdapter - SchedulerAdapter backed by BukkitScheduler (Paper/Spigot).
- compat.scheduler.FoliaSchedulerAdapter - SchedulerAdapter backed by GlobalRegionScheduler (Folia); only class-loaded when Folia is detected.
- compat.scheduler.SchedulerAdapterFactory - chooses the correct adapter with graceful fallback if Folia classes are missing.
- compat.version.ServerVersionUtil - canonical location for runtime Minecraft version detection (replaces util.ServerVersionUtil).
- compat.material.MaterialCompat - canonical location for cross-version material resolution (replaces util.MaterialCompat).
Startup platform log - PluginBootstrap now logs the active scheduler adapter class on enable (e.g. Scheduler: BukkitSchedulerAdapter).

Changed

util.ServerVersionUtil and util.MaterialCompat are now @Deprecated delegation stubs that forward to their canonical compat.* counterparts; they will be removed in a future release.
All internal scheduler usages (CountdownManager, FireworkShowManager, PatternScheduler, ChatInputListener, all listener.actions.* GUI action classes, SpigotIntegration, SpigotUpdateChecker) now go through SchedulerAdapter instead of Bukkit.getScheduler() / BukkitRunnable directly.
Scoreboard API modernised - ScoreboardDisplay now delegates to compat.scoreboard.ScoreboardCompat. On Paper 1.20.3+ (Criteria.DUMMY available) the modern registerNewObjective(String, Criteria, Component) overload is used; older builds fall back to the legacy string overload. The deprecated Scoreboard.resetScores(String) calls are replaced by objective unregister/re-register via ScoreboardCompat.resetObjective.
Title API modernised - TitleDisplay now delegates to compat.title.TitleCompat. On Paper 1.18+ the Adventure Player.showTitle(Title) / Player.clearTitle() APIs are preferred over the deprecated sendTitle(String...) / resetTitle(). TitleValidator now also accepts showTitle as a valid title capability. A Spigot/legacy string fallback is retained.
Per-player notification targeting - NotificationBuilder.players(Collection<Player>) restricts a notification to specific players. EzCountdownApi.sendNotification(Notification, Collection<Player>) provides an inline alternative without building a Notification first.
Countdown.isVisibleTo(Player) - centralises per-player visibility logic (permission gate + target-player set) in one method; all display handlers now use it instead of duplicated inline checks.
CountdownBuilder.targetPlayers(Collection<Player>) - restrict a persistent countdown's display to specific players.
Developer-friendly exception hierarchy - new com.skyblockexp.ezcountdown.api.exception package:
- EzCountdownException - base unchecked exception; catch this for all EzCountdown API errors.
- CountdownNotFoundException - thrown when referencing a countdown name that does not exist; carries getCountdownName().
- DuplicateCountdownException - thrown when creating a countdown whose name already exists; carries getCountdownName().
- InvalidConfigurationException - thrown by NotificationBuilder.build() and future builder validators when configuration is invalid; replaces the generic IllegalStateException.
api-version bumped to 1.18 in plugin.yml; minimum supported Minecraft version is Paper/Spigot 1.18. Dialog display continues to require Paper 1.21.7+.
Broadened Java compatibility - release JARs now target Java 17 bytecode (previously Java 21), so the plugin runs on Paper 1.18 - 1.20.4 (Java 17) as well as Paper 1.20.5+ (Java 21). The jdk21 Maven profile also targets Java 17 bytecode.
ServerVersionUtil - new utility class (com.skyblockexp.ezcountdown.util.ServerVersionUtil) for runtime Minecraft version detection; enables future conditional feature gating without hard API dependencies.
Startup guard - onEnable now logs the detected MC and Java version and disables the plugin with a clear error message if the server is too old (MC < 1.18 or Java < 17).

Changed

All display handlers (ActionBarDisplay, TitleDisplay, ChatDisplay, BossBarDisplay, ScoreboardDisplay, DialogDisplay) use countdown.isVisibleTo(player) instead of duplicated inline permission checks.
NotificationBuilder.build() now throws InvalidConfigurationException (a subclass of EzCountdownException) instead of a plain IllegalStateException.
ScoreboardDisplay catch blocks now include NoSuchMethodError so the scoreboard falls back to chat if the String-criteria registerNewObjective overload is ever removed in a future Paper build.
Project version bumped from 1.4.3 to 2.0.0.

Fixed

DURATION countdown resets to full duration on /countdown reload - resumeRunningCountdowns() previously called handler.onStart(), which always sets targetInstant to now + fullDuration, discarding the target_epoch saved in storage. It now calls handler.ensureTarget() instead, which is a no-op when a target is already present. The same guard was added to the legacy fallback path for handler-less countdown types. End-commands that fired once before a reload will no longer fire again unexpectedly due to the countdown silently restarting.

----------, May 22, 2026

[1.7 - 26.1.*] EzCountdown 1.4.2 - Configurable time format

Added

Configurable time format: new display.time-format section in config.yml.
- pattern (default "{days}d {hours}h {minutes}m {seconds}s") - customize the token layout used for the {formatted} placeholder and %ezcountdown_<name>_formatted% PAPI expansion.
- hide-leading-zeros (default true) - when enabled, leading space-delimited segments whose unit value is zero are suppressed. For example, 0d 0h 5m 3s is displayed as 5m 3s.
- Applies to countdown display messages, discord webhook {time_left}, PlaceholderAPI, and the GUI preview action.
- Hot-reloads with /countdown reload.

----------, May 15, 2026

[1.7 - 26.1.*] EzCountdown 1.4.1 - Bugfix bossbar color & style

Fixed

Bossbar color/style ignored - display.bossbar.color and display.bossbar.style in countdowns.yml had no effect; the boss bar always rendered in the default blue/solid style. All four countdown-type handlers (DurationHandler, FixedDateHandler, RecurringHandler, ManualHandler) now read these fields from config and pass them to the Countdown constructor.

----------, May 15, 2026

[1.7 - 1.21.*] EzCountdown 1.4.0 - Notification API

Added

Notification API: EzCountdownApi.sendNotification(Notification) fires a one-shot ephemeral timed display from any plugin without creating a persistent countdown or touching countdowns.yml.
Notification model: lightweight immutable value object with factory methods Notification.ofSeconds(long), Notification.of(Duration), and a fluent NotificationBuilder (display types, format message, start/end messages).
NotificationBuilder: fluent builder for Notification; all fields have sensible defaults (ACTION_BAR display, {formatted} message); build() validates duration > 0.
Ephemeral countdown support: Countdown.isEphemeral() / CountdownBuilder.ephemeral(boolean); ephemeral countdowns are removed from memory automatically when they end and are never written to storage.

----------, May 11, 2026

[1.7 - 1.21.*] EzCountdown 1.3.2 - Bugfix countdown count & memory leak

Fixed countdown count in bStats
Fixed small memory leak issue causing lag on bigger servers

----------, May 9, 2026

[1.7 - 1.21.*] EzCountdown 1.3.1 - Bugfix duration reset server startup

Bugfix: Duration countdowns were resetting to their full configured duration after a server restart

----------, May 9, 2026

[1.7 - 1.21.*] EzCountdown 1.3.0 - Dialog display type

Add DialogDisplay handler with no-flicker logic (only sends packet when formatted message text actually changes per player)
Add DialogDisplayValidator for graceful runtime detection of the experimental Paper dialog API (requires Paper 1.21.7+)
Register DIALOG in DisplayManager.configureHandlers() alongside existing display types
Add --display flag to /countdown create command e.g. /countdown create test duration 10s --display DIALOG
Add commands.error message key to messages.yml (fixes blank chat line when command handler throws an uncaught exception)
Add DIALOG to config.yml display-types comment
Added full documentation on https://ez-plugins.github.io/EzCountdown/

----------, May 7, 2026

[1.7 - 1.21.*] EzCountdown 1.2.2 - Bugfix display types

Fixed issue in countdown showing on scoreboard/bossbar when this type was not configured for this countdown.

----------, Apr 21, 2026

[1.7 - 1.21.*] EzCountdown 1.2.1 - Configurable Refresh Rate & Duplicate countdown bugfix

Feature changes

Fix issue in tick scheduling of the countdowns
Added configurable refresh speed for the displays

Code (YAML):

display:
refresh :
# How often the bossbar progress bar and title are refreshed, in ticks (20 ticks = 1 second).
# Lower values produce smoother animation. Minimum is 1.
bossbar-ticks : 1
# How often the scoreboard sidebar is refreshed, in ticks. Minimum is 1.
scoreboard-ticks : 1

Code structure changes

Added MessageBatch structure to keep more clarity in 1 countdown with multiple displays being 1 "batch"
Added DisplayMessage that represents 1 message for 1 display

----------, Apr 14, 2026

[1.7 - 1.21.*] EzCountdown 1.2.0 - Configurable bossbar

Added configurable color for bossbar countdown display
Added configurable style for bossbar countdown display

----------, Mar 26, 2026

[1.7 - 1.21.*] EzCountdown 1.1.0 - Creator GUI improvements & reload bugfix

Added a new, improved countdown manager GUI

Fixed /ezcd reloading issue, duplicating countdowns
Added {translate:message.key} placeholders
restart_countdown: <true|false> added for countdowns
countdown_start: <countdown_name> added for countdowns

----------, Feb 11, 2026

[1.7 - 1.21.*] EzCountdown 1.0.0 - Plugin refactor

Refactored the full plugin
Added CountdownBuilder (fluent API for creating countdowns)
Added feature and unit testing (MockBukkit, JUnit)
Added Maven CI build and publish workflow
Open source release: https://github.com/ez-plugins/EzCountdown

----------, Jan 30, 2026

[1.7 - 1.21.*] EzCountdown 0.4.2 - Fixed countdown improvement

Fixed issue in FIXED countdown starting up after restart when running: true was enabled for the countdown

----------, Jan 19, 2026

[1.7 - 1.21.*] EzCountdown 0.4.1 - Bugfix duplication error

Fix updating the countdowns instead of triggering the duplication error when 1 cooldown is replacing another one with overlap.

----------, Jan 14, 2026

[1.7 - 1.21.*] EzCountdown 0.4.0 - Firework show

EzCountdown Update Changelog

New features:

Locations system:
- Added locations.yml for managing named teleport locations.
- New command: /ezcd location <add|delete> <name> to create or remove locations.
- Per-countdown teleport: Teleport players to a configured location at countdown start and/or end via the teleport: section in countdowns.yml.
Advanced firework shows:
- Per-countdown firework shows can be configured for start and/or end events.
- Firework options include: location, color, power, count, interval (ticks between rows), and rows (number of concentric circles).
- Fireworks launch in a visually impressive circle around the specified location.