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

---

## 🌈 BossBar Behavior

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

---

## 🖥️ Compatibility

**Java 21 required.**

---

💬 **Support & Updates:** [Join our Discord](https://discord.com/invite/n6A3nc3EW7)