# Home

## Enhance Your Minecraft Server's Visuals with AdvancedCosmetics – The Ultimate Cosmetics Plugin.

&#x20;AdvancedCosmetics - The ultimate Minecraft Spigot cosmetics plugin, offering 70+ unique cosmetics, custom designs, easy cosmetic creation, no resource packs, and lag-free performance for your server.

### Have questions? Pre-sale, support, or just want to talk?

Join our support Discord for any type of help! <https://discord.gg/advancedplugins>

## Download AdvancedCosmetics <a href="#download-advancedmodels" id="download-advancedmodels"></a>

AdvancedPlugins.net: <https://advancedplugins.net/item/AdvancedCosmetics.207>\
SpigotMC.org: <https://www.spigotmc.org/resources/advancedcosmetics.123056/>\
Polymart: <https://polymart.org/resource/advancedcosmetics.7349>\
BuiltByBit: <https://builtbybit.com/resources/advancedcosmetics.61978/>

<figure><img src="https://advancedplugins.net/img/banner/mintservers.gif" alt=""><figcaption><p><a href="https://mintservers.com/?utm_source=advancedcosmetics&#x26;utm_medium=banner&#x26;utm_content=gitbook">Sponsored by MintServers. AdvancedPlugins.net integration &#x26; auto updates. Unlimited RAM plan for only $9.99!</a></p></figcaption></figure>


# First Install

Guide on how to set up AdvancedCosmetics for the first time!

🎉 Congratulations on choosing **AdvancedCosmetics**, the ultimate cosmetics plugin for Minecraft! We're thrilled to have you in our growing community. If you need any help with installation or have questions, don’t hesitate to reach out to us on [Discord](https://discord.gg/advancedplugins) – we're here to support you every step of the way!

### Step 1 - Installing the plugin <a href="#step-1-installing-the-plugin" id="step-1-installing-the-plugin"></a>

Stop your server.

Make sure your server version is supported. We recommend using **PaperMC** due to their enhanced performance and optimizations.

Place the **AdvancedCosmetics.jar** plugin file into your `server/plugins/` folder.

Start your server.

### Step 2 - Start your server

That's it! AdvancedCosmetics is now installed and available on your server.&#x20;

To access the cosmetics menu, run /cosmetics


# 70+ Default Cosmetics

AdvancedCosmetics features over 70 default cosmetics. Each cosmetic can be customized to a huge extent, and all wearable cosmetics which support color changing can be personalized by each player in game.

### Test Server <a href="#test-server" id="test-server"></a>

{% hint style="success" %}
View the Cosmetics Yourself on our Test Server: **`models.mintservers.com`**\
Use `/warp cosmetics` command to see all cosmetics & try them out!
{% endhint %}

<div align="center" data-full-width="true"><figure><img src="https://advancedplugins.net/img/banner/mintservers.gif" alt=""><figcaption><p><a href="https://mintservers.com/?utm_source=advancedcosmetics&#x26;utm_medium=banner&#x26;utm_content=gitbook">Test Server Sponsored by MintServers. AdvancedPlugins.net integration &#x26; auto updates. Unlimited RAM plan for only $9.99!</a></p></figcaption></figure></div>

### 3D Wearables Screenshots <a href="#screenshots" id="screenshots"></a>

<div data-full-width="true"><figure><img src="https://3626308683-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwcokES7YeuwQ3RkMd9qD%2Fuploads%2FYbOf6BAp66woYbdAa6Vc%2F2025-03-06_09.50.22.png?alt=media&amp;token=f175a719-5143-424e-a09f-d5ec30667699" alt=""><figcaption><p>Hat with 16 color variants, weather wings</p></figcaption></figure> <figure><img src="https://3626308683-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwcokES7YeuwQ3RkMd9qD%2Fuploads%2F7jyAek7ylnFP99KSo9yz%2F2025-03-06_09.50.26.png?alt=media&amp;token=7250fa96-e2e0-4fef-8f69-3b563dc34b40" alt=""><figcaption><p>Arcade machine hat, wings</p></figcaption></figure></div>

<div data-full-width="true"><figure><img src="https://3626308683-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwcokES7YeuwQ3RkMd9qD%2Fuploads%2F0sYhUlEHLIKXeLIoaLrw%2F2025-03-06_09.49.57.png?alt=media&amp;token=76a07c0c-a2ce-4339-a1b8-54889edd350a" alt=""><figcaption><p>Both cosmetics can be customized with 16 colors, selectable by player</p></figcaption></figure> <figure><img src="https://3626308683-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwcokES7YeuwQ3RkMd9qD%2Fuploads%2FmeBdKM3wzfIu2lNclXHK%2F2025-03-06_09.49.41.png?alt=media&amp;token=b801782c-7da6-48dc-b141-ca23121f544e" alt=""><figcaption><p>Showing off all different possibilities</p></figcaption></figure></div>

### All Cosmetics <a href="#screenshots" id="screenshots"></a>

<table data-full-width="true"><thead><tr><th width="243">Cosmetic</th><th width="370">Description</th><th width="187">Type</th><th>Permission</th></tr></thead><tbody><tr><td>Pink Rain</td><td>Cute pink spiral rain follows you around!</td><td>COMPLEX_PARTICLE</td><td>advancedcosmetics.cosmetic.pink_rain</td></tr><tr><td>Diamond Blue Balloon</td><td>Get yourself a diamond balloon!</td><td>BALLOON</td><td>advancedcosmetics.cosmetic.diamond_balloon</td></tr><tr><td>Flowers Balloon</td><td>Get yourself a flowers balloon!</td><td>BALLOON</td><td>advancedcosmetics.cosmetic.flowers_balloon</td></tr><tr><td>Panda Disguise</td><td>Disguise as an cute Panda!</td><td>TRANSFORMATION</td><td>advancedcosmetics.cosmetic.panda</td></tr><tr><td>Cooking Pan Hat</td><td>Put a pan on your head.</td><td>MODEL</td><td>advancedcosmetics.cosmetic.pan_hat</td></tr><tr><td>Cloud Helix</td><td>Cloud helix going around you.</td><td>COMPLEX_PARTICLE</td><td>advancedcosmetics.cosmetic.cloud_helix</td></tr><tr><td>Axolotl Disguise</td><td>Disguise as an Axolotl! Woosh...</td><td>TRANSFORMATION</td><td>advancedcosmetics.cosmetic.axolotl</td></tr><tr><td>Villager Happy</td><td>Shows villager happy particle.</td><td>PARTICLE</td><td>advancedcosmetics.cosmetic.villager_happy</td></tr><tr><td>Cone</td><td>A cone hat.</td><td>MODEL</td><td>advancedcosmetics.cosmetic.cone</td></tr><tr><td>Pink Sphere</td><td>Pink Sphere above your head.</td><td>COMPLEX_PARTICLE</td><td>advancedcosmetics.cosmetic.pink_sphere</td></tr><tr><td>Orange Glow</td><td>Stay class with Orange glow!</td><td>TRANSFORMATION</td><td>advancedcosmetics.cosmetic.orange_glow</td></tr><tr><td>Pink Glow</td><td>Stay class with Pink glow!</td><td>TRANSFORMATION</td><td>advancedcosmetics.cosmetic.pink_glow</td></tr><tr><td>Colorful Wings</td><td>Bring some colors to your wings!</td><td>MODEL</td><td>advancedcosmetics.cosmetic.colorful_wings</td></tr><tr><td>Minify Potion</td><td>Transform yourself to be extremely small.</td><td>TRANSFORMATION</td><td>advancedcosmetics.cosmetic.minify</td></tr><tr><td>Feather Wings</td><td>Wear feather wings!</td><td>MODEL</td><td>advancedcosmetics.cosmetic.feather_wings</td></tr><tr><td>Cloud Aura</td><td>Cool effect that appears on body.</td><td>PARTICLE</td><td>advancedcosmetics.cosmetic.barrier</td></tr><tr><td>Yellow Balloon</td><td>Get yourself a yellow balloon!</td><td>BALLOON</td><td>advancedcosmetics.cosmetic.yellow_balloon</td></tr><tr><td>Water drip</td><td>Drip of water from player head</td><td>PARTICLE</td><td>advancedcosmetics.cosmetic.drip</td></tr><tr><td>Lime Green Glow</td><td>Stay class with Lime Green glow!</td><td>TRANSFORMATION</td><td>advancedcosmetics.cosmetic.green_glow</td></tr><tr><td>Emerald Green Balloon</td><td>Get yourself an emerald balloon!</td><td>BALLOON</td><td>advancedcosmetics.cosmetic.emerald_balloon</td></tr><tr><td>Laughing Emote</td><td>LOL Laugh out loud</td><td>EMOTE</td><td>advancedcosmetics.cosmetic.laugh</td></tr><tr><td>Wow Emote</td><td>Express your wowness</td><td>EMOTE</td><td>advancedcosmetics.cosmetic.wow</td></tr><tr><td>Orange Balloon</td><td>Get yourself an orange balloon!</td><td>BALLOON</td><td>advancedcosmetics.cosmetic.orange_balloon</td></tr><tr><td>Glowing Spell</td><td>Display a glowing spell around the player's head.</td><td>PARTICLE</td><td>advancedcosmetics.cosmetic.spell</td></tr><tr><td>Top Hat</td><td>A top hat.</td><td>MODEL</td><td>advancedcosmetics.cosmetic.top_hat</td></tr><tr><td>Magic Triangle</td><td>Create some magic around you with the purple magical triangle.</td><td>COMPLEX_PARTICLE</td><td>advancedcosmetics.cosmetic.purple_triangle</td></tr><tr><td>Fairy Wings</td><td>Magical Fairy Wings.</td><td>MODEL</td><td>advancedcosmetics.cosmetic.fairy_wings</td></tr><tr><td>Lapis Blue Balloon</td><td>Get yourself a blue balloon!</td><td>BALLOON</td><td>advancedcosmetics.cosmetic.lapis_balloon</td></tr><tr><td>Bubble Shield</td><td>Make the bubbles follow around you.</td><td>COMPLEX_PARTICLE</td><td>advancedcosmetics.cosmetic.bubble_shield</td></tr><tr><td>Lava Splash</td><td>Lava particles spawning above head.</td><td>PARTICLE</td><td>advancedcosmetics.cosmetic.water</td></tr><tr><td>Heart Bloom</td><td>Hearts that spawn around the player.</td><td>PARTICLE</td><td>advancedcosmetics.cosmetic.heart</td></tr><tr><td>Flame Helix</td><td>Flame helix going around you.</td><td>COMPLEX_PARTICLE</td><td>advancedcosmetics.cosmetic.flame_helix</td></tr><tr><td>Phantom Disguise</td><td>Disguise as a Phantom! Weee...</td><td>TRANSFORMATION</td><td>advancedcosmetics.cosmetic.phantom</td></tr><tr><td>Happy Spiral</td><td>Bright green happy spiral!</td><td>COMPLEX_PARTICLE</td><td>advancedcosmetics.cosmetic.green_spiral</td></tr><tr><td>Warden Disguise</td><td>Disguise as a Warden! Ahhh...</td><td>TRANSFORMATION</td><td>advancedcosmetics.cosmetic.warden</td></tr><tr><td>Large Purple Balloon</td><td>Get yourself a large purple balloon!</td><td>BALLOON</td><td>advancedcosmetics.cosmetic.large_purple_balloon</td></tr><tr><td>Magic Ground Ring</td><td>Appear mystereous...</td><td>MODEL</td><td>advancedcosmetics.cosmetic.ground_cosmetic</td></tr><tr><td>Large Orange Balloon</td><td>Get yourself a large orange balloon!</td><td>BALLOON</td><td>advancedcosmetics.cosmetic.large_orange_balloon</td></tr><tr><td>Drinks Hat</td><td>A funny hat to store your drinks.</td><td>MODEL</td><td>advancedcosmetics.cosmetic.drinks_hat</td></tr><tr><td>Dog Disguise</td><td>Disguise as an cute Dog!</td><td>TRANSFORMATION</td><td>advancedcosmetics.cosmetic.dog</td></tr><tr><td>Creeper Disguise</td><td>Disguise as a creeper! Hisss...</td><td>TRANSFORMATION</td><td>advancedcosmetics.cosmetic.creeper</td></tr><tr><td>Enderman Disguise</td><td>Disguise as an Enderman! Wooop...</td><td>TRANSFORMATION</td><td>advancedcosmetics.cosmetic.enderman</td></tr><tr><td>Love Emote</td><td>Express your love</td><td>EMOTE</td><td>advancedcosmetics.cosmetic.love</td></tr><tr><td>Note Harmony</td><td>Musical notes floating around you.</td><td>PARTICLE</td><td>advancedcosmetics.cosmetic.note</td></tr><tr><td>Magic Double Spiral</td><td>Look so mysterious!</td><td>COMPLEX_PARTICLE</td><td>advancedcosmetics.cosmetic.magic_spiral</td></tr><tr><td>Arcade Machine</td><td>Head got stuck in the arcade machine!</td><td>MODEL</td><td>advancedcosmetics.cosmetic.arcade_machine_hat</td></tr><tr><td>Lifesaver</td><td>A lifesaver.</td><td>MODEL</td><td>advancedcosmetics.cosmetic.lifesaver</td></tr><tr><td>Enchanted Aurora</td><td>Magical swirls around your feet.</td><td>PARTICLE</td><td>advancedcosmetics.cosmetic.aurora</td></tr><tr><td>Throwing Up Emote</td><td>That's eww!</td><td>EMOTE</td><td>advancedcosmetics.cosmetic.vomit</td></tr><tr><td>Instant Effect</td><td>Display a colored hit.</td><td>PARTICLE</td><td>advancedcosmetics.cosmetic.instant</td></tr><tr><td>Slime Disguise</td><td>Disguise as a Slime! Slimeyy...</td><td>TRANSFORMATION</td><td>advancedcosmetics.cosmetic.slime</td></tr><tr><td>Lava Splash</td><td>Lava particles spawning above head.</td><td>PARTICLE</td><td>advancedcosmetics.cosmetic.lava</td></tr><tr><td>Crying Emote</td><td>Express your sadness</td><td>EMOTE</td><td>advancedcosmetics.cosmetic.crying</td></tr><tr><td>Zombie Disguise</td><td>Disguise as a Zombie! Arghhh...</td><td>TRANSFORMATION</td><td>advancedcosmetics.cosmetic.zombie</td></tr><tr><td>Angel Halo</td><td>Look like an angel!</td><td>COMPLEX_PARTICLE</td><td>advancedcosmetics.cosmetic.angel_halo</td></tr><tr><td>Spiral of Love</td><td>Love is in your mind! Spiral of hearts.</td><td>COMPLEX_PARTICLE</td><td>advancedcosmetics.cosmetic.love_spiral</td></tr><tr><td>Snowflake</td><td>It's the winter, but only for you!</td><td>COMPLEX_PARTICLE</td><td>advancedcosmetics.cosmetic.snowflake</td></tr><tr><td>Large Light Blue Balloon</td><td>Get yourself a large light blue balloon!</td><td>BALLOON</td><td>advancedcosmetics.cosmetic.large_blue_balloon</td></tr><tr><td>Devil's Trident</td><td>Become the Devil himself.</td><td>MODEL</td><td>advancedcosmetics.cosmetic.trident</td></tr><tr><td>Floating Ghosts</td><td>Floating mystery around you.</td><td>COMPLEX_PARTICLE</td><td>advancedcosmetics.cosmetic.floating_ghosts</td></tr><tr><td>Soulflame Hat</td><td>Shine bright like a soul flame!</td><td>COMPLEX_PARTICLE</td><td>advancedcosmetics.cosmetic.soulflame_hat</td></tr><tr><td>Flame Double Spiral</td><td>Look so mysterious!</td><td>COMPLEX_PARTICLE</td><td>advancedcosmetics.cosmetic.flame_spiral</td></tr><tr><td>Cool Emote</td><td>Express your coolness</td><td>EMOTE</td><td>advancedcosmetics.cosmetic.cool</td></tr><tr><td>Smoke Trail</td><td>A subtle smoke trail following you.</td><td>PARTICLE</td><td>advancedcosmetics.cosmetic.smoke</td></tr><tr><td>Red Balloon</td><td>Get yourself a red balloon!</td><td>BALLOON</td><td>advancedcosmetics.cosmetic.red_balloon</td></tr><tr><td>Gigantify Potion</td><td>Transform yourself to be extremely tall.</td><td>TRANSFORMATION</td><td>advancedcosmetics.cosmetic.gigantify</td></tr><tr><td>Water Shower</td><td>Carry a portable shower over your head.</td><td>COMPLEX_PARTICLE</td><td>advancedcosmetics.cosmetic.water_shower</td></tr><tr><td>Glow Dust</td><td>A swirl of glowing dust around you.</td><td>PARTICLE</td><td>advancedcosmetics.cosmetic.glow_dust</td></tr><tr><td>Angry Emote</td><td>Express your anger</td><td>EMOTE</td><td>advancedcosmetics.cosmetic.angry</td></tr><tr><td>Critical Hit</td><td>Show the player a hit effect in the game</td><td>PARTICLE</td><td>advancedcosmetics.cosmetic.crit</td></tr><tr><td>Backpack</td><td>A cosmetic backpack.</td><td>MODEL</td><td>advancedcosmetics.cosmetic.backpack</td></tr></tbody></table>


