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

- BossBar Tracking: `IDLE -> COUNTDOWN -> RUNNING -> ENDING` - BossBar Tracking countdown announcement - BossBar Tracking with automatic spawn scanning - BossBar Tracking with full PvP protection - BossBar Tracking with visual feedback and damage handling - BossBar Tracking (visual/combat events, no destructive map edits) - BossBar Tracking system + combat logging support - BossBar Tracking for countdowns, grace, alive players, and border timing

Loot System

- Dynamic mid 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 drop loot correctly 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

- Java: 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.