🌟 ZenxyHologram

Next-Generation TextDisplay & Packet-Based Hologram Plugin for Modern Minecraft Servers

!Java !Platform-orange?style=flat-square) !Packets-success?style=flat-square)

---

Say goodbye to legacy armor stand clutter and awkward invisible armor stand tricks. ZenxyHologram harnesses native Minecraft 1.20+ TextDisplay entities rendered strictly on the client side using PacketEvents.

Zero world pollution, zero NMS dependencies, and ultra-high performance even under heavy loads.

---

⚡ Key Highlights

• 🎯 Native TextDisplay Engine: Built exclusively on 1.20+ TextDisplay entities. Crystal-clear text rendering without jittery armor stands or hitbox collisions.
• 📦 100% Packet-Based (Zero-NMS): Holograms never exist in the server world. They are injected directly via packets per player. Your map saves and TPS remain completely untouched.
• 🔭 Smart Culling System: Packets are automatically culled and despawned for players outside the configured render radius, saving client FPS and server network bandwidth.
• 🎨 Full MiniMessage & Legacy Support: Complete modern formatting with MiniMessage (gradients, rgb, hover, animations) as well as classic & color codes.
• 🖱️ Interactive Click Actions: Run console/player commands, send custom messages, play sounds, or route players through Velocity/BungeeCord proxy networks upon hologram interaction.
• 💾 Reliable Dual Storage: Choose between blazingly fast, crash-resilient SQLite (WAL Mode) or classic human-readable YAML.
• 🌐 Built-in Localization: Seamless out-of-the-box multi-language support (English en-US & Turkish tr-TR).

---

🖱️ Click Actions

Add powerful interaction pipelines to any hologram line:

Action Type	Syntax	Description
Player Command	[player] /warp spawn	Runs command as the interacting player
Console Command	[console] /give %player% diamond 1	Executes command directly through console
Direct Message	[message] <green>Welcome to the server, %player%!	Sends formatted chat message to the player
Sound	[sound] ENTITY_EXPERIENCE_ORB_PICKUP	Plays an in-game sound effect to the player
Proxy Switch	[server] lobby	Transfers the player via BungeeCord / Velocity

---

📋 Commands & Permissions

Aliases: /zholo · /zh · /hologram
Primary Permission: zenxyhologram.admin (Default: OP)

Command	Description
/zholo create <name>	Creates a new hologram at your current location
/zholo delete <name>	Permanently deletes a hologram
/zholo list	Lists all active holograms
/zholo tp <name>	Teleports directly to the hologram position
/zholo movehere <name>	Moves the hologram to your current location
/zholo addline <name> <text>	Appends a new line (supports MiniMessage & hex)
/zholo setline <name> <index> <text>	Overwrites a specific line
/zholo removeline <name> <index>	Removes the target line
/zholo setscale <name> <index> <scale>	Adjusts line scale / text size
/zholo setbillboard <name> <mode>	Changes billboard mode (CENTER, FIXED, VERTICAL, HORIZONTAL)
/zholo near [radius]	Lists nearby holograms at your location (default: 15 blocks)
/zholo addaction <name> <action>	Adds an interactive click action
/zholo removeaction <name> <index>	Removes an action by index
/zholo listactions <name>	Lists all configured actions on the hologram
/zholo reload	Hot-reloads configuration and holograms

---

⚙️ Configuration Preview

settings:
  # Storage engine: SQLITE (Recommended) or YAML
  storage-type: "SQLITE"

  # Hologram view distance (in blocks)
  render-distance: 48

  # Text refresh interval (in ticks, 20 ticks = 1 second)
  update-interval-ticks: 5

  # Visibility check interval (in ticks)
  culling-interval-ticks: 10

  # Default vertical line spacing (Y-axis)
  default-line-spacing: 0.3

  # Default billboard mode: CENTER, FIXED, VERTICAL, HORIZONTAL
  default-billboard: "CENTER"

  # Packet engine: AUTO, PACKETEVENTS, PROTOCOLLIB, BUKKIT
  protocol-provider: "AUTO"

  # Debug mode (prints developer traces)
  debug: false

  # Language file: en-US or tr-TR
  language: "en-US"