Cosmetic Types

Cosmetic Types

CelestialCosmetics has 14 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
Custom Stat 1/2/3	customstat1/2/3	Same as Rebirth, but pointed at any placeholder you choose	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
Leave Message	leavemessage	A custom styled leave broadcast	Leave 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 / Leave Message / Chat Emoji

Each has its own page: Glows, Join Messages, Leave 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%.

Custom Stat 1 / 2 / 3

Three extra slots that work exactly like Rebirth Color — same prefix/text/suffix/gradient/bold styling, same in-game creation wizard, same rank-default support — but each one is pointed at whatever placeholder you configure, independently. They ship completely empty on purpose: nothing shows up until you set a source placeholder for a slot.

Use these when you have a second (or third) progression stat you want displayed alongside Rebirth — for example a rankup/prestige value from a different plugin.

# config.yml
customstat1-enabled: true
customstat1-source-placeholder: '%pinnaprison_leveling_balance_rankup%'
customstat1-default-style: rankup_simple

# cosmetics/customstat1.yml
customstat1-styles:
  rankup_simple:
    display: '&bRankup'
    icon: EMERALD
    permission: celestial.cosmetics.customstat1.rankup_simple
    prefix: '&b['
    text: '{value}'              # {value} = the resolved source placeholder
    suffix: '&b]'

Exposed via %celestial_customstat1% (and 2/3) — place it anywhere in your chat format, e.g. right after %celestial_rebirth%:

"%celestial_rebirth% %celestial_customstat1% %celestial_namecolor%{name} ..."

Each slot has its own categories-enabled.customstatN, customstatN-enabled (legacy-style toggle, same pattern as rebirth-enabled), customstatN-source-placeholder, and customstatN-default-style. Config file: cosmetics/customstatN.yml, same shape as rebirth.yml.

Not unlimited. These are 3 fixed slots, not a dynamic/unlimited system — the underlying storage keeps one equipped selection per cosmetic type, so a true "unlimited custom placeholders" system would need a deeper data-layer change. 3 slots comfortably covers a second and third progression stat with room to spare.

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