HologramLib / API | Paginated Leaderboards & Custom Hologram

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/downl… Note The wiki was partially updated already New Contributors · @Fedox-die-Ente made their first contribution in #37 Full Changelog: 1.7.7...1.8.0

· Bugfixes · Attachement issues Full Changelog: 1.7.6...1.7.7

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

What's Changed · Improved performance (thanks to @RootException) · Fixed alot of bugs · Async Update Task by @RootException in #32 · Code Cleanup by @RootException in #33 New Contributors · @RootException made their first contribution in #32 Full Changelog: 1.7.3...1.7.4

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 · @matt11matthew made their first contribution in #30 Full Changelog: 1.7.1...1.7.2

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

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

What's Changed · Fixed: Hologram removal issue - #23 · Using BukkitTask for support all platforms by @WhyZerVellasskx in #24 Dependency: com.github.max1mde:HologramLib:1.6.9 Full Changelog: 1.6.8...1.6.9

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-li…

What's Changed New methods in HologramManager · hologramExists(id) · hologramExists(hologram) · getHologramIds() com.github.max1mde:HologramLib:1.6.7

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

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

What's Changed · Fixed shading issues Full Changelog: 1.6.2.1...1.6.3

What's Changed · Fixed render mode VIEWER_LIST issues Full Changelog: 1.6.1...1.6.2.1

What's Changed · Fix: left & right rotation in transformation not being applied Full Changelog: 1.6.1...1.6.2

What's Changed · Renamed interpolationDurationRotation to teleport duration in Hologram · Some smaller fixes & documentation updates Full Changelog: 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 #8 · add: folia support by @WhyZerVellasskx in #12 · fix: initialize folialib by @WhyZerVellasskx in #14 · fix: folialib bugs by @WhyZerVellasskx in #15 Issues solved #11 #7 #6 New Contributors · @WhyZerVellasskx made their first contribution in #12 Full Changelog: 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 info

BREAKING API CHANGES! Removed TestHologram#spawn() HologramAPI#getManager() now returns an optional · 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

· New passenger method

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

· Bugfixes & code improvements

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

· Added alternative hologram manager instance getter (if you shade the api)

· Added bStats