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
| Type | Behaviour |
|---|---|
HAT | Worn in the helmet slot. Supports dyed leather (colour) and glow. |
TRAIL | A 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.