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 **English and German** with one line - **Four separate color profiles** — personal, all, player-specific and stopwatch - **Fully configurable BossBar titles** with `{time}` placeholder - **Bing sound** on timer start — only the affected player hears it - **Tick sounds** in the configurable final seconds - **Finish sound** when countdown reaches zero - Player who has a timer and **leaves the server** — 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:** (https://discord.com/invite/n6A3nc3EW7)