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).Documentation Index
Fetch the complete documentation index at: https://docs.borntocraftstudio.net/llms.txt
Use this file to discover all available pages before exploring further.
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.
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 |