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.