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

.\gradlew.bat build

Quick test commands (in game)

/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