# boosCooldowns **Per-command cooldowns, warmups, limits, prices and disable rules – with a shared database so your whole network stays in sync.** Built for Paper 1.20+ (tested on 1.21.8 and 26.1.2). Java 21. Drop-in install, SQLite out of the box, MySQL/MariaDB for multi-server. --- ## ✨ Features ### Core control - **Per-command cooldowns** – regular expressions or wildcards, per command group, with custom messages - **Warmups** – player has to stand still while the command charges up - **Usage limits** – N uses per time window, with scheduled resets - **Prices** – money (Vault), XP levels, items, PlayerPoints - **Server-wide cooldowns** – one player uses `/event`, everyone shares the cooldown window - **Progressive cooldowns** – multiplier that grows with each consecutive use, resets after a quiet period - **Disable commands** – flag a command `disabled: true` without unregistering it; bypass permission available ### Player UX - **Warmup effects** – boss bar progress indicator, sounds, particles - **Action bar** for warmup countdown and cooldown notices - **Confirmation dialogs** – clickable `[Yes] [No]` for commands that cost something, per-player toggle - **Refund on warmup cancel** – opt-in return of charged money/items/XP when a warmup is aborted - **Localization** – drop `messages_.yml` and messages follow client language - **Per-command messages** – override cooldown/warmup/disabled text per command ### Admin tooling - **`/bcd status [player]`** – every active cooldown, remaining uses, warmup state - **`/bcd rule get/set/tempset`** – inspect or mutate command rules live (temp overrides auto-restore) - **`/bcd grant cooldown/uses`** – manually seed state on a player - **`/bcd clear cooldowns/uses/warmups/all `** – cleanup with granularity - **`/bcd reset now/schedule/list`** – global usage-counter resets, immediate or scheduled - **`/bcd validate`** – config linter (unknown keys, bad durations, typos in materials/sounds) - **`/bcd audit`** – decision log (opt-in) - **`/bcd diff`** – compare config hash across nodes sharing the same DB - **Legacy aliases** – every pre-4.0 command name still works (`clearcooldowns`, `set`, `info`, …) - **Autogenerated `/bcd help`** – permission-filtered, grouped by category - **Smart tab completion** – suggests options, player names, configured commands ### Advanced - **Per-world restrictions** – rule only applies in specific worlds - **WorldGuard regions** – rule only applies inside specific regions (optional) - **Group inheritance** – `vip` group inherits every rule from `default`, overrides just what it needs - **Event-based resets** – wipe a cooldown when the player kills an entity or earns an advancement; optional chat message, sound cue and server-wide broadcast - **Namespace-aware** – commands typed as `/plugin:command` are rewritten to their bare form so cooldowns and limits still apply (no need to keep the old hard syntax blocker on) - **Command aliases** – `/ja hello` → `/me hello` with argument substitution (`$1`, `$*`, `$player`, `$world`) - **Sign shortcuts** – `[boosCooldowns]` signs that run commands as player or console - **Multi-server drift detection** – each node hashes its `config.yml`, plugin warns on divergence, `/bcd diff` inspects ### Persistence - **SQLite** (default, zero-config) or **MySQL / MariaDB** (for networks) - JDBC drivers auto-downloaded via `libraries:` in plugin.yml – no manual install - HikariCP connection pool, cache-through for hot-path reads - Schema-versioned migrations (`V1`…`V4`), applied on startup - Legacy `users.yml` is auto-migrated on first run; old file renamed for safety ### Developer - **Public API** – `BoosCooldownAPI.getInstance()` with `isOnCooldown`, `setCooldown`, `getRemainingUses`, … - **Custom Bukkit events** – `CooldownEvent`, `WarmupEvent`, `CommandEvent` (all cancellable) - **PlaceholderAPI expansion** – `%boos_remaining_%`, `%boos_uses_%`, `%boos_on_cooldown_%` - **bStats metrics** – 13 custom charts covering storage backend (with driver version), feature toggles, detected integrations, multi-node setups, locale distribution and config scale --- ## 📦 Requirements | | Version | |---|---| | Java | **21+** | | Paper / Spigot / Bukkit | **1.20+** (API) | | Storage | SQLite bundled, or MySQL 5.7+ / MariaDB 10+ | ### Optional integrations (soft-depend) Every integration is detected at runtime – missing one just disables that feature, never breaks startup. | Plugin | Unlocks | |---|---| | [**Vault**](https://www.spigotmc.org/resources/vault.34315/) + any Vault-compatible economy (EssentialsX Economy, CMIEconomy, …) | Money prices (`price: 100.0`) | | [**PlayerPoints**](https://www.spigotmc.org/resources/playerpoints.80745/) | Point prices (`playerpoints: 10`) | | [**PlaceholderAPI**](https://www.spigotmc.org/resources/placeholderapi.6245/) | `%boos_*%` placeholders; expansion of third-party placeholders inside plugin messages | | [**WorldGuard**](https://dev.bukkit.org/projects/worldguard) | `regions:` per-command restriction | | [**LuckPerms**](https://luckperms.net/) (or any permissions plugin) | Group-based rule targeting via `booscooldowns.` | --- ## 🚀 Installation 1. Download `boosCooldowns.jar` from the Hangar page. 2. Drop it into `plugins/`. 3. Start the server once – default `config.yml` is generated in `plugins/boosCooldowns/`. 4. Edit `config.yml` and run `/bcd reload` in-game or from console. Upgrading from a pre-4.0 version? `users.yml` is migrated automatically on first start and renamed to `users.yml.migrated-`. --- ## ⚙️ Configuration essentials ### Database ```yaml database: type: sqlite # sqlite (default) or mysql / mariadb # host: localhost # port: 3306 # database: boosCooldowns # username: user # password: secret pool-size: 4 cache-ttl-seconds: 30 ``` For **shared cooldowns across multiple servers** (BungeeCord/Velocity network), point every server at the same MySQL/MariaDB instance and give each one a unique `options.options.node_id`. ### A command rule – everything available ```yaml commands: groups: default: /kit: cooldown: "1 hour" warmup: 5 # seconds limit: 3 limit_reset_delay: "6 hours" # fixed window price: 100.0 # Vault money xpcost: 5 playerpoints: 10 itemcost: item: DIAMOND count: 1 name: "Kit Token" server_cooldown: "30 minutes" # Progressive cooldown – ×2 each time, streak resets after idle cooldown_multiplier: 2.0 cooldown_reset_after: "6 hours" # Restrictions worlds: [survival, nether] regions: [spawn, arena] # requires WorldGuard # Effects warmup_sound: BLOCK_BEACON_AMBIENT complete_sound: ENTITY_EXPERIENCE_ORB_PICKUP warmup_particle: ENCHANT # Access + messages disabled: false disabled_message: "&cKit is offline." cooldown_message: "&7Kit cooling down: &e&seconds&&7." warmup_message: "&7Preparing kit... &e&seconds&&7." permission: "myplugin.kit" # optional extra gate denied_message: "&cNot allowed." shared_cooldown: [/kit_daily] shared_limit: [/kit_daily] vip: _inherits: default # all /kit rules above /kit: cooldown: "10 minutes" # …except this one gets shorter ``` ### Aliases ```yaml commands: aliases: /ja: /me # exact match /tell *: /msg $1 $* # wildcard with argument substitution ``` Placeholders: `$1`, `$2`, …, `$*`, `$player`, `$world`. ### Event-based cooldown resets ```yaml event_triggers: - when: KILL entity: ENDER_DRAGON reset_cooldown: /boss_reward message: "&6You slew the dragon! &e/boss_reward&6 is ready." sound: ENTITY_PLAYER_LEVELUP broadcast: true # default: false - when: ADVANCEMENT advancement: story/mine_diamond reset_cooldown: /miner_reward message: "&a/miner_reward has been reset." ``` Message placeholders: `&command&`, `&player&`, `&entity&` (KILL only), `&advancement&` (ADVANCEMENT only). ### Handling `/plugin:command` syntax Minecraft lets anyone bypass a cooldown by typing `/minecraft:tp` instead of `/tp`. You have two ways to stop that: - **Hard blocker** (`syntax_blocker_enabled: true`, the default) – rejects any namespace-prefixed command with an `invalid_command_syntax` message. Strict but annoying when ops type `/paper:version`. - **Transparent rewrite** (`syntax_blocker_enabled: false` + `apply_rules_to_prefixed_syntax: true`) – the plugin silently rewrites `/plugin:cmd` to `/cmd` before running its rule lookup. Players keep the shortcut, admins keep the cooldown. Recommended. ### Global options ```yaml options: options: disabled_for_ops: true # plugin has no effect on ops warmups_enabled: true cooldowns_enabled: true limits_enabled: true prices_enabled: true cancel_warmup_on_move: false cancel_warmup_on_damage: false cancel_warmup_on_sneak: false cancel_warmup_on_sprint: false cancel_warmup_on_gamemode_change: false block_interact_during_warmup: false clear_cooldowns_on_death: false clear_uses_on_death: false start_cooldowns_on_death: false command_logging: false command_signs: false syntax_blocker_enabled: true # reject /pluginname:command outright # when the blocker is off, rewrite /plugin:cmd → /cmd so rules still apply apply_rules_to_prefixed_syntax: true command_confirmation: true # ask Yes/No for priced commands refund_on_warmup_cancel: false audit_enabled: false # persist every decision to DB audit_retention_days: 30 default_locale: en node_id: "" # "" = auto hostname:port config_sync_interval_seconds: 60 action_bar: warmup: false cooldown_on_attempt: false update_interval_ticks: 10 boss_bar: warmup: false color: BLUE # BLUE, GREEN, PINK, PURPLE, RED, WHITE, YELLOW style: PROGRESS # PROGRESS, NOTCHED_6/10/12/20 ``` --- ## 💬 Commands Root command: `/booscooldowns` (alias `/bcd`). Tab completion is wired up throughout. ### Player commands | Command | Default | Purpose | |---|---|---| | `/bcd status [player]` | `true` | Your cooldowns, limits, active warmup. `[player]` requires `booscooldowns.status.others` | | `/bcd check ` | `true` | Is this command on cooldown for me? | | `/bcd confirmations` | `true` | Toggle the confirmation dialog on/off | ### Administration | Command | Default | Purpose | |---|---|---| | `/bcd reload` | op | Reload `config.yml` | | `/bcd clear cooldowns [command]` | op | Clear active cooldowns | | `/bcd clear uses [command]` | op | Reset usage counters | | `/bcd clear warmups ` | op | Cancel active warmups | | `/bcd clear all ` | op | Wipe cooldowns + uses + warmups | | `/bcd rule set

LordBoos

LordBoos's Plugins

boosCooldowns by LordBoos

LordBoos's Organizations

Stars

Watching

boosCooldowns by