Skip to content

Cosmetic Types

Araaxyss edited this page Aug 1, 2026 · 3 revisions

Cosmetic Types

CelestialCosmetics has 10 cosmetic categories (plus Sets, which bundle them). Each is defined in its own file and can be toggled on/off in config.yml under categories-enabled.

Type <type> id What it does Page
Tag tag Chat tag next to the name this page
Rebirth Color rebirth Styles a dynamic prestige/level value this page
Name Color namecolor Colors the player's name this page
Rank Effect rankcolor The color/effect applied to the rank background Rank System
Rank Background rankbg The plate image behind the rank Rank Backgrounds
Chat Color chatcolor Colors the player's chat message this page
Emoji emoji A glyph shown after the tag this page
Glow glow A colored glowing outline Glows
Join Message joinmessage A custom styled join broadcast Join Messages
Chat Emoji chatemoji :shortcode: glyphs typed inline in chat Chat Emojis

Every cosmetic is a real, stackable, ownable item — see Vault & Trading.

Tags

Shown in chat next to the name via %celestial_tag%.

# tags.yml
tags:
  dragon:
    display: "&#fc6c00Dragon"                          # shown in menus
    value: "&#fc0000&l[&#fc6c00&lDRAGON&#fc0000&l]"   # shown in chat
    icon: DRAGON_HEAD
    permission: celestial.cosmetics.tag.dragon

Name Color

Colors the player's name via %celestial_namecolor%. Falls back to namecolor-default in config.yml.

# namecolors.yml
name-colors:
  gold:
    display: "&6Gold"
    value: "&6"
    icon: GOLD_INGOT
    permission: celestial.cosmetics.namecolor.gold

Chat Color

Colors the player's whole message via %celestial_chatcolor%. Falls back to chatcolor-default.

# chatcolors.yml
chat-colors:
  aqua:
    display: "&bAqua"
    value: "&b"
    icon: LIGHT_BLUE_DYE
    permission: celestial.cosmetics.chatcolor.aqua

Emoji

A glyph shown right after the tag, via %celestial_emoji%. value can be any Unicode glyph (vanilla font symbols, or ItemsAdder glyphs).

# emojis.yml
emojis:
  heart:
    display: "&cHeart"
    value: ""
    icon: RED_DYE
    permission: celestial.cosmetics.emoji.heart

Rank Effect & Rank Background

These two power the layered rank display. The effect (rankcolor) is a color/shader code; the background (rankbg) is the plate image it tints. Full docs: The Rank System and Rank Backgrounds.

Glow / Join Message / Chat Emoji

Each has its own page: Glows, Join Messages, Chat Emojis.

Rebirth Color

Styles a dynamic number (by default an EdDungeons rebirth/prestige level, but the source placeholder is configurable). Disabled by default in the vanilla build (it needs an external level placeholder).

# rebirth.yml
rebirth-styles:
  classic:
    display: "&6Classic"
    icon: BLAZE_POWDER
    permission: celestial.cosmetics.rebirth.classic
    prefix: "&6[&e"
    text: "R{value}"              # {value} = the resolved source placeholder
    suffix: "&6]"
    gradient: ["#fcd700", "#6cfc00"]   # optional per-character gradient over `text`

Set the source in config.yml (rebirth-source-placeholder). Exposed via %celestial_rebirth%.

Icons: Custom Model Data & Player Heads

Every icon: accepts a vanilla Material, or PLAYER_HEAD + a texture: value (paste any base64 Value from minecraft-heads.com). custom-model-data is supported on menu buttons for resource-pack servers — see GUI Customization.

Descriptions

Any cosmetic can override its lore with a description: list; otherwise the messages.yml template is used.


Next: The Rank System

Clone this wiki locally