HologramLib / API | Paginated Leaderboards & Custom Holograms [1.19.4 - 1.21.x] ⚡ Java Library icon

HologramLib / API | Paginated Leaderboards & Custom Holograms [1.19.4 - 1.21.x] ⚡ Java Library -----

Packet-based text display library / api with animations, leaderboards, emojis, and more!





[​IMG]

LEADERBOARDS

What's Changed

  • Add placeholder api support by @Fedox-die-Ente in #37
  • Leaderboards and more by @maximjsx in #40
    • Introduced interactive hologram entities "InteractionBox" that respond to player interactions.
    • Added customizable, multi-page leaderboard holograms with player head support and flexible formatting.
    • Added player head rendering and caching utilities with asynchronous skin and head retrieval.
Breaking Changes in the API
If you are already using HologramLib's leaderboards, you MUST update your plugin before updating HologramLib on your server ⚠️
Everything regarding Leaderboards is new including imports!

Here is a small example:

Code (Java):
Map <UUID, LeaderboardHologram. PlayerScore > scores = new HashMap <> ( ) ;

LeaderboardHologram. LeaderboardOptions pvpOptions = LeaderboardHologram. LeaderboardOptions. builder ( )
       . title ( "PvP Champions" )
       . suffix ( "Kills" )
       . showEmptyPlaces ( false )
       . maxDisplayEntries ( 10 )
       . sortOrder (LeaderboardHologram. SortOrder. DESCENDING )
       . headMode (LeaderboardHologram. HeadMode. RESOURCEPACK )
       . leaderboardType (LeaderboardHologram. LeaderboardType. ALL_PLAYER_HEADS )
       . build ( ) ;

LeaderboardHologram pvpLeaderboard = new LeaderboardHologram (pvpOptions, "pvp_lb" ) ;
pvpLeaderboard. setAllScores (scores ) ;

/* You can combine the leaderboard with others in a paginated leaderboard
but you can also just spawn the pvpLeaderboard for example
directly using hologramManager.spawn(pvpLeaderboard, location)
*/

PagedLeaderboard pagedLeaderboard = new PagedLeaderboard ( "paged_holo" )
       . addPage (pvpLeaderboard )
       . addPage ( <... another page > )
       . setArrowBackgrounds (pvpLeaderboard. getBackgroundHologram ( ). getBackgroundColor ( ) )
       . setLeftArrowText ( "<red><<" )
       . setRightArrowText ( "<red>>>" )
       . setArrowOffset ( 3.5 )
       . setClickSounds (Sound. BLOCK_AMETHYST_CLUSTER_FALL, Sound. BLOCK_AMETHYST_CLUSTER_FALL )
       . addPage (economyLeaderboard )
       . rotate ( 0 ) ;
hologramManager. spawn (pagedLeaderboard, location ) ;
 
For the resourcepack option you also need the resourcepack zip file from below on your server.
https://github.com/HologramLib/HologramLib/releases/download/1.8.0/HologramLib.Resourcepack.zip

Note

The wiki was partially updated already

New Contributors
Full Changelog: 1.7.7...1.8.0
----------, Sep 3, 2025

  • Bugfixes
    • Attachement issues
Full Changelog: 1.7.6...1.7.7
----------, Jul 10, 2025

What's Changed
  • Added support for NOT_ATTACHED_PLAYER render mode that excludes attached players from viewing the hologram
  • Added Hologram#attachToPlayer(Player)
Full Changelog: 1.7.5...1.7.6

Skipped release 1.7.5:
  • Adding attach and detach methods and setIsInvisible by @misieur in #34
  • Adding a warning to the attach method in the Hologram class by @misieur in #35
  • Bugfixes
Full Changelog: 1.7.4...1.7.5
----------, Jul 9, 2025

What's Changed
New Contributors
Full Changelog: 1.7.3...1.7.4
----------, May 22, 2025

What's Changed
  • Persistant holograms (not fully tested yet)

  • Add brightness option for all holograms

  • feat: addonlib implementation by @maximjsx in #29

  • Fix bug which causes this to conflict with other plugins using entity lib by @matt11matthew in #30
New Contributors
Full Changelog: 1.7.1...1.7.2
----------, Mar 10, 2025

What's Changed
  • Add back Hologram#getViewers() and also an additional method Hologram#getViewerUUIDs() which is more efficient and just returns the viewers as UUID's
Full Changelog: 1.7.0...1.7.1
----------, Feb 18, 2025

What's Changed
  • Fixed re-appearing issues for holograms
  • Wrapper entity implementation (EntityLib) by @max1mde in #26
