HungerGameSSS

<div align="center"> <img src="https://cdn.modrinth.com/data/hungergamessss/icon.png" width="120" alt="HungerGamesSSS Icon"/> # HungerGamesSSS **A full-featured Hunger Games survival plugin for Paper 1.21+** > **v4.6.4 — Architecture & Gameplay Bug-Fix Patch released 2026-06-04.** > 11 structural bugs fixed: contradictory `ArenaEndEvent` comments, duplicate > `LootTableManager` and `CornucopiaBuilder` instances causing config-reload drift, > `startMatch()` bypassing the FSM `transition()` contract, spawn cages placed inside > terrain at Y=100, players falling through piston floors due to async physics, > dead `checkCompatibility()` method, empty `MatchSession` class, stale nested language > directory, and disconnected players holding matches open indefinitely (now auto-expired > after configurable `game.reconnect-timeout` seconds, default 60). > No database migrations — drop-in replacement for 4.6.3. > **Upgrade strongly recommended.** See (CHANGELOG.md) for the full list. (https://img.shields.io/badge/Modrinth-4.6.4-00AF5C?logo=modrinth)](https://modrinth.com/plugin/hungergamessss) (https://img.shields.io/badge/Paper-1.21%2B-blue?logo=papermc)](https://papermc.io) (https://img.shields.io/badge/Java-21%2B-orange?logo=openjdk)](https://adoptium.net) (https://img.shields.io/badge/License-Apache%202.0-blue)](LICENSE) *45 legendary weapons. Procedural dungeons. Last player standing.* (https://modrinth.com/plugin/hungergamessss) • (https://github.com/Duong2012G-mc/HungerGameSSS) • (#) </div> --- ## 📖 Table of Contents * ✨ Features * 📦 Requirements * 🚀 Installation * 🏟️ Arena System * ⏱️ Match Lifecycle * 🎮 Game Modes * ⚡ Legendary Weapons * 🏰 Dungeons * 🌽 Cornucopia Builder * 🎁 Feast Event * 👥 Teams * 💾 Persistence * 🌐 Localisation * ⌨️ Commands & Permissions * 🔌 Developer API * 🔍 Troubleshooting * 📄 Credits --- # ✨ Features ## 🏟️ Arena System * **Multi-arena support** — run unlimited concurrent arenas in separate worlds * **Per-arena toggles** — PvP, lifesteal, hardcore, veinminer, nether, end * **Glass cage countdown** — players locked in cages at spawn until the match begins * **Auto-reset** — arena world and all blocks fully restored after each match * **Legendary spawn points** — holograms float above each marked item location --- ## ⚡ 45 Legendary Weapons | Category | Count | Examples | | -------- | ----- | ------- | | Swords & Melee | 15 | Cloud Sword, Excalibur, Dragon Katana | | Bows & Ranged | 8 | Artemis Bow, Phantom Longbow, Warden Crossbow | | Staves & Magic | 8 | Void Staff, Lich Staff, Hypnosis Staff | | Tridents & Special | 9 | Aiglos, Mjolnir, Ravager Horn | | Armor | 3 | Hades' Helm, Hermes Boots, Reinforced Elytra | | Utility / Healing | 2 | Fountain of Youth, Warpick | ✔️ Each weapon has unique active + passive abilities ✔️ All stats tunable in `legend-items/<id>.yml` ✔️ Hot-reload with `/perf reload` — no restart needed --- ## 🏰 Procedural Dungeons | Type | Terrain | | ---- | ------- | | 🕷️ Spider Nest | Cobweb cave | | 💀 Crypt | Stone brick chamber | | ⛏️ Gold Mine | Mineshaft tunnels | | 🔥 Lava Temple | Nether-brick structure | | 🧊 Ice Temple | Packed-ice biome | | 🏛️ Surface Temple | Sandstone ruin | | 🗼 Surface Outpost | Watchtower | | 🌤️ Sky Island | Floating grass | | 🏯 Floating Castle | Castle 30 blocks up | ✔️ No external schematics required ✔️ Loot configurable per dungeon type ✔️ All blocks restored after match ends --- ## 📈 Match Lifecycle ``` WAITING → STARTING → PLAYING → DEATHMATCH → ENDED ``` | Phase | Description | | ----- | ----------- | | ⏳ **Waiting** | Players queue in lobby | | 🔢 **Starting** | Countdown; players teleport into cages | | ⚔️ **Playing** | Grace period → main phase → feast → border shrink | | 💥 **Deathmatch** | Border closes; final players fight | | 🏆 **Ended** | Winner announced; arena fully reset | ✔️ Disconnect/reconnect mid-match restores last location, inventory, and scoreboard --- ## 🎮 Game Modes ### ❤️ Lifesteal Kill a player → they drop a **heart item**. Pick it up to raise your max HP. Convert hearts back with `/withdraw <amount>`. ### 💀 Hardcore Eliminated players are kicked instead of moved to spectator mode. ### ⛏️ Veinminer Sneak + break an ore → chain-mines the entire vein. Max vein size is hot-configurable. --- ## 🌽 Cornucopia Themes 13 procedural themes for the arena centrepiece: `classic` · `ultimate` · `speedsilver` · `ancient` · `void` · `royal` · `industrial` · `modern` · `crystal` · `jungle` · `end` · `nether` · `grand` --- ## 🌐 Localisation 10 built-in language files: 🇬🇧 `en` · 🇻🇳 `vi` · 🇷🇺 `ru` · 🇩🇪 `de` · 🇫🇷 `fr` · 🇪🇸 `es` · 🇵🇹 `pt` · 🇯🇵 `ja` · 🇰🇷 `ko` · 🇨🇳 `zh` Players change language in-game with `/hg lang <code>`. --- ## 💾 Persistence — SQLite / MySQL All arena state, player stats, team data, and match history persist across restarts. Switc