Feature - Markers Module

[ItsNature]

Overview

Description:
Add Marker Module, exposing Lunar Client's in-world Markers mod to servers. Until now markers were purely player-driven (middle-click / keybind); this lets a server place, update, and remove them programmatically, at any location, with per-marker overrides.

Full docs: lunarclient.dev/apollo/developers/modules/marker

Changes:

• Add MarkerModule API
  • displayMarker(Recipients, Marker)
  • removeMarker(Recipients, String)
  • removeMarker(Recipients, Marker)
  • resetMarkers(Recipients)
• Add Marker builder: id, location, ownerId, ownerName, flag, color, target, duration, inGameNotification, chatNotify, middleClickRemove and style
• Add MarkerTarget types describing what is marked: ItemMarkerTarget, BlockMarkerTarget, EntityMarkerTarget and PlayerMarkerTarget
• Add MarkerStyle builder for per-marker appearance: scale, animateMarkerOnHover, compactMode, textShadow, ownerSuffix, ownerDisplay, showOwner, showCoordinates, showDistance, showDescription and descriptionDisplay

Code Example:

  public void displayBlockMarkerExample(Player viewer) {
      Optional<ApolloPlayer> apolloPlayerOpt = Apollo.getPlayerManager().getPlayer(viewer.getUniqueId());

      apolloPlayerOpt.ifPresent(apolloPlayer -> {
          Location location = viewer.getLocation();

          this.markerModule.displayMarker(apolloPlayer, Marker.builder()
              .id("loot-chest")
              .location(ApolloLocation.builder()
                  .world(location.getWorld().getName())
                  .x(location.getX())
                  .y(location.getY())
                  .z(location.getZ())
                  .build())
              .ownerId(viewer.getUniqueId())
              .ownerName("")
              .flag(MarkerFlag.INTEREST)
              .target(BlockMarkerTarget.builder()
                  .itemStack(ItemStackIcon
                      .builder()
                      .itemName("minecraft:chest")
                      .build())
                  .build())
              .duration(Duration.ofSeconds(60))
              .style(MarkerStyle.builder()
                  .showOwner(MarkerDisplayCondition.NEVER)
                  .showDescription(MarkerDisplayCondition.ALWAYS)
                  .build())
              .build()
          );
      });
  }

---

Review Request Checklist

• Your code follows the style guidelines of this project.
• I have performed a self-review of my code.
• I have tested this change myself. (If applicable)
• I have made corresponding changes to the documentation. (If applicable)
• The branch name follows the projects naming conventions. (e.g. feature/add-module & bugfix/fix-issue)

---