Leave a ⭐ if you like this library

Display Entity Based Hologram Library

Packet-based • Feature-rich • Developer-friendly

---

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

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.maximjsx:HologramLib:1.8.1'
}

Step 2: Basic Implementation

HologramManagermanager = HologramAPI.getManager().get();
TextHologramhologram = newTextHologram("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

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 Discord!

---

Roadmap

2025

• Particle-effect holograms
• Interactive holograms
• Improved animation system
• Persistant holograms
• PlaceholderAPI

Warning

Persistant holograms & the addon system are still experimental features

Contributors

Contributions to this repo or the example plugin are welcome!

Avatar	Username
	maximjsx
	Fedox-die-Ente
	misieur
	WhyZerVellasskx
	RootException
	matt11matthew

Used by:

Server
rangemc

^{Live Statistics}

---

_{Used by 80+ servers | 7,000+ downloads across platforms}
SpigotMC • Hangar • Modrinth • Maxim.jsx • Latest Release • Support
_{License: GPL-3.0 | © 2025 Maxim}