HungerGamesHolograms
HungerGamesHolograms is a lightweight Paper plugin designed to manage loot chest holograms in Hunger Games maps using DecentHolograms.
The plugin provides clear visual feedback above each loot container, indicating whether a chest has already been looted or has not been opened yet, helping players and admins track loot state during a match.
It is built to be simple, efficient, and focused on one task only.
⸻
✨ Core Features
• Dynamic chest holograms • Displays a configurable text above each chest (e.g. Not Looted Yet)
• Automatically updates to a different text (e.g. Already Looted) after the first opening
• Supports multiple container types
• Chest
• Trapped Chest
• Barrel
• DecentHolograms integration
• Uses DecentHolograms as the hologram engine
• Automatically creates, updates, and removes holograms
• All holograms are namespaced with a configurable prefix for safe management
• Persistent loot state (optional)
• Looted status can be saved to disk
• State is restored after server restart
• Can be reset between matches
• Asynchronous loading
• Chest locations are loaded asynchronously
• No lag spikes during reloads
⸻
🧠 How It Works
• Chest locations are read from a configuration file (typically generated by a Hunger Games plugin). • For each location, a hologram is created slightly above the container. • When a player opens a chest for the first time: • The chest is marked as looted • The hologram text is updated instantly • Subsequent openings do not trigger additional changes.
Only real interactions are counted: the plugin reacts to actual container opening, not left-clicks or attacks.
⸻
⚙️ Commands
• /hgh reload Reloads configuration and regenerates holograms • /hgh purge Removes all holograms created by the plugin • /hgh reset Resets all chests to the "not looted" state
• /hgh status Displays plugin status and tracked chest count
Permission: hgh.admin (OP by default)
⸻
🔧 Configuration Highlights
• serverId safety lock (plugin will not start if unset)
• Customizable hologram texts • Adjustable Y-offset for hologram position
• Optional loot-state persistence
• Support for multiple worlds or map variants
