Skip to main contentCosmetic Definition
Define a 3D Cosmetic attached to a player.
Configuration
The id of this entry.
Name
The name of this entry.
Cosmetic Id
Unique cosmetic identifier.
Permission
Permission required to unlock (player must have this permission).
Priority
Display priority in menu (lower = displayed first).
Category
Category for this cosmetic (e.g., ‘Backpack’, ‘Hat’). Used for menu grouping.
Model
The 3D model entity to display (Entity Definition).
Rotation Mode
Rotation mode for the cosmetic.
RELATIVE_TO_BODY: Cosmetic rotates with the player’s body (useful for backpacks, wings).RELATIVE_TO_HEAD: Cosmetic rotates with the player’s head (useful for hats, glasses).FIXED: Cosmetic rotation is fixed (does not rotate with player).
Offset
Offset from the player’s position.
Rotation Offset
Rotation offset (X=Pitch, Y=Yaw, Z=Roll) applied to the cosmetic.
Particles
Particle effects attached to this cosmetic.
- Type: Type of particle.
- Offset: Offset from the cosmetic’s center.
- Count: Number of particles to spawn.
- Speed: Speed of the particles.
- Interval: Interval in ticks between particle spawns.
Item representation in the menu.
Custom Data
Custom data for specific implementations. 
