58 lines
1.4 KiB
Markdown
58 lines
1.4 KiB
Markdown
|
# 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
|
||
|
|
```
|