⏱ 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

BossBarTimer

📖About BossBarTimer