HyperHolograms

HyperHolograms is an ultra-modern, 100% GUI-driven hologram management plugin built exclusively for modern Minecraft Paper (1.21.4+) servers using native Display Entities.

✨ Features

• 100% Chest GUI Dashboard (/hhgui) — Create, relocate, edit, reorder, and delete all server holograms inside an intuitive chest interface without typing complex commands.
• Auto Leaderboards Wizard — Generate rich leaderboards for Economy (Vault/Baltop), PvP Kills, Deaths, Playtime, and PlayerPoints with a single click. When players click the hologram, it dynamically cycles through timeframes: All-Time ➔ Monthly ➔ Weekly ➔ Daily.
• In-GUI Color & Font Style Studio — No more memorizing formatting codes! Select from 14 concrete colors, pre-tuned gradients (Fire 🔥, Ocean 🌊, Galaxy 🔮, Emerald 🌿, Rainbow 🌈), and toggle font styles (Bold, Italic, Underline, <s>Strikethrough</s>) directly from the menu.
• 3D Floating & Rotating Items — Add any item from your main hand or browse the in-game 3D catalog to display hovering blocks and weapons that spin 360° smoothly with zero TPS lag.
• Line Swapping & Reordering (GUI) — Effortlessly swap line positions or shift them up and down with simple mouse clicks inside the lines manager.
• Direct Word Editing via Chat — Update line words quickly through an interactive chat prompt while preserving all your selected colors, gradients, and font styles.
• Click Actions — Bind interactive actions triggered by player clicks: run player commands (/spawn, /warp), console commands (give %player% ...), or send private messages.
• Sound Effects Picker GUI — Choose from over 30+ categorized sound effects (Level Up, Portal, Note Pling, Amethyst Chimes) and preview/bind them directly through the GUI.
• Custom Frame-by-Frame Animations (animations.yml) — Create infinite animated text sequences with customizable tick speeds ({animation:rainbow}, etc.) and preview them live in the In-Game Animations Catalog.
• Subtle Sway Animation — Bring holograms to life with an optional gentle swaying motion that can be toggled on/off with one click.
• Live PAPI & ajLeaderboards Diagnostics — Automatically detects your server's installed stats and economy plugins, tests placeholder resolution, and gives you instant copy-paste fix commands if expansions are missing.
• Billboard Facing Options — Choose whether holograms dynamically track player view angles (Center, Horizontal) or remain locked to fixed world coordinates.
• 100% Translatable (lang.yml) — Every single message, GUI title, button lore, sound label, and timeframe name can be translated into any language.
• Next-Gen Display Entity Performance — Replaces outdated, laggy Armor Stands with Minecraft 1.21.4's native TextDisplay and ItemDisplay packets, ensuring 20.0 TPS even with hundreds of holograms.

🎮 Commands & Permissions

Player Interaction: Players only require hyperholograms.use (granted by default) to click holograms, switch leaderboard timeframes, or trigger custom click actions.

📋 Compatibility

• Minecraft Version: 1.21.4 (and newer 1.21.x releases)
• Server Software: Paper
• Java: Java 21+
• Supported Integrations: PlaceholderAPI, Vault, ajLeaderboards, EssentialsX
• Author: kynosss