# Commands & Permissions

## Commands, Permissions

<table data-full-width="true"><thead><tr><th>Command</th><th>Description</th><th>Permission</th></tr></thead><tbody><tr><td>/advancedcosmetics</td><td>Main plugin command</td><td>advancedcosmetics.command</td></tr><tr><td>/ac reload</td><td>Reload plugin &#x26; configuration</td><td>advancedcosmetics.command.reload</td></tr><tr><td>/ac list [page]</td><td>List all cosmetics</td><td>advancedcosmetics.command.list</td></tr><tr><td>/ac clear &#x3C;player></td><td>Clear player's cosmetics</td><td>advancedcosmetics.command.clear</td></tr><tr><td>/ac reward &#x3C;player> [amount]</td><td>Give reward boxes to player</td><td>advancedcosmetics.command.reward</td></tr><tr><td>/ac add &#x3C;player> &#x3C;cosmetic></td><td>Give access to a cosmetic</td><td>advancedcosmetics.command.add</td></tr><tr><td>/ac remove &#x3C;player> &#x3C;cosmetic></td><td>Remove access to a cosmetic</td><td>advancedcosmetics.command.remove</td></tr></tbody></table>

## How to give access to cosmetics

Visit the [How to Give Cosmetics](/usage/how-to-give-cosmetics) page to learn how to give cosmetics to players


