Skip to main content

Main Configuration

File location: plugins/BedWars1058/Addons/Cosmetics/config.yml

From the config.yml file, you can edit:

Command Function​

For the categories and cosmetics* menu you may add some items which will run a command when a player clicks on it.

Player​

To make the command run by the player who clicked, you can just simply put your command in the command: example config section.

Example Command:

example-item:
  command: "cosmetics menu"
  material: ...
  amount: ...
  enchanted: ...
  slot: ...

Console​

To make the command run by the console, you have to use the form of CONSOLE:command in the command: CONSOLE:example config section. You may use {player} placeholder which will be replaced by the player's name who clicked the item.

Example Console Command:

example-item:
  command: "CONSOLE:eco give {player} 100"
  material: ...
  amount: ...
  enchanted: ...
  slot: ...

Close​

To make the click close the inventory use CLOSE identifier for the command section.

Example Close Inventory Command:

example-item:
  command: "CLOSE"
  material: ...
  amount: ...
  enchanted: ...
  slot: ...

Material​

tip

Use materials from useful resources for your server version.

example-item:
  material: "HOPPER"
  amount: 1
  enchanted: true

Amount​

To set an amount for an item use amount: 1 config section. The maximum amount is 64.

Enchantment​

To make an item enchanted you can set enchanted: false the config section from false to true.

Data​

To use data for material for only 1.8x-1.12x you can use the form of material:data for example WOOL:5 will be lime wool. Otherwise use the full material name for example LIME_WOOL.

Custom Textured Player Head​

To make a textured player head you must use the form of texture:base64 for example:

Example of custom texture head

Example:

example-item:
  material: "texture:eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZjk4YmM2M2YwNWY2Mzc4YmYyOWVmMTBlM2Q4MmFjYjNjZWI3M2E3MjBiZjgwZjMwYmM1NzZkMGFkOGM0MGNmYiJ9fX0="
  amount: 1
  enchanted: false

Result will be:

Imgur

Source: https://minecraft-heads.com/

Leather Color​

Example:

example-item:
  material: "LEATHER_LEGGINGS:#FF0000"
  amount: 1
  enchanted: false

To make colored leather you have to use the form of leather-material:hex-color for example LEATHER_LEGGINGS:#FF0000 will be displayed as red leather leggings.

Fill Empty Slots​

Example:

empty-slots:
  enabled: false
  material: STAINED_GLASS_PANE
  amount: 1
  enchanted: false

To fill the empty slots of the Categories, Cosmetics, and Confirm Purchase menus you have to change the empty-slots path's enabled: false section to true, to make it fill all the slots which are empty. You may change the material of the filling item.

Sounds​

tip

Use sounds from useful resources for your server version.

Sounds are used to make some actions more interactive and understandable for players, in the sound section you can configure everything with your desired way.

Snippet:

sounds:
  cosmetic-select: "NOTE_PLING:1:2"
  cosmetic-preview: "SUCCESSFUL_HIT"

You can configure sounds volume and pitch by using the form of sound:volume:pitch for example NOTE_PLING:1:2 this plays NOTE_PLING sound with volume of 1 and pitch of 2.

Categories​

Snippet:

categories:
  projectile-trail:
    enabled: true
    default: "none"

Enabling or Disabling​

To disable or enable a category set true or false for the corresponding category's enabled configuration section.

Default Cosmetic​

To modify the default cosmetic of a category handle to the default: configuration section and modify it with the corresponding category's cosmetic identifier.

Rarities​

Rarities are used to sort the cosmetics, so if the cosmetics has a high proiority rarity then that cosmetics is more better than the one that is set to low proiority rarity. Rarities can be applied to the cosmetics which later can be used by the sorter feature to sort the cosmetics by lowest to highest rarity or vice versa.

Snippet:

rarities:
  common:
    priority: 1
    color: GREEN

Priority​

The priority will be in the range of 1-∞ it will help the sorter feature to sort the cosmetics in the menu when using the sorter item.

Color​

The color for the rarity is the usual chat colors which you can find here. Those colors won't affect the sorting.

Permission Discount​

Permission discounts will allow you to make permissions that will discount the price of a cosmetic by a percentage or an amount that is set for the corresponding permission discount, which then could be applied to a player or a group.

Example: 

permission-discount:
  enabled: true
  example-percentage:
    discount-type: PERCENTAGE
    value: 20
  example-amount:
    discount-type: AMOUNT
    value: 1000

Enabled​

If the enabled path is set to true this feature will be activated.

Identifer​

The identifier is the base path for example the example-percentage or example-amount (shown in the example).

Identifier is a part of the permission which is formed like bedwars.cosmetics.discount.<identifier>

For example, if the player has bedwars.cosmetics.discount.example-percentage then the player will get a discount by corresponding example-percentage which is set to 20 percent.

Discount Type​

Discount types are two, the first one is PERCENTAGE which is used to do the discount by the value specified percent, and the second one is AMOUNT which will discount the price by the value specified.

Value​

The value is the number that is used to either do the discount by that percentage or by that amount, check out the Discount Type for more.

Unlock Permission​

Unlock permissions are the permissions that can be attached to some specific cosmetics which will prevent purchasing the corresponding cosmetic without having that specific permission.

Example:

unlock-permission:
  vip:
    permission: vip
    priority: 1
  mvp-plus:
    permission: mvp-plus
    priority: 2

Permission​

Permission form: bedwars.cosmetics.permit.<identifier>

The permission's key, the actual permission will look like so when the permission is vip for example, then the actual permission will be bedwars.cosmetics.permit.vip

Priority​

Can be anything between 1-∞.

This is the priority of the unlock permission, since a cosmetic could have more than one unlock permission, this will be used to determine which permission to demand the player to have (starts from the lower to higher)