API Breaking Changes
  • Replaced Hologram#nearbyEntityScanningDistance with Hologram#maxPlayerRenderDistanceSquared (Default value is now 62500)
Full Changelog: 1.6.9...1.7.0
----------, Feb 16, 2025

What's Changed
Dependency:

com.github.max1mde:HologramLib:1.6.9

Full Changelog: 1.6.8...1.6.9
----------, Feb 12, 2025

What's Changed
  • Replaced distance check with distanceSquared in Hologram.java
com.github.max1mde:HologramLib:1.6.8

Full Changelog: 1.6.7...1.6.8

https://www.spigotmc.org/threads/ho...-4-1-21-x-⚡-java-library.614480/#post-4819961
----------, Jan 22, 2025

What's Changed
New methods in HologramManager

  • hologramExists(id)
  • hologramExists(hologram)
  • getHologramIds()
com.github.max1mde:HologramLib:1.6.7
----------, Jan 21, 2025

What's Changed
  • fix: Rendering - update implementation
  • fix: teleport & addAllViewers in Hologram.java by @max1mde in #21
Full Changelog: 1.6.4...1.6.6
----------, Jan 20, 2025

What's Changed
  • Add new option for modifying the entity meta based on the player
    • This means that for example a text of a hologram can be differently displayed for each player
Example
Code (Java):
       TextHologram textHologram = new TextHologram ( "test", RenderMode. ALL, (player, textDisplayMeta ) -> {
           textDisplayMeta. setText ( Component. text (player. getName ( ) ) ) ;
            return textDisplayMeta ;
        } )
       . setShadow ( true )
       . setBillboard (Display. Billboard. CENTER ) ;

Full Changelog: 1.6.3...1.6.4
----------, Jan 13, 2025

What's Changed
  • Fixed shading issues
Full Changelog: 1.6.2.1...1.6.3
----------, Jan 9, 2025

What's Changed
  • Fixed render mode VIEWER_LIST issues
Full Changelog: 1.6.1...1.6.2.1
----------, Dec 29, 2024

What's Changed
  • Fix: left & right rotation in transformation not being applied
Full Changelog: 1.6.1...1.6.2
----------, Dec 29, 2024

What's Changed
  • Renamed interpolationDurationRotation to teleport duration in Hologram
  • Some smaller fixes & documentation updates
Full Changelog: 1.6.0...1.6.1
----------, Dec 28, 2024

What's Changed
Item & Block holograms can be spawned now through the HologramManager
A top player head can be enabled in the leaderboard hologram (Skin currently only applied on 1.20.5+)

[​IMG]
Issues solved
#11
#7
#6

New Contributors
Full Changelog: 1.5.3.2...1.6.0-ALPHA
----------, Dec 27, 2024

Breaking Changes in the API ‼️
All references to HologramAPI have been renamed to HologramLib.

Please update your imports:
  • From: com.maximde.hologramapi
  • To: com.maximde.hologramlib
Update the main class:
  • From: com.maximde.hologramapi.HologramAPI
  • To: com.maximde.hologramlib.HologramLib
Full Changelog: 1.4.8...1.5.0

I swear this is the last time I make such breaking changes
----------, Dec 22, 2024

  • Copy hologram methods
    HologramManager#copyHologram(TextHologram source)
    HologramManager#copyHologram(TextHologram source, String id)
More info
----------, Dec 21, 2024

BREAKING API CHANGES!
Removed TestHologram#spawn()
HologramAPI#getManager() now returns an optional


  • New hologram generation methods
[​IMG]
  • Hologram attachement (passenger) method
  • Shading is now possible (In theory)
  • Fixed rendering (Holograms respawn again when rejoining area / world / server)
  • https://github.com/max1mde/HologramAPI/issues/2
  • Improved internal instance management
----------, Dec 15, 2024

  • New passenger method
----------, Dec 13, 2024

  • Downgrade from JDK 21 to JDK 17
  • Downgrade to spigot 1.19.4
  • Update packetevents & entitylib version
----------, Nov 17, 2024

  • Bugfixes & code improvements
----------, Jun 23, 2024

  • Text animations
  • Minimessage support
  • Packet based
  • Per player holograms
  • ItemsAdder emoji support
----------, Jun 22, 2024

  • Added alternative hologram manager instance getter (if you shade the api)
----------, Aug 4, 2023

  • Added bStats
----------, Aug 3, 2023

Resource Information
Author:
----------
Total Downloads: 2,708
First Release: Aug 3, 2023
Last Update: Sep 3, 2025
Category: ---------------
All-Time Rating:
1 ratings
Find more info at github.com...
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings