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

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

What's Changed

• Fixed render mode VIEWER_LIST issues

Full Changelog: https://github.com/max1mde/HologramLib/compare/1.6.1...1.6.2.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...1.6.0-ALPHA

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 🙏💀}

• 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

• 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