OBSIDREL / DOCS

Documentation

Guides, tutorials and technical references for the Obsidrel ecosystem.

DocumentationCosmetics: appearance, conditions and Actions

Cosmetics: appearance, conditions and Actions

Cosmetics live in plugins/Obsidrel/resources/cosmetics/. They reference existing items but do not replace physical armor.

Basic Core example

yaml
ruby_crown:
  enabled: true
  item: obsidrel:ruby_helmet
  slot: HEAD
  permission: ''
  conditions: []
  equip-actions: []
  unequip-actions: []

Advanced equipment events

yaml
magic_crown:
  enabled: true
  item: obsidrel:ruby_helmet
  slot: HEAD
  permission: obsidrel.cosmetic.crown
  conditions: [showcase_alive]
  equip-actions: [showcase_crown_equipped]
  unequip-actions: [showcase_cosmetic_removed]

The advanced sample depends on two Actions and one Condition from the official Showcase, plus an existing armor item.

enabled toggles; item references the visual; slot picks the slot; permission gates usage; conditions validates; equip-actions/unequip-actions run when equipment changes.

Verify equip/unequip, permissions, pack rendering and coexistence with real armor. Armor Sets · Actions.

Was this article helpful?Loading ratings…

Help us improve Obsidrel documentation. One vote per account and article. Discord AI feedback can also contribute when the answer cites this article.