What's Changed

• Bump depdendency versions
• Bug fixes

Skipped releases on Modrinth:

• 1.8.2 Better number formatting in leaderboards by @RootException in #41
• 1.8.1 Dependency updates Updated version of FoliaLib Updated version of packetevents Updated version of EntityLib

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.

[!NOTE]
The wiki was partially updated already

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

• Bugfixes
  • Attachement issues

Full Changelog: https://github.com/HologramLib/HologramLib/compare/1.7.6...1.7.7

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

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

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