Rank Backgrounds

Rank Backgrounds

A Rank Background is the "plate" image drawn behind the rank text (see The Rank System). It's a full cosmetic type (rankbg) — owned in the vault, equipped from /cosmetics, restrictable per rank.

The chosen Rank Effect tints the background, so the same background can look different per effect. Keep backgrounds light/greyscale if you want effects to recolor them cleanly.

Configuration (rank-backgrounds.yml)

rank-backgrounds:
  plate_short:
    display: '&fShort Plate'
    value: '𞄊'                # the ItemsAdder background glyph
    ranks: [owner, admin]      # OPTIONAL: only these ranks may use it
    icon: ITEM_FRAME
    permission: celestial.cosmetics.rankbg.plate_short
  plate_wide:
    display: '&fWide Plate'
    value: '𞄒'
    ranks: [manager, srmod]    # a wider plate, only for long-named ranks
    icon: WHITE_BANNER
    permission: celestial.cosmetics.rankbg.plate_wide

Field	Meaning
display	name shown in the menu
value	the ItemsAdder background glyph
ranks	(optional) LuckPerms groups allowed to use this background
icon	menu icon (Material, or PLAYER_HEAD + texture:)
permission	defaults to celestial.cosmetics.rankbg.<id>

Per-rank restriction

Because backgrounds are sized to fit a rank's text width, a narrow plate won't fit a long rank like MANAGER. The optional ranks: list controls who can use each background:

• Empty / omitted → every rank may use it.
• With ranks → the background is hidden in the menu for other ranks, can't be equipped by them, and is never shown even if somehow selected.

Per-rank default background

Every rank also has its own default background in rankcolors.yml (rank-color.ranks.<group>.background), used when the player hasn't equipped one. The entries here are the extra backgrounds a player can equip on top of that default.

Resolution order for the background actually shown:

equipped RANKBG (if allowed for the rank)  →  the rank's default background  →  global default-background

Equipping & giving

• Players: open /cosmetics → Rank Background → click one you own.
• Admins: /cosmetics give <player> rankbg <id> (a real, tradeable copy) or /cosmetics set <player> rankbg <id> (force-equip).

Backgrounds are earned like any other cosmetic — via Crates, given by an admin, or granted by permission.

---

Next: Glows