HologramLib

<div align="center"> <img width="650px" src="assets/banner.png" alt="HologramLib Banner">

<p>Leave a :star: if you like this library :octocat:</p> <h3>Display Entity Based Hologram Library</h3> <p>Packet-based • Feature-rich • Developer-friendly</p> </div>

---

1. Installation
2. Getting Started
   • Creating Holograms
   • Hologram Management
   • Leaderboards
   • Animations

<a href="https://github.com/HologramLib/HologramLib/releases/download/1.8.3/HologramLib-1.8.3.jar"> <img width="200px" src="https://github.com/HologramLib/Addons/blob/main/download_jar.svg" alt="Download"/> </a>

Features

• Types
  Text • Blocks • Items • Leaderboards • Paginated Leaderboards

• Dynamic Content
  Live animations • MiniMessage formatting • ItemsAdder emojis • PlaceholderAPI

• Mechanics
  Entity attachment • Per-player visibility • View distance control

---

⚙️ Technical Specifications

Compatibility
| Software | Versions | |-----------------|--------------------------| | Paper | 1.19.4 → 1.21.8 ✔️ | | Purpur | 1.19.4 → 1.21.8 ✔️ | | Folia | 1.19.4 → 1.21.8 ✔️ | | Spigot | ❌ Not supported | | Bedrock | ❌ Not supported | | Legacy | ❌ (1.8 - 1.19.3) |

Dependencies

• PacketEvents (Required)

If you want to learn how to use HologramLib in your plugin, check out the detailed guide here:
👉 HologramLib Wiki

---

Integration

Step 1: Add Dependency

repositories {
    maven { url 'https://jitpack.io' }
}

dependencies {
    implementation 'com.github.HologramLib:HologramLib:1.8.5'
}

Step 2: Basic Implementation

HologramManager manager = HologramAPI.getManager().get();

TextHologram hologram = new TextHologram("unique_id")
    .setMiniMessageText("<aqua>Hello world!")
    .setSeeThroughBlocks(false)
    .setShadow(true)
    .setScale(1.5F, 1.5F, 1.5F)
    .setTextOpacity((byte) 200)
    .setBackgroundColor(Color.fromARGB(60, 255, 236, 222).asARGB())
    .setMaxLineWidth(200);

manager.spawn(hologram);

---

Resources

<img width="536px" src="https://github.com/user-attachments/assets/e4d108d3-e6cb-4d33-b91b-aa989e5e4475" alt="HologramLib Banner">

| Resource | Description | |----------|-------------| | 📖 Complete Wiki | Setup guides • Detailed examples • Best practices | | 💡 Example Plugin | Production-ready implementations | | 🎥 Tutorial Series | Video walkthroughs (Coming Soon) |

---

Featured Implementations

• TypingInChat (Modrinth) - Real-time typing visualization

[Your Project Here 🫵] - Submit via PR or <a href="https://discord.gg/2UTkYj26B4">Discord</a>!

---

Roadmap

2026

• Switch from resourcepack to playerhead components
• Switch back to single text holograms for leaderboards - dont split lines
• More options for leaderboard holograms
• Interactive holograms
• Improved animation system
• Persistant holograms
• • Particle-effect holograms

[!WARNING] Persistant holograms & the addon system are still experimental features

Contributors

Contributions to this repo or the example plugin are welcome!

<!-- CONTRIBUTORS:START -->

| Avatar | Username | |--------|----------| | | maximjsx | | | feeeedox | | <img src="https://avatars.githubusercontent.com/u/153451816?v=4" width="50" /> | misieur | | | WhyZerVellasskx | | | RootException | | | parallela | | | matt11matthew |

<!-- CONTRIBUTORS:END -->

Used by: | Server | | |--------|----------| | rangemc | <img src="https://github.com/user-attachments/assets/c65bc715-02da-4c69-94f7-7c3b96ab9d14" width="50" /> | | hysteria | <img src="https://github.com/user-attachments/assets/de4eaf62-267b-4b11-95e2-7e3ad275c0cc" width="50" /> |

<div align="center">^{Live Statistics}</div>

---

<div align="center">

<a alt="o7studios" href="https://o7.studio"><img src="https://i.imgur.com/pniirmi.png"></a>

_{Used by 100+ servers | 10,000+ downloads across platforms}<br> <a href="https://www.spigotmc.org/resources/111746/">SpigotMC</a> • <a href="https://hangar.papermc.io/maximjsx/HologramLib">Hangar</a> • <a href="https://modrinth.com/plugin/hologramlib">Modrinth</a> • <a href="https://maximjsx.com/projects/hologramlib">Maxim.jsx</a> • <a href="https://github.com/HologramLib/HologramLib/releases/latest">Latest Release</a> • <a href="https://discord.gg/2UTkYj26B4">Support</a><br> _{License: GPL-3.0 | © 2026 <a href="https://github.com/maximjsx/">Maxim</a>}

</div>