HologramLib | Leaderboards & Custom Holograms

The Leaderboard Update

What's Changed

* Add placeholder api support by @Fedox-die-Ente in https://github.com/HologramLib/HologramLib/pull/37 * Leaderboards and more by @maximjsx in https://github.com/HologramLib/HologramLib/pull/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:

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. <a href="https://github.com/HologramLib/HologramLib/releases/downl…"> <img width="160px" src="" alt="Download"/> </a>

[!NOTE]

The wiki was partially updated already

<img width="500" alt="image" src="https://github.com/user-attachments/assets/2752cf34-0f2a-…" />

New Contributors

* @Fedox-die-Ente made their first contribution in https://github.com/HologramLib/HologramLib/pull/37 Full Changelog: https://github.com/HologramLib/HologramLib/compare/1.7.7.…

- Bugfixes - Attachement issues Full Changelog: https://github.com/HologramLib/HologramLib/compare/1.7.6.…

Changes

- Added support for NOT_ATTACHED_PLAYER render mode that excludes attached players from viewing the hologram - Added Hologram#attachToPlayer(Player) Full Changelog: https://github.com/HologramLib/HologramLib/compare/1.7.5.… Also included 1.7.5: * Adding attach and detach methods and setIsInvisible by @misieur in https://github.com/HologramLib/HologramLib/pull/34 * Adding a warning to the attach method in the Hologram class by @misieur in https://github.com/HologramLib/HologramLib/pull/35 * Bugfixes Full Changelog: https://github.com/HologramLib/HologramLib/compare/1.7.4.…

What's Changed

- Improved performance (thanks to @RootException) - Fixed alot of bugs * Async Update Task by @RootException in https://github.com/HologramLib/HologramLib/pull/32 * Code Cleanup by @RootException in https://github.com/HologramLib/HologramLib/pull/33

New Contributors

* @RootException made their first contribution in https://github.com/HologramLib/HologramLib/pull/32 Full Changelog: https://github.com/HologramLib/HologramLib/compare/1.7.3.…

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: https://github.com/max1mde/HologramLib/compare/1.7.0...1.7.1

What's Changed

* Fixed re-appearing issues for holograms * Wrapper entity implementation (EntityLib) by @max1mde in https://github.com/max1mde/HologramLib/pull/26

API Breaking Changes

- Replaced Hologram#nearbyEntityScanningDistance with Hologram#maxPlayerRenderDistanceSquared (Default value is now 62500) Full Changelog: https://github.com/max1mde/HologramLib/compare/1.6.9...1.7.0

What's Changed

- Fixed: Hologram removal issue - https://github.com/max1mde/HologramLib/issues/23 - Using BukkitTask for support all platforms by @WhyZerVellasskx in https://github.com/max1mde/HologramLib/pull/24 Dependency:

com.github.max1mde:HologramLib:1.6.9

Full Changelog: https://github.com/max1mde/HologramLib/compare/1.6.8...1.6.9

What's Changed

- Replaced distance check with distanceSquared in Hologram.java New methods in HologramManager - hologramExists(id) - hologramExists(hologram) - getHologramIds()

com.github.max1mde:HologramLib:1.6.8

Full Changelog: https://github.com/max1mde/HologramLib/compare/1.6.6...1.6.8

What's Changed

- fix: Rendering issues * fix: teleport & addAllViewers in Hologram.java by @max1mde in https://github.com/max1mde/HologramLib/pull/21 Full Changelog: https://github.com/max1mde/HologramLib/compare/1.6.4...1.6.6

What's Changed

- Fixed shading issues Full Changelog: https://github.com/max1mde/HologramLib/compare/1.6.2.1...…

What's Changed

- Fixed render mode VIEWER_LIST issues Full Changelog: https://github.com/max1mde/HologramLib/compare/1.6.1...1.…

What's Changed

- Fix: left & right rotation in transformation not being applied Full Changelog: https://github.com/max1mde/HologramLib/compare/1.6.0...1.6.2

What's Changed

- Renamed interpolationDurationRotation to teleport duration in Hologram - Some smaller fixes & documentation updates Full Changelog: https://github.com/max1mde/HologramLib/compare/1.6.0...1.6.1

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+) * feat: item and block holograms by @max1mde in https://github.com/max1mde/HologramLib/pull/8 * add: folia support by @WhyZerVellasskx in https://github.com/max1mde/HologramLib/pull/12 * fix: initialize folialib by @WhyZerVellasskx in https://github.com/max1mde/HologramLib/pull/14 * fix: folialib bugs by @WhyZerVellasskx in https://github.com/max1mde/HologramLib/pull/15

Issues solved

https://github.com/max1mde/HologramLib/issues/11 https://github.com/max1mde/HologramLib/issues/7 https://github.com/max1mde/HologramLib/issues/6

New Contributors

* @WhyZerVellasskx made their first contribution in https://github.com/max1mde/HologramLib/pull/12 Full Changelog: https://github.com/max1mde/HologramLib/compare/1.5.3.2...…

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](https://github.com/max1mde/HologramLib/compare/1.4.8...1.… _{I swear this is the last time I make such breaking changes}

- Copy hologram methods HologramManager#copyHologram(TextHologram source) HologramManager#copyHologram(TextHologram source, String id) - More comments Full Changelog: https://github.com/max1mde/HologramAPI/compare/1.4.7...1.4.8

BREAKING API CHANGES!

- New hologram generation methods <img src="https://github.com/user-attachments/assets/68b8ded4-c307-…" width="400"> - 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

- Downgrade from JDK 21 to JDK 17 - Downgrade to spigot 1.19.4 - Update packetevents & entitylib version

- Bug fixes & code improvements

- Text animations - Minimessage support - Packet based - Per player holograms - ItemsAdder emoji support