Cosmetics

The Cosmetics Extension allows players to customize their appearance with various aesthetic items. It supports both "worn" cosmetics (like hats and backpacks) and item "skins" (changing the appearance of tools and weapons).

Features

• Slot-Based Cosmetics — Equip items to specific slots (Head, Back, Shoulders) that follow movement.
  • Weapon Skins — Apply custom textures/models to vanilla items using CustomModelData.
  • Integrated Menus — Built-in interactive GUIs for browsing and previewing cosmetics.

Entries

• Cosmetic Definition — Defines a singular cosmetic item (e.g., "Angel Wings").
  • Skin Definition — Defines a set of skins for a specific tool/weapon type.
  • Cosmetics Menu — Configures the main cosmetic browsing GUI.
  • Skins Menu — Configures the skin selection interface.

Quick Start

• 1. Define — Add definition entries: cosmetic_definition, skin_definition. These define the structures, entities, or rules the extension operates on. → cosmetic_definition → skin_definition
• 2. Create Storage — Add artifact entries to persist data: player_cosmetics_artifact, player_skins_artifact. → player_cosmetics_artifact → player_skins_artifact

Commands

Player Commands

Command	Description	Permission
/cosmetics	Open the cosmetics management menu	cosmetics.use
/skins	Open the skins menu for the item in hand	skins.use

Admin Commands

Command	Description	Permission
/cosmetics give <player> <id>	Grant a cosmetic to a player	cosmetics.admin
/cosmetics reset <player>	Clear all unlocked cosmetics for a player	cosmetics.admin
/skins give <player> <id>	Grant a skin to a player	skins.admin

Placeholders

All placeholders use the prefix %typewriter_%.

Placeholder	Description
%typewriter_cosmetics_total_unlocked%	Number of cosmetics the player owns
%typewriter_cosmetics_total_available%	Total number of cosmetics defined on the server
%typewriter_cosmetics_category_<cat>_unlocked%	Unlocked count in a specific category
%typewriter_cosmetics_is_unlocked_<id>%	true/false if player owns a specific id
%typewriter_cosmetics_active_<category>%	The ID of the currently equipped cosmetic in a category

Permissions

Permission	Description
cosmetics.use	Use cosmetics.
cosmetics.admin	Administrate cosmetics.
skins.use	Use skins.
skins.admin	Administrate skins.

Dependencies

Extension	Required	Usage
GUI Extension	Required	Menu rendering and layout system.
PlaceholderAPI	Optional	For @Placeholder fields.