# How to Give Cosmetics

To give cosmetics, there are 3 ways. We recommend using permissions - that is the most robust way. But you are able to pick and choose your own methods.

## Permissions

Assign a permission `advancedcosmetics.cosmetic.<name>`to the player using a permissions plugin.&#x20;

{% hint style="info" %}
**LuckPerms**:  /lp user \<username> permission set advancedcosmetics.cosmetic.\<name> true
{% endhint %}

You can find all permissions to default cosmetics here: [70+ Default Cosmetics](/70+-default-cosmetics)

## Commands

You can give and remove cosmetics using our built-in commands.&#x20;

To give, use command `/ac add <player> <cosmetic>`. You can find list of all cosmetics using `/ac list`command.

To remove, use command `/ac remove <player> <cosmetic>` .

## Reward Boxes

Players can also use crate-like reward boxes, placed on the ground they play an animation and give out a random cosmetic.

To give player the rewards box, use `/ac reward <player> [amount]`.&#x20;


# Creating New Models

Creating new models is extremely easy. Learn over at our official models wiki how to create new 3D models to be used as cosmetics: [MODELS & GUIDES](https://models.advancedplugins.net/models-and-guides/starter-guide)


# Creating New Cosmetics

## An Introduction

AdvancedCosmetics empowers you to create engaging cosmetic items to enhance your players' experiences. These visual customizations don't affect gameplay, maintaining EULA compliance. This guide provides an overview of cosmetic types and creation basics.

Cosmetics are configured in YAML files, stored at `/plugins/AdvancedCosmetics/cosmetics/<cosmetic type>/<cosmetic name>.yml`. `<cosmetic type>` (lowercase) corresponds to the effect: `balloons`, `complexParticles`, `emotes`, `hats`, `particles`, or `transformations`. `<cosmetic name>` is what you name the cosmetic. A Diamond Blue Balloon, for instance, would be located at `/plugins/AdvancedCosmetics/cosmetics/balloons/blue_diamond_balloon.yml`.

Each YAML file defines the cosmetic, its name, description, menu item, and type-specific settings.

* **Balloons:** Floating balloon effect using blocks. Define the block type and size.
* **Complex Particles:** Advanced particle effects with patterns like circles, helixes, wings. Customize the particle type and options.
* **Emotes:** Head texture animations. Cycle through head textures for expressions.
* **Hats (3D Wearables):** Custom Blockbench 3D models worn by players. No resource packs needed.
* **Particles (Simple):** Basic particle effects around the player. Adjust the particle type, amount, radius, location, and activation.
* **Transformations:** Alter player appearance. Disguise as entities, change size, or add a glowing outline.

## **Creating a Cosmetic**

1. **Choose a Type:** Decide on your cosmetic's effect.
2. **Create a YAML:** In `/plugins/AdvancedCosmetics/cosmetics/<cosmetic type>/`, create a `.yml` file (e.g., `MyAwesomeHalo.yml`).
3. **Configure:** Add configuration options, using existing examples as a guide. Include name, description, item, and type.
4. **Adjust Settings:** Customize appearance using type-specific settings. See individual cosmetic documentation for details.
5. **Save:** Save the YAML file.
6. **Test:** In game, use `/ac reload` to refresh the plugin.

AdvancedCosmetics offers endless possibilities. Experiment to create unique and visually appealing cosmetics for your server.


# Complex Particles

Complex particles create visually appealing effects around the player using predefined patterns and particle types. These allow for intricate designs like halos, wings, and orbiting shapes.

```yaml
enabled: true

name: "&fAngel Halo"
description: "Look like an angel!"

item:
  type: BONE_MEAL

type: COMPLEX_PARTICLE # Cosmetic type
pattern: CIRCLE # all possible patterns: ANGEL_WINGS, DEVIL_WINGS,CIRCLE,HELIX,ORBITING_RINS,SPHERE,SPIRAL,DOUBLE_SPIRAL,PYRAMID
particle: WAX_OFF # Particle type https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Particle.html
size: 0.5 # Radius of particles around player
frequency: 15 # in ticks
location: ABOVE_HEAD # Location of particles
activation: STANDING # Activation type
```

**Configuration Options:**

* enabled: Enables or disables the cosmetic.
* name: The display name of the cosmetic item.
* description: The description of the cosmetic item.
* item: Defines the item used to represent the cosmetic in menus.
  * type: The Material of the item.
* type: Specifies the cosmetic type as COMPLEX\_PARTICLE.
* pattern: The particle pattern to use. Available options include: ANGEL\_WINGS, DEVIL\_WINGS, CIRCLE, HELIX, ORBITING\_RINGS, SPHERE, SPIRAL, DOUBLE\_SPIRAL, PYRAMID.
* particle: The Particle type to use for the effect. Refer to the Spigot documentation for available particle types. (Link provided in the config).
* size: The radius or size of the particle effect around the player.
* frequency: The interval (in ticks) at which the particle effect is updated. Lower values mean more frequent updates (and potentially more resource usage).
* location: The location relative to the player where the particle effect is displayed. Options include: ABOVE\_HEAD, FEET, etc.
* activation: When the particle effect should be active. Options include: STANDING, MOVING, ALWAYS.


# Emotes

Emotes change the player's head texture to display different expressions or animations. This is achieved by cycling through a series of head textures at a defined frequency.

{% code fullWidth="true" %}

```yaml
enabled: true

name: "&cAngry Emote"
description: "Express your anger"

item:
  head: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvNGZiOTdiMTdjNjM5NTM5MjY1OGYzMjcxOGFhNDZiZWZhMWMzMWQzNTcyNjUxYzMwZjdkMmJmM2I5M2Y2ZWFkOSJ9fX0=

type: EMOTE # Cosmetic type
frequency: 12
faces:
  1:
    head: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvYWJkNTlhMTNlNDY5ZjczYWRhMmFmNmRjOWY1MWI1NDgwY2QzNGE5ODExZjY3OTc1NGMxM2ZmYTVmOWY1ZjYifX19
  2:
    head: ewogICJ0aW1lc3RhbXAiIDogMTczOTYxODk2Mzg3NSwKICAicHJvZmlsZUlkIiA6ICIxNTY3ODg4YTAwYWY0ODc2YjYyNTI3YTNiOGY3YTdlYSIsCiAgInByb2ZpbGVOYW1lIiA6ICJUb3NoaW9YdHJlbWUiLAogICJzaWduYXR1cmVSZXF1aXJlZCIgOiB0cnVlLAogICJ0ZXh0dXJlcyIgOiB7CiAgICAiU0tJTiIgOiB7CiAgICAgICJ1cmwiIDogImh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZDUzNDE3ZGEyYTFmNzhlYjdiMzY3MWU5YzllNTE0NWNkNmZhYjAyNmNjZjQ5YmM1MjA4Y2Y1NTdjNjY3NTM1MyIKICAgIH0KICB9Cn0=
  3:
    head: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvNGZiOTdiMTdjNjM5NTM5MjY1OGYzMjcxOGFhNDZiZWZhMWMzMWQzNTcyNjUxYzMwZjdkMmJmM2I5M2Y2ZWFkOSJ9fX0=
```

{% endcode %}

**Configuration Options:**

* enabled: Enables or disables the cosmetic.
* name: The display name of the cosmetic item.
* description: The description of the cosmetic item.
* item: Defines the item used to represent the cosmetic in menus. Specifically, the head value defines the default head texture.
  * head: A Base64 encoded string representing the player head texture.
* type: Specifies the cosmetic type as EMOTE.
* frequency: The interval (in ticks) at which the head texture is updated. Lower values result in faster animation.
* faces: A list of head textures to cycle through.
  * 1, 2, 3, ...: Each number represents a frame in the animation.
    * head: A Base64 encoded string representing the player head texture for that frame.


# Wearable Cosmetics

3D cosmetics are 3D models created in Blockbench that players can wear. These models are loaded directly by the plugin without requiring resource packs.

```yaml
enabled: true
model: cosmetics:arcade_machine_hat # model file folder location, full location for this example /plugins/AdvancedCosmetics/models/cosmetics/arcade_machine_hat/

# name: "&darcade machine hat" # You can override model's name here
# description: "A arcade machine hat." # You can override model's description here

item: # You can override model's shown item here
  head: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvY2ZjZTdlYWMyZTFmNjVjZDEzYTRiZGFmMDFhY2JiOGI0YmM2MjBlYjQxM2M4NzVmMDQ0YjQxNjMyZjJhMWM2ZCJ9fX0=

type: HAT
```

**Configuration Options:**

* enabled: Enables or disables the cosmetic.
* model: The path to the model file, relative to the models directory of the plugin (e.g., /plugins/AdvancedCosmetics/models/). In the provided example, it looks for folder arcade\_machine\_hat inside a folder called cosmetics in the models folder.
* name (Optional): Overrides the model's default name. If commented out, model's name will be used.
* description (Optional): Overrides the model's default description. If commented out, model's description will be used.
* item (Optional): Overrides the item that shows in the cosmetics menu instead of the models default item.
* type: Specifies the cosmetic type as **HAT, BACKPACK,WINGS,GROUND**


# Particles

Simple particle cosmetics create basic particle effects around the player. You can customize the particle type, amount, radius, and activation conditions.

```yaml
enabled: true
name: "&dEnchanted Aurora"
description: "Magical swirls around your feet."

item:
  type: ENCHANTED_BOOK

type: PARTICLE
particle: ENCHANT
amount: 8
radius: 1.0
frequency: 12
location: FEET
activation: MOVING
```

**Configuration Options:**

* enabled: Enables or disables the cosmetic.
* name: The display name of the cosmetic item.
* description: The description of the cosmetic item.
* item: Defines the item used to represent the cosmetic in menus.
  * type: The Material of the item.
* type: Specifies the cosmetic type as PARTICLE.
* particle: The Particle type to use. Refer to the Spigot documentation for available particle types.
* amount: The number of particles to spawn.
* radius: The radius around the player in which the particles are spawned.
* frequency: The interval (in ticks) at which the particle effect is updated.
* location: The location relative to the player where the particles are spawned (e.g., FEET, HEAD).
* activation: When the particle effect should be active (e.g., MOVING, STANDING, ALWAYS).


# Transformations

Transformation cosmetics alter the player's appearance or properties. This can include disguising the player as another entity, changing their size, or adding a glowing effect.

{% code fullWidth="true" %}

```yaml
enabled: true

name: "&dAxolotl Disguise"
description: "Disguise as an Axolotl! Woosh..."

item:
  head: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvOGI5MWIxM2QwYjMzNjA3YTk1ODdlOGJhMTdkODYwMzU2MjVjYjM2MjdjNWRiZWY5Y2YwMGU4YmFlOWYwZjUyYSJ9fX0=

# DISGUISES 
type: TRANSFORMATION # Cosmetic type
entity: AXOLOTL

# OR CHANGE SIZE:
type: TRANSFORMATION # Cosmetic type
size: 1.5

# OR GLOW:
type: TRANSFORMATION # Cosmetic type
# Available colors: BLACK, DARK_BLUE, DARK_GREEN, DARK_AQUA, DARK_RED, DARK_PURPLE, GOLD, GRAY, DARK_GRAY, BLUE, GREEN, AQUA, RED, LIGHT_PURPLE, YELLOW, WHITE
glowColor: LIGHT_PURPLE
```

{% endcode %}

**Configuration Options:**

* enabled: Enables or disables the cosmetic.
* name: The display name of the cosmetic item.
* description: The description of the cosmetic item.
* item: Defines the item used to represent the cosmetic in menus.
  * head: A Base64 encoded string representing the player head texture.
* type: Specifies the cosmetic type as TRANSFORMATION.
* entity: (Disguise Option) The entity type to disguise the player as (e.g., AXOLOTL).
* size: (Size Change Option) A decimal to scale the player by. For example, 1.5 will make the player 1.5x bigger.
* glowColor: (Glow Option) The color of the glow effect around the player. Available colors: BLACK, DARK\_BLUE, DARK\_GREEN, DARK\_AQUA, DARK\_RED, DARK\_PURPLE, GOLD, GRAY, DARK\_GRAY, BLUE, GREEN, AQUA, RED, LIGHT\_PURPLE, YELLOW, WHITE. Only one of entity, size, or glowColor should be active in a single cosmetic.


# Balloons

Balloons are cosmetic items that attach to the player, simulating a floating balloon effect. They use a block material as the visual representation.

```yaml
enabled: true

name: "&bDiamond Blue Balloon"
description: "Get yourself a diamond balloon!"
item:
  type: DIAMOND_BLOCK

type: BALLOON
material: DIAMOND_BLOCK
size: 1
```

### **Configuration Options:**

* enabled: Enables or disables the cosmetic. true to enable, false to disable.
* name: The display name of the cosmetic item in menus. Use color codes for formatting.
* description: The description of the cosmetic item in menus.
* item: Defines the item used to represent the cosmetic in menus.
  * type: The Material of the item (e.g., DIAMOND\_BLOCK).
* type: Specifies the cosmetic type as BALLOON.
* material: The Material of the block used for the balloon visual.
* size: The size of the balloon visual. A value of 1 represents a standard block size.


