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 |
Dependencies
| Extension | Required | Usage |
|---|---|---|
| GUI Extension | Required | Menu rendering and layout system. |
| PlaceholderAPI | Optional | For @Placeholder fields. |