# Pierredufaulersack - Boss Hunt Plugin

Paper plugin for a configurable Boss Hunt mode (1 boss vs hunters).

## Features

- Lobby flow with `/bosshunt join` and `/bosshunt leave`
- Colored, prefixed chat messages for game + kit commands
- Configurable start countdown with per-second and final beep sounds
- Admin controls:
  - `/bosshunt setlobby`
  - `/bosshunt setarena`
  - `/bosshunt start`
  - `/bosshunt stop`
- Kit management for 3 boss kits and 3 hunter kits:
  - `/bosskit add|set|del|list <1-3>`
  - `/hunterkit add|set|del|list <1-3>`
- Saved kits preserve item metadata from inventory, including enchantments
- Weighted random kit selection from `config.yml` (default `40/40/20`)
- Hunter kit duplication limit per round (`hunter-kit-max-duplicates`, default `2`)
- Friendly fire protection for hunter vs hunter

## Setup

1. Build plugin jar.
2. Put jar into your Paper server `plugins/` folder.
3. Start server once to generate `config.yml`.
4. In game as OP/admin:
   - set lobby and arena
   - save kits in slots 1-3 for boss and hunter
   - players join lobby
   - start round

## Permissions

- `pierredufaulersack.admin` (default: op)

## Build

```powershell
.\gradlew.bat build
```

## Quick test commands (in game)

```text
/bosshunt setlobby
/bosshunt setarena
/bosskit set 1
/bosskit set 2
/bosskit set 3
/hunterkit set 1
/hunterkit set 2
/hunterkit set 3
/bosshunt join
/bosshunt start
```