Hungergames

# HungerGames A fast, configurable, production-ready HungerGames minigame for **Paper 1.20.x+** (Java 17). Bring classic last-player-standing gameplay to your server with modern quality-of-life features, clean arena tooling, and reliable round cleanup. ## Why This Plugin - Built for real server usage: stable flow, clear game states, and safe cleanup - Easy arena setup with wand-based selection - Fully configurable gameplay and loot behavior - Adventure-style modern chat and UI feedback ## Core Gameplay - **Game Flow**: `IDLE -> COUNTDOWN -> RUNNING -> ENDING` - **Click-to-Join** countdown announcement - **Gold-Block Spawns** with automatic spawn scanning - **Grace Period** with full PvP protection - **Shrinking Border** with visual feedback and damage handling - **Natural Disasters** (visual/combat events, no destructive map edits) - **Spectator Elimination** system + combat logging support - **BossBar Tracking** for countdowns, grace, alive players, and border timing ## Loot System - Dynamic **ground chest** generation - Dynamic **mid chest** generation on iron blocks - Weighted loot tables for ground and mid loot - Configurable loot surfaces, spawn attempts, and distance checks - Automatic chest restore/cleanup after match ## New in Version 1.1 - Added **startup movement lock** after teleport and map setup (`pre-game-movement-lock-seconds`, default `5`) - Added `loot.mid-chests-per-player` cap for iron-block chest spawns (default `3`) - Fixed death behavior so eliminated players now **drop loot correctly** - End-of-game cleanup now removes: - dropped items - arrows - spectral arrows - tridents ## Commands ### Player - `/hg join` - `/hg leave` - `/hg info` ### Admin - `/hg wand` - `/hg arena create <name>` - `/hg arena delete <name>` - `/hg arena list` - `/hg arena setspawnscan <name>` - `/hg start <arena>` - `/hg forcestart` - `/hg stop` - `/hg reload` ## Permissions - `hungergames.join` (default: true) - `hungergames.admin` (default: op) - `hungergames.command.bypass` (default: op) - `hungergames.*` (default: op) ## Requirements - **Server**: Paper 1.20.4+ (1.20.x supported) - **Java**: 17+ ## Quick Setup 1. Drop the jar into `plugins/` 2. Restart server 3. Use `/hg wand` to select two arena corners 4. Run `/hg arena create <name>` 5. Place `GOLD_BLOCK` spawns (with air above) 6. Place `IRON_BLOCK` mid-loot markers 7. Start with `/hg start <arena>` ## Notes - Disasters are designed to avoid permanent arena destruction - Round cleanup restores temporary loot chests and removes leftover combat entities/items - Configuration is generated automatically in `config.yml` ## Planned Features - Loot Airdrops - Option to enchant Loot - Placeholder Statistics (wins, kills, deaths, games played) --- If you run into issues or want balance tweaks, please contact us by joining the Discord.