https://github.com/HologramLib/HologramLib
Minecraft hologram library / api with text, item & block displays, leaderboards, and extensive customization. packet-based, modern & easy to use.
https://github.com/HologramLib/HologramLib
entitylib hologram java minecraft minimessage packetevents papermc plugin spigot
Last synced: about 2 months ago
JSON representation
Minecraft hologram library / api with text, item & block displays, leaderboards, and extensive customization. packet-based, modern & easy to use.
- Host: GitHub
- URL: https://github.com/HologramLib/HologramLib
- Owner: HologramLib
- License: gpl-3.0
- Created: 2023-07-26T18:15:07.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2025-08-07T18:21:00.000Z (2 months ago)
- Last Synced: 2025-08-07T18:30:40.487Z (2 months ago)
- Topics: entitylib, hologram, java, minecraft, minimessage, packetevents, papermc, plugin, spigot
- Language: Java
- Homepage: https://github.com/HologramLib/HologramLib/wiki
- Size: 3.27 MB
- Stars: 40
- Watchers: 2
- Forks: 14
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://discord.gg/2UTkYj26B4)
[](https://github.com/HologramLib/HologramLib/wiki)
[](https://jitpack.io/#HologramLib/HologramLib)
[](https://HologramLib.github.io/HologramLib/)
[](https://github.com/HologramLib/HologramLib/releases)
Leave a :star: if you like this library :octocat:
Display Entity Based Hologram Library for Modern Minecraft Servers
Packet-based • Feature-rich • Developer-friendly
---
1. [Installation](https://github.com/HologramLib/HologramLib/wiki/1.-Installation)
2. [Getting Started](https://github.com/HologramLib/HologramLib/wiki/2.-Getting-Started)
- [Creating Holograms](https://github.com/HologramLib/HologramLib/wiki/3.-Creating-Holograms)
- [Hologram Management](https://github.com/HologramLib/HologramLib/wiki/4.-Hologram-Management)
- [Leaderboards](https://github.com/HologramLib/HologramLib/wiki/5.-Leaderboards)
- [Animations](https://github.com/HologramLib/HologramLib/wiki/6.-Animations)
## 🫨 Features
- **Multi-Type Holograms**
Text • Blocks • Items • Leaderboards • Paginated Leaderboards
- **Dynamic Content**
Live animations • MiniMessage formatting • ItemsAdder emojis • PlaceholderAPI
- **Advanced Mechanics**
Entity attachment • Per-player visibility • View distance control
---
## ⚙️ Technical Specifications
**Compatibility**
| Server Software | Minecraft Versions |
|-----------------|--------------------------|
| **Paper** | 1.19.4 → 1.21.5 ✔️ |
| **Purpur** | 1.19.4 → 1.21.5 ✔️ |
| **Folia** | 1.19.4 → 1.21.5 ✔️ |
| **Spigot** | ❌ Not supported |
| **Bedrock** | ❌ Not supported |
| **Legacy** | ❌ (1.8 - 1.19.3) |
**Dependencies**
- [PacketEvents](https://www.spigotmc.org/resources/80279/) (Required)
If you want to learn how to use HologramLib in your plugin, check out the detailed guide here:
👉 [HologramLib Wiki](https://github.com/HologramLib/HologramLib/wiki)
---
## ✈️ Quick Integration
**Step 1: Add Dependency**
```gradle
repositories {
maven { url 'https://jitpack.io' }
}
dependencies {
implementation 'com.github.maximjsx:HologramLib:1.8.0'
}
```
**Step 2: Basic Implementation**
```java
HologramManager manager = HologramAPI.getManager().get();
TextHologram hologram = new TextHologram("unique_id")
.setMiniMessageText("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);
```
---
## 📕 Learning Resources
| Resource | Description |
|----------|-------------|
| [📖 Complete Wiki](https://github.com/HologramLib/HologramLib/wiki) | Setup guides • Detailed examples • Best practices |
| [💡 Example Plugin](https://github.com/HologramLib/ExamplePlugin) | Production-ready implementations |
| [🎥 Tutorial Series](https://github.com/HologramLib/HologramLib) | Video walkthroughs (Coming Soon) |
---
## 😎 Featured Implementations
- **TypingInChat** ([Modrinth](https://modrinth.com/plugin/typinginchat-plugin)) - Real-time typing visualization
*[Your Project Here 🫵]* - Submit via PR or Discord!
---
## 👁️ Roadmap & Vision
**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 |
|--------|----------|
| [](https://github.com/maximjsx) | [maximjsx]( https://github.com/maximjsx ) |
| [](https://github.com/Fedox-die-Ente) | [Fedox-die-Ente]( https://github.com/Fedox-die-Ente ) |
| 
| [misieur]( https://github.com/misieur ) |
| [](https://github.com/WhyZerVellasskx) | [WhyZerVellasskx]( https://github.com/WhyZerVellasskx ) |
| [](https://github.com/RootException) | [RootException]( https://github.com/RootException ) |
| [](https://github.com/matt11matthew) | [matt11matthew]( https://github.com/matt11matthew ) |
**Used by:**
| Server | |
|--------|----------|
| [rangemc]( https://www.rangemc.net/ ) | 
|
Live Statistics
[](https://bstats.org/plugin/bukkit/HologramAPI/19375)
---