BossBarTimer

⏱ BossBarTimer

BossBarTimer is a clean, lightweight and fully configurable BossBar timer plugin for your Minecraft server. Players can start their own personal countdown or stopwatch with a single command — only they see it. Admins can push a timer to every online player at once, or target a specific player individually. No database, no complex setup, just drop it in and go.

Every color, title, sound and message is controlled through a single `config.yml`. The BossBar color shifts automatically from yellow to red as a countdown nears zero, tick sounds play in the final seconds and a finish sound fires when the timer ends.

---

⌨️ Commands

Player Commands

| Command | Permission | Description | Default | |---------|------------|-------------|---------| | `/timer <minutes>` | `bossbartimer.use` | Start a personal countdown timer | ✅ All | | `/timer <minutes> stopwatch` | `bossbartimer.use` | Start a personal stopwatch | ✅ All | | `/timer stop` | `bossbartimer.use` | Stop your own active timer | ✅ All |

Admin Commands

| Command | Permission | Description | Default | |---------|------------|-------------|---------| | `/alltimer <minutes>` | `bossbartimer.admin` | Start a countdown for ALL players | 🔒 OP | | `/alltimer <minutes> stopwatch` | `bossbartimer.admin` | Start a stopwatch for ALL players | 🔒 OP | | `/alltimer stop` | `bossbartimer.admin` | Stop ALL active timers on the server | 🔒 OP | | `/playertimer <player> <minutes>` | `bossbartimer.admin` | Start a timer for a specific player | 🔒 OP | | `/playertimer <player> <minutes> stopwatch` | `bossbartimer.admin` | Start a stopwatch for a specific player | 🔒 OP | | `/playertimerstop <player>` | `bossbartimer.admin` | Stop a specific player's timer | 🔒 OP |

---

🔐 Permissions

| Permission | Default | Description | |-----------|---------|-------------| | `bossbartimer.use` | All | Start and stop personal timers | | `bossbartimer.admin` | OP | All admin timer commands |

---

🌈 BossBar Behavior

| Remaining Time | Bar Color | |----------------|-----------| | > 30 seconds | Configured color | | ≤ 30 seconds | 🟡 Yellow | | ≤ 10 seconds | 🔴 Red + tick sound |

| Timer Type | Default Color | |-----------|---------------| | Personal timer | 🔵 Blue | | Server-wide timer (`/alltimer`) | 🔴 Red | | Player-specific timer (`/playertimer`) | 🟣 Purple | | Stopwatch | 🟢 Green |

All colors are fully configurable in `config.yml`.

---

⚙️ Config Features

```yaml settings: language: de # en, de

personal-color: BLUE # BossBar color for personal timers all-color: RED # BossBar color for /alltimer player-color: PURPLE # BossBar color for /playertimer stopwatch-color: GREEN # BossBar color for stopwatches

personal-title: "⏳ Dein Timer {time}" # BossBar title templates all-title: "⏳ Server Timer {time}" player-title: "⏳ Timer {time}" stopwatch-title: "⏱ Stoppuhr {time}"

countdown-drains: true # Bar drains as time runs out

start-sound: BLOCK_NOTE_BLOCK_PLING # Sound on timer start start-sound-pitch: 2.0 tick-at-seconds: 5 # Tick sound in final N seconds tick-sound: BLOCK_NOTE_BLOCK_PLING finish-sound: UI_TOAST_CHALLENGE_COMPLETE

show-hours: false # MM:SS vs HH:MM:SS ```

- Switch between active timer with one line - active timer — personal, all, player-specific and stopwatch - active timer with `{time}` placeholder - active timer on timer start — only the affected player hears it - active timer in the configurable final seconds - active timer when countdown reaches zero - Player who has a timer and active timer — timer is cleaned up automatically - Tab completion for `/playertimerstop` only shows players with an active timer - All messages fully customizable per language in `config.yml`

---

🌍 Language Support

| Code | Language | |------|----------| | `en` | 🇬🇧 English | | `de` | 🇩🇪 Deutsch |

---

🖥️ Compatibility

| Server Software | Version | Supported | |----------------|---------|-----------| | Paper | 1.21 – 1.21.1+ | ✅ | | Purpur | 1.21 – 1.21.1+ | ✅ | | Spigot | 1.21 – 1.21.1+ | ✅ | | Bukkit | 1.21 – 1.21.1+ | ✅ | | Folia | 1.21 – 1.21.1+ | ✅ |

Java 21 required.

---

💬 Support & Updates: Support & Updates: