Skip to content

Minecraft hologram library / api with text, item & block displays and crazy leaderboards. packet-based, performant & easy to use.

License

Notifications You must be signed in to change notification settings

HologramLib/HologramLib

Repository files navigation

HologramLib Banner

Discord Wiki JitPack JavaDocs GitHub Downloads

Leave a ⭐ if you like this library :octocat:

Display Entity Based Hologram Library

Packet-based • Feature-rich • Developer-friendly


  1. Installation
  2. Getting Started
Download

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

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.3.2'
}

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

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

img


Used by 80+ servers | 7,000+ downloads across platforms
SpigotMCHangarModrinthMaxim.jsxLatest ReleaseSupport
License: GPL-3.0 | © 2025 Maxim

About

Minecraft hologram library / api with text, item & block displays and crazy leaderboards. packet-based, performant & easy to use.

Topics

Resources

License

Stars

Watchers

Forks

Contributors 9

Languages