Feature - Cosmetics Module

[ItsNature]

Overview

Description:
Adds a new Cosmetic module, servers can equip and unequip cosmetics on Player NPCs (with per-type display options for hats, cloaks, pets and body cosmetics), and can place, remove, and reset sprays in the world.

Changes:

• New CosmeticModule API
  • equipNpcCosmetics(Recipients, UUID npcUuid, List<Cosmetic>)
  • unequipNpcCosmetics(Recipients, UUID npcUuid, List<Integer> cosmeticIds)
  • resetNpcCosmetics(Recipients, UUID npcUuid)
  • displaySpray(Recipients, Spray)
  • removeSpray(Recipients, int sprayId) and removeSpray(Recipients, int sprayId, ApolloBlockLocation)
  • resetSprays(Recipients)
• New builders:
  • Cosmetic: pair a Lunar Client cosmetic id with optional CosmeticOptions.
  • Spray: block location, facing direction, rotation , duration.
  • HatOptions, CloakOptions, PetOptions, BodyOptions for per-type tuning (e.g. showOverHelmet, useClothPhysics, flipShoulder, height offsets).

Code Example:

public void equipNpcCosmeticsExample(Player viewer, UUID npcUuid) {
    List<Cosmetic> cosmetics = Lists.newArrayList(
        Cosmetic.builder()
            .id(434)
            .build(),
        Cosmetic.builder()
            .id(5095)
            .options(PetOptions.builder()
                .flipShoulder(true)
                .build())
            .build(),
        Cosmetic.builder()
            .id(3)
            .options(CloakOptions.builder()
                .useClothPhysics(true)
                .build())
            .build()
    );

    Optional<ApolloPlayer> apolloPlayerOpt = Apollo.getPlayerManager().getPlayer(viewer.getUniqueId());
    apolloPlayerOpt.ifPresent(apolloPlayer ->
        this.cosmeticModule.equipNpcCosmetics(apolloPlayer, npcUuid, cosmetics));
}

public void displaySprayExample(Player viewer, int sprayId, Block block, BlockFace face) {
    Spray spray = Spray.builder()
        .sprayId(sprayId)
        .location(ApolloBlockLocation.builder()
            .world(block.getWorld().getName())
            .x(block.getX()).y(block.getY()).z(block.getZ())
            .build())
        .facing(Direction.values()[face.ordinal()])
        .rotation(0f)
        .duration(Duration.ofSeconds(30))
        .build();

    Optional<ApolloPlayer> apolloPlayerOpt = Apollo.getPlayerManager().getPlayer(viewer.getUniqueId());
    apolloPlayerOpt.ifPresent(apolloPlayer -> this.cosmeticModule.displaySpray(apolloPlayer, spray));
}

---

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)

---