⏱ 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

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: Join our Discord