Team Example Improvements

[ItsNature]

Overview

Description:
Updates the TeamMember object by making certain fields optional. This allows the server to include only the relevant data for each viewer, depending on context.

Changes:

• TeamMember fields displayName, markerColor, and location are now optional
  • displayName: If not provided, only the marker is displayed.
  • markerColor: If not provided, the default color 0xFFFFFFFF is used.
  • location: The provided location is only used when the player is out of render distance for the observer. If you know that the players are close, you don't need to send the location.

Code Example (If applicable):

private TeamMember createTeamMember(Player player, boolean withinPlayerTrackingRange) {
    TeamMember.TeamMemberBuilder builder = TeamMember.builder()
        .playerUuid(player.getUniqueId())
        .markerColor(Color.WHITE);

    if (!withinPlayerTrackingRange) {
        Location location = player.getLocation();

        builder.location(ApolloLocation.builder()
            .world(location.getWorld().getName())
            .x(location.getX())
            .y(location.getY())
            .z(location.getZ())
            .build());

        builder.displayName(Component.text()
            .content(player.getName())
            .color(NamedTextColor.WHITE)
            .build());
    }

    return builder.build();
}

public void refresh() {
    for (Player viewer : this.members.values()) {
        Optional<ApolloPlayer> apolloPlayerOpt = Apollo.getPlayerManager().getPlayer(viewer.getUniqueId());
        if (!apolloPlayerOpt.isPresent()) {
            continue;
        }

        List<TeamMember> teammates = new ArrayList<>();

        for (Player member : this.members.values()) {
            if (viewer == member) {
                continue;
            }

            if (!viewer.canSee(member)) {
                continue;
            }

            if (!viewer.getWorld().getName().equals(member.getWorld().getName())) {
                continue;
            }

            boolean withinPlayerTrackingRange = this.isWithinPlayerTrackingRange(viewer, member);
            teammates.add(this.createTeamMember(member, withinPlayerTrackingRange));
        }

        apolloPlayerOpt.ifPresent(apolloPlayer -> {
            TeamApiExample.this.teamModule.updateTeamMembers(apolloPlayer, teammates);
        });
    }
}

private boolean isWithinPlayerTrackingRange(Player viewer, Player member) {
    double maxDistance = 96;
    double dx = viewer.getLocation().getX() - member.getLocation().getX();
    double dz = viewer.getLocation().getZ() - member.getLocation().getZ();

    return (dx * dx + dz * dz) <= (maxDistance * maxDistance);
}

---

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)

---