Converting from Other Plugins

ECosmetics includes a convenient tool for automatically converting your cosmetics from other popular plugins. This allows you to quickly transfer existing settings without having to create each item again manually.

Supported Plugins

Currently, the converter supports importing from:

• HMCCosmetics
• CosmeticsCore

Preparing for Conversion

Before starting the process, make sure you have:

1. Permissions: You need the ecosmetics.convert permission to use the command.
2. Configuration File: You must have the configuration file of the plugin from which you want to import cosmetics (hmccosmetics.yml or cosmeticscore.yml).

Step-by-Step Instructions

The conversion process is simple and consists of a few steps.

Step 1: Create the convert folder

Inside your plugin's folder /plugins/ECosmetics/, create a new folder named convert.

/plugins/
└── ECosmetics/
├── convert/      <-- Create this folder
├── cosmetics/
├── config.yml
└── ...

Step 2: Place the configuration file

Take the configuration file of the plugin you want to import from and place it in the created convert folder.

• To convert from HMCCosmetics, place your cosmetics.yml file and rename it to hmccosmetics.yml.
• To convert from CosmeticsCore, place your cosmetics.yml file and rename it to cosmeticscore.yml.

After this, the folder structure should look like this:

/plugins/ECosmetics/
└── convert/
    └── hmccosmetics.yml  <-- Your file here
    // OR
    └── cosmeticscore.yml <-- Your file here

Step 3: Execute the command

Now, either in-game or in the server console, execute the command to start the conversion process.

• For HMCCosmetics:

  /ecosmetics convert hmccosmetics

• For CosmeticsCore:

  /ecosmetics convert cosmeticscore

Step 4: Check the result

If everything went successfully, a success message will appear in the console and in your chat.

The converter will create a new file in the /plugins/ECosmetics/cosmetics/ folder.

• converted_hmccosmetics.yml
• converted_cosmeticscore.yml

This new file will contain your cosmetics in a format compatible with ECosmetics.

Step 5: Review and reload

Important

The converter is an auxiliary tool. It tries to transfer as many settings as possible, but some specific options may require manual adjustment.

Open the created .yml file and review its contents. Make sure all types, names, and models have been converted correctly. After checking, save the file and execute the command to reload the plugin and apply the changes:

/ecosmetics reload

Your cosmetics should now be available in ECosmetics