init commit

README.md

@@ -0,0 +1,57 @@
+# 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
+```