https://github.com/hologramlib/hologramlib
Powerful, modern packet-based Minecraft hologram library with text, item & block displays, leaderboards, and extensive customization.
https://github.com/hologramlib/hologramlib
entitylib hologram java minecraft minimessage packetevents papermc plugin spigot
Last synced: about 1 year ago
JSON representation
Powerful, modern packet-based Minecraft hologram library with text, item & block displays, leaderboards, and extensive customization.
- Host: GitHub
- URL: https://github.com/hologramlib/hologramlib
- Owner: HologramLib
- License: gpl-3.0
- Created: 2023-07-26T18:15:07.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2025-02-22T10:37:29.000Z (over 1 year ago)
- Last Synced: 2025-02-23T12:18:26.777Z (over 1 year ago)
- Topics: entitylib, hologram, java, minecraft, minimessage, packetevents, papermc, plugin, spigot
- Language: Java
- Homepage: https://github.com/max1mde/HologramLib/wiki
- Size: 3.17 MB
- Stars: 30
- Watchers: 2
- Forks: 5
- 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
- **Dynamic Content**
Live animations • MiniMessage formatting • ItemsAdder emojis
- **Advanced Mechanics**
Entity attachment • Per-player visibility • View distance control
---
## ⚙️ Technical Specifications
**Compatibility**
| Server Software | Minecraft Versions |
|-----------------|--------------------------|
| **Paper** | 1.19.4 → 1.21.4 ✔️ |
| **Purpur** | 1.19.4 → 1.21.4 ✔️ |
| **Folia** | 1.19.4 → 1.21.4 ✔️ |
| **Spigot** | 1.19.4 → 1.21.4 ✔️ |
| **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.7.1'
}
```
When using maven you also have to add the following repo:
```xml
evoke-snapshots
https://maven.evokegames.gg/snapshots
true
```
**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
## Contributors
Contributions to this repo or the example plugin are welcome!
| Avatar | Username |
|--------|----------|
| [](https://github.com/maximjsx) | [maximjsx]( https://github.com/maximjsx ) |
| 
| [misieur]( https://github.com/misieur ) |
| [](https://github.com/WhyZerVellasskx) | [WhyZerVellasskx]( https://github.com/WhyZerVellasskx ) |
| [](https://github.com/apps/github-actions) | [github-actions[bot]]( https://github.com/apps/github-actions ) |
| [](https://github.com/matt11matthew) | [matt11matthew]( https://github.com/matt11matthew ) |
Live Statistics
[](https://bstats.org/plugin/bukkit/HologramAPI/19375)
---