UltimateChristmas 4.0 Wiki

UltimateChristmas / Cosmetics

Cosmetics

Festive hats and particle trails — purely visual, picked from a wardrobe menu. Make them free for everyone, gate them behind permissions, or grant them as event rewards.

module id: cosmetics config: modules/cosmetics.yml

How players use it

/christmas cosmetics (permission ultimatechristmas.cosmetics) opens the wardrobe. Clicking equips or unequips. When a hat goes on, the player's real helmet is handed back to their inventory — nothing is lost.

Two kinds

TypeBehaviour
HATWorn in the helmet slot. Supports dyed leather (colour) and glow.
TRAILA particle that follows the player.

Configuration

trails:
  tick-period: 6     # ticks between particle passes
  particles: 3       # particles per pass

hats:
  use-helmet-slot: true

items:
  santa_hat:
    type: HAT
    name: "&c&lSanta Hat"
    material: LEATHER_HELMET
    colour: "#c41e3a"
    free: true                 # everyone owns it

  snow_crown:
    type: HAT
    name: "&b&lSnow Crown"
    material: GOLDEN_HELMET
    glow: true
    permission: ultimatechristmas.cosmetic.snowcrown   # gated

  snowflake_trail:
    type: TRAIL
    name: "&f&lSnowflake Trail"
    material: SNOW_BLOCK       # the wardrobe icon
    particle: SNOWFLAKE
    free: true

  ember_trail:
    type: TRAIL
    name: "&6&lWarm Ember Trail"
    material: CAMPFIRE
    particle: FLAME
    permission: ultimatechristmas.cosmetic.ember

Ownership works three ways, checked in this order: free: true (everyone), a permission node (sell it through LuckPerms), or an explicit grant:

/christmas cosmetics grant <player> <id>     (permission: ultimatechristmas.admin.cosmetics)

Granting from a reward works too — add commands: ["christmas cosmetics grant %player% snow_crown"] to any reward, say a rare advent door or boss drop.