Skip to content

Powerful, modern packet-based Minecraft hologram library with text, item & block displays, leaderboards, and extensive customization.

License

Notifications You must be signed in to change notification settings

max1mde/HologramLib

Repository files navigation

HologramLib Banner

Discord Wiki JitPack JavaDocs GitHub Downloads

Leave a ⭐ if you like this library :octocat:

Next-Gen Hologram Library for Modern Minecraft Servers

Packet-based • Feature-rich • Developer-friendly


🫨 Features

  • Multi-Type Holograms
    Text • Blocks • Items • Leaderboards

  • Dynamic Content
    Player-specific rendering • 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

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


✈️ Quick Integration

Step 1: Add Dependency

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

dependencies {
    implementation 'com.github.max1mde:HologramLib:1.6.8'
}

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

📕 Learning 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 & Vision

2025

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

Contributions to this repo or the example plugin are welcome!

Live Statistics

img


Used by 50+ servers | 2.000+ downloads across platforms
SpigotMCHangarModrinthLatest ReleaseSupport
License: GPL-3.0 | © 2025 Maxim

About

Powerful, modern packet-based Minecraft hologram library with text, item & block displays, leaderboards, and extensive customization.

Topics

Resources

License

Stars

Watchers

Forks

Contributors 3

  •  
  •  
  •  

Languages