# My First Sword

{% hint style="danger" %}

#### **Resourcepack hosting**

Remember to **decide** a [**resourcepack hosting**](https://itemsadder.devs.beer/japanese/plugin-usage/resourcepack-hosting) method **before** you **start**.\
I **advise** you to use **self-host** which is **easier** and **faster**, but you can also use **Dropbox** and similar
{% endhint %}

## Creating the swords file config

{% hint style="warning" %}
This is an example sword (remember to change `my_items` namespace to the one you want).
{% endhint %}

For example I created a **file** which will contain all my **custom swords**:\
`contents/my_items/configs/myswords.yml`

In this file (`myswords.yml`) I start creating a simple sword called `mysword`

{% code title="contents/my\_items/configs/myswords.yml" %}

```yaml
info:
  namespace: my_items
items:
  mysword:
    display_name: My Sword
    permission: myitems.mysword
    durability:
      max_custom_durability: 1324
  
```

{% endcode %}

## Item texture

### Creating the texture file

Now the fun part, let's set the sword texture.\
To do that you have to put your sword `.png` texture file inside the correct folder.

In this case your **namespace** is `my_items` so you have to put it here:

`contents/my_items/textures/item/mysword.png`

![](https://2228257718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faipc4QQKwVS0w1Q604ya%2Fuploads%2Fgit-blob-1292d683c5c094730444594828103094d923983a%2Fimage_\(14\).png?alt=media)

### Applying the texture file to your item

Now open `myswords.yml` file again and add the `resource` part as I did.\
As you can see I set `generate: true` and I set the textures for the item.\
This tells the plugin to generate the 3D model automatically using your texture.

{% code title="contents/my\_items/configs/myswords.yml" %}

```yaml
info:
  namespace: myitems
items:
  mysword:
    name: My Sword
    permission: myitems.mysword
    resource:
      material: DIAMOND_SWORD
      generate: true
      texture: item/example_item.png
    durability:
      max_custom_durability: 1324
```

{% endcode %}

## Final part

Now you just need to tell the plugin to load your just added item.\
To do that you have to:

* join the server
* make sure you accepted the resourcepacks
* use the command `/iazip`
* (if you're using **external-host** (**DropBox**) scroll down and follow the instructions)
* get the item using `/iaget mysword`

![](https://2228257718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faipc4QQKwVS0w1Q604ya%2Fuploads%2Fgit-blob-2f409566d9e302afdfd76b26a032bcbe90167e82%2Fimage_\(18\).png?alt=media)

![](https://2228257718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faipc4QQKwVS0w1Q604ya%2Fuploads%2Fgit-blob-718cf6fdd24d3e86cc5ca952645aef3715c19812%2Fimage_\(19\).png?alt=media)

## Resourcepack Hosting Tutorials

{% content-ref url="../resourcepack-hosting" %}
[resourcepack-hosting](https://itemsadder.devs.beer/japanese/plugin-usage/resourcepack-hosting)
{% endcontent-ref %}