HungerGames Holograms

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