# ⏱ 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 " # BossBar title templates
all-title: "⏳ Server Timer "
player-title: "⏳ Timer "
stopwatch-title: "⏱ Stoppuhr "

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 `` 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](https://discord.com/invite/n6A3nc3EW7)