HungerGames Holograms

Minecraft 版本： 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： paper spigot

标签： game-mechanics management utility

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