{"id":42836414,"url":"https://github.com/ez-plugins/ezcountdown","last_synced_at":"2026-03-04T13:06:32.093Z","repository":{"id":335305620,"uuid":"1141968699","full_name":"ez-plugins/EzCountdown","owner":"ez-plugins","description":"Run flash sales, timed events, and launches with stunning countdowns - ActionBar, BossBar, Titles \u0026 Placeholders!","archived":false,"fork":false,"pushed_at":"2026-01-30T09:51:41.000Z","size":172,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-31T01:46:39.508Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ez-plugins.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-25T18:33:43.000Z","updated_at":"2026-01-30T16:51:51.000Z","dependencies_parsed_at":"2026-01-31T12:00:29.461Z","dependency_job_id":null,"html_url":"https://github.com/ez-plugins/EzCountdown","commit_stats":null,"previous_names":["ez-plugins/ezcountdown"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/ez-plugins/EzCountdown","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ez-plugins%2FEzCountdown","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ez-plugins%2FEzCountdown/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ez-plugins%2FEzCountdown/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ez-plugins%2FEzCountdown/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ez-plugins","download_url":"https://codeload.github.com/ez-plugins/EzCountdown/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ez-plugins%2FEzCountdown/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28941896,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-31T11:39:38.044Z","status":"ssl_error","status_checked_at":"2026-01-31T11:39:27.765Z","response_time":128,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-30T11:44:19.136Z","updated_at":"2026-03-04T13:06:32.078Z","avatar_url":"https://github.com/ez-plugins.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# EzCountdown\n[![CI](https://github.com/ez-plugins/EzCountdown/actions/workflows/ci.yml/badge.svg)](https://github.com/ez-plugins/EzCountdown/actions/workflows/ci.yml) [![Release](https://img.shields.io/github/v/release/ez-plugins/EzCountdown)](https://github.com/ez-plugins/EzCountdown/releases) [![License](https://img.shields.io/github/license/ez-plugins/EzCountdown)](https://github.com/ez-plugins/EzCountdown/blob/main/LICENSE) [![Issues](https://img.shields.io/github/issues/ez-plugins/EzCountdown)](https://github.com/ez-plugins/EzCountdown/issues)\n\nEzCountdown provides configurable countdown timers for events, launches, and maintenance windows across your server.\n\n## Features\n- Fixed date, duration, recurring, and manual countdown modes.\n- Display options: action bar, boss bar (1.9+), chat, title, and scoreboard.\n- PlaceholderAPI support for `%ezcountdown_\u003cname\u003e_days%`, `_hours`, `_minutes`, `_seconds`, and `_formatted`.\n- Customizable messages (messages.yml), permissions, and update intervals.\n- Run console commands when countdowns finish.\n\n## Commands\nSee [docs/commands.md](docs/commands.md) for the full command list and usage.\n\n## Countdown Types\n- **Fixed date**: Runs toward a specific date/time (e.g. `2026-01-01 00:00`).\n- **Duration**: Runs for a set amount of time starting immediately (or on create if enabled).\n- **Manual**: Uses a duration but stays stopped until `/countdown start` is run.\n- **Recurring**: Repeats on the same month/day/time every year.\n\n## Permissions\nSee [docs/permissions.md](docs/permissions.md) for permission details.\n\n## Configuration\nSee [docs/configuration.md](docs/configuration.md) for configuration details and examples.\n\n### Clock-aligned recurring schedules\n\nYou can configure recurring countdowns to align to real-world clock boundaries and specify a timezone. Example keys in `countdowns.yml`:\n\n```\n# every 2 hours on the UTC clock: 00:00, 02:00, 04:00...\nmy_recurring_countdown:\n\ttype: RECURRING\n\talign_to_clock: true\n\talign_interval: \"2h\"\n\ttimezone: \"UTC\"\n\tmissed_run_policy: SKIP\n```\n\nBehavior:\n- `align_to_clock` (default: `false`) enables clock alignment.\n- `align_interval` accepts duration strings like `2h`, `1d`, `30m`.\n- `timezone` is an IANA ZoneId (e.g. `Europe/London`). If omitted the plugin default zone is used.\n- `missed_run_policy` controls what happens if the server was down for one or more scheduled occurrences (defaults to `SKIP`).\n\nSee the full timezone reference for recommended IANA identifiers: [docs/feature/timezones.md](docs/feature/timezones.md)\n\n## Documentation\n\nComprehensive documentation is available in the `docs/` folder. Quick links:\n\n- **Commands \u0026 Configuration**\n\t- [Commands](docs/commands.md)\n\t- [Configuration](docs/configuration.md)\n\t- [Permissions](docs/permissions.md)\n\n- **Features**\n\t- [Countdown types](docs/feature/countdown_types.md)\n\t- [Teleport integration](docs/feature/teleport.md)\n\t- [Placeholder support](docs/feature/placeholders.md)\n\t- [Discord integration](docs/feature/discord_integration.md)\n\t- [GUI editor](docs/feature/gui.md)\n\t- [Firework shows](docs/feature/firework_shows.md)\n\t- Display-specific docs:\n\t\t- [Action bar](docs/feature/display/action_bar.md)\n\t\t- [Boss bar](docs/feature/display/boss_bar.md)\n\t\t- [Chat](docs/feature/display/chat.md)\n\t\t- [Title](docs/feature/display/title.md)\n\t\t- [Scoreboard](docs/feature/display/scoreboard.md)\n\n- **API**\n\t- [API overview](docs/api/README.md)\n\t- [EzCountdown API](docs/api/EzCountdownApi.md)\n\t- [Model: Countdown](docs/api/model/Countdown.md)\n\t- [Model: CountdownType](docs/api/model/CountdownType.md)\n\t- [Events: CountdownStartEvent](docs/api/event/CountdownStartEvent.md)\n\t- [Events: CountdownTickEvent](docs/api/event/CountdownTickEvent.md)\n\t- [Events: CountdownEndEvent](docs/api/event/CountdownEndEvent.md)\n\n## Example\n```\n/countdown create new_year 2026-01-01 00:00\n```\n\n## Teleporting Players on Countdown Start/End\n\nYou can configure a countdown to teleport all online players to a named location at the start or end:\n\n```\ncountdowns:\n\tmy_event:\n\t\t...\n\t\tteleport:\n\t\t\tstart: spawn\n\t\t\tend: arena\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fez-plugins%2Fezcountdown","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fez-plugins%2Fezcountdown","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fez-plugins%2Fezcountdown/lists"}