> For the complete documentation index, see [llms.txt](https://heads.advancedplugins.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://heads.advancedplugins.net/usage/adding-support-with-api.md).

# Adding support with API

Guide on how to add support to our heads using the API

Adding support is very easy! It's as simple as allowing players to input their desired custom head id and loading the head item from our API.

### 1. Add `AdvancedHeads` as a soft dependency into your plugins.yml file

{% code title="plugin.yml" %}

```yaml
softdepend: [AdvancedHeads]
```

{% endcode %}

### 2. Example integration into a config file:

{% code title="config.yml" %}

```yaml
item:
  advancedHeads: 222
```

{% endcode %}

### 3. Now, onto the loading part from code:

{% code title="Main.java" %}

```java
ItemStack customHead = AdvancedHeadsAPI.getHead(getConfig().getInt("item.advancedHeads));
```

{% endcode %}

### 4. The result

Now you have an itemstack, which looks like this in-game:

![](https://i.imgur.com/zjDejoT.png)
