Cosmetics

🎨 Overview

Cosmetics allow players to personalize their gameplay experience. ArenaLegends offers several types of cosmetics that are defined in the plugins/ArenaLegends/collectibles/ folder.

Each cosmetic can be unlocked by meeting certain Gem cost or statistic requirements (like total kills), which are configured directly in their respective .yml files.

Types of Cosmetics

Cosmetic Type	Configuration File	Description
Finishers	finishers.yml	Special visual effects that play when you eliminate a player.
Kill Messages	kill-messages.yml	Custom messages shown in chat when a player gets a kill.
Dummy Skins	dummy-skins.yml	Custom player heads that change the appearance of in-game dummies.
Equipment Skins	equipment-skins.yml	Custom textures for items, typically weapons (requires a resource pack).
Kill Counters	kill-counters.yml	Custom items or text displayed above an opponent's head.
Presence Messages	presence-messages.yml	Special messages displayed when a player joins a game.

---

🔧 Configuration Examples

Below are examples of how each cosmetic type is configured. All are located in the collectibles/ folder.

Finishers

finishers.yml contains a list of all available finisher effects.

# collectibles/finishers.yml
SQUID:
  setting:
    enabled: true
    gem-cost: 1500
    stats-required:
      - "name{KILLS} value{250}"
  executor:
    type: SQUID
  icon-builder:
    name: "Squid"
    lore:
      - "&7Paint your victories black..."
    type: INK_SAC

Kill Messages

kill-messages.yml defines different themed messages for kill events.

# collectibles/kill-messages.yml
NINJA:
  setting:
    name: "Ninja"
    gem-cost: 1000
    stats-required:
      - "name{KILLS} value{500}"
  message:
    melee: "&8⚔ &f{VICTIM} &fwas assassinated by {ATTACKER}"
    ranged: "&8⚔ &f{VICTIM} &fwas struck by {ATTACKER}&f's shuriken"

Dummy Skins

dummy-skins.yml uses player head textures to create unique skins for dummy NPCs.

# collectibles/dummy-skins.yml
ENDERMAN:
  setting:
    gem-cost: 1000
    stats-required:
      - "name{KILLS} value{500}"
  skin:
    value: "eyJ0aW1lc3RhbXAi...<base64-texture>...IifX19"
    signature: "otKq+fOlcb3...<base64-signature>...NikU0="
  icon-builder:
    name: "Enderman"
    type: PLAYER_HEAD

Equipment Skins

equipment-skins.yml is used to define categories for item skins. The actual skins are configured elsewhere, but this file groups them.

# collectibles/equipment-skins.yml
category-builder:
  IRON_SWORD:
    name: "Iron Sword"
    type: IRON_SWORD

---

💻 Commands

Use the /al menu command to open the selection screen for each cosmetic type. The menu name usually matches the file name.

• /al menu finishers - Opens the Finishers menu.

• /al menu kill-messages - Opens the Kill Messages menu.

• /al menu dummy-skins - Opens the Dummy Skins menu.

• /al menu equipment-skins - Opens the Equipment Skins menu.

• /al menu kill-counters - Opens the Kill Counters menu.

• /al menu presence-messages - Opens the Presence Messages menu.