# Guides

{% hint style="info" %}
If you set `purchase-able` to false, that cosmetics won't be able to be purchased anymore. (v1.4 or above is needed)
{% endhint %}

#### How to add custom Shopkeeper Skin ->

```yaml
  id:
    rarity: COMMON
    price: 5000
    item: "BARRIER:0" # 0 is damage
    entity-type: "VILLAGER"
```

#### Shopkeeper Skin with Custom Player Skin ->

```yaml
 id:
    rarity: COMMON
    price: 5000
    item: "BARRIER:0" # 0 is damage
    # Skin value and signature is needed
    # mirror: true for mirror skin
    skin-value: ""
    skin-sign: ""
```

#### How to add custom Spray ->

```yaml
 id:
    url: "somelink.com/image.png"
    # file: can be used to use file instead of URL,
    # place the file in Sprays folder
    item: "BARRIER:0" # 0 is damage
    price: 15000
    rarity: COMMON
```

#### How to add custom **Projectile Trail ->**

```yaml
  id:
     price: 5000
     rarity: COMMON
     item: "BARRIER:0" # 0 is damage
     particle: "REDSTONE"
```

#### How to add custom Kill Message ->

```yaml
  id:
    price: 15000
    rarity: COMMON
    item: "BARRIER:0" # 0 is damage
    PvP-Kill:
      - "{victim} &7was killed by {killer}."
    Void-Kill:
      - "{victim} &7slipped into void for {killer}."
    Explosion-Kill:
      - "{victim} be shot with cannon by {killer}"
    Shoot-Kill:
      - "{victim} was shot down by {killer}"  
```

#### How to add custom Island Topper ->

```yaml
 id:
     item: "BARRIER:0" # here 0 is damage
     price: 5000
     file: "file.schematic" # put the file into islandtoppers folder
     rarity: COMMON
```

#### How to add custom Glyph ->

```yaml
 id:
     item: "BARRIER:0" # here 0 is damage
     price: 5000
     file: "image.png" # put the file into glyphs folder
     rarity: COMMON
```

#### How to add custom Death Cry ->

```yaml
  id:
    sound: "ENTITY_VILLAGER_YES" # use the sounds from latest version of minecraft
    item: "BARRIER:0" # here 0 is the damage
    volume: 1
    pitch: 1
    price: 5000
    rarity: COMMON
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://dev-wiki.iamthedefender.xyz/bedwars-cosmetics/setup/guides.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.