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.