# Allowed Item String

A typical item string would look something like this

<pre class="language-yaml"><code class="lang-yaml">van<a data-footnote-ref href="#user-content-fn-1">@</a>DIAMOND@5@1
</code></pre>

All the entries for [#allowed-materials](https://nukegh05t.gitbook.io/deliveryboard/understanding-config#allowed-materials "mention")can be generalized into 3 parts.

* Plugin
* Material/Item ID
* Amount/Item Type/None

{% hint style="info" %}
*Only **MMOItems** needs a 4th part which is the amount.*
{% endhint %}

### Plugin

The first section denotes the name of the plugin from which the item comes if it is a custom item. Otherwise, it is set to `van` for vanilla. Other plugins use the following prefixes.

* Vanilla - `van`
* [MMOItems](https://polymart.org/resource/mmoitems-premium.3413) - `mmo`
* [ItemsAdder](https://polymart.org/resource/itemsadder-custom-items-etc.1851) - `iad`
* [Oraxen](https://polymart.org/resource/oraxen-custom-items.629) - `orx`
* [ExecutableItems](https://polymart.org/resource/executableitems-free.2859) - `exi`
* [EcoItems](https://polymart.org/resource/ecoitems.1241) - `eco`
* Serialized - `ser` *(Not editable in config)*

### Material/Item ID

The second section denotes the Item ID of the item that is used to represent it in those plugins. Otherwise, it is set to any vanilla Material. List of vanilla materials can be found [here](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html).&#x20;

### Amount/Item Type/None&#x20;

This section denotes the Item's amount or type depending on the plugin. For vanilla items, it represents the item amount that needs to be delivered.

* Vanilla - Item Amount
* MMOItems - Item Type
* ItemsAdder - N/A
* Oraxen - N/A
* ExecutableItems - N/A
* EcoItems - N/A

Even though this doesn't apply to ItemsAdder, ExecutableItems or EcoItems, it is advised to not keep this section empty for these plugins and putting a number makes it failsafe in case something goes wrong.

### Examples

#### Vanilla

To set the delivery item to require 16 Breads, the string will be: `van@BREAD@16`\
String for 32 Redstone lamps would be: `van@REDSTONE_LAMP@32`

#### MMOItems

To set the delivery item to require 1 Custlass Sword, the string will be: `mmo@CUTLASS@SWORD@1` \
String for a Blaze Wand would be: `mmo@BLAZE_WAND@WAND@1`

#### ItemsAdder

To set the delivery item to require 1 coin from the iageneric section of the default pack ([Details](https://itemsadder.devs.beer/first-install#step-3-optional-add-official-itemsadder-custom-content)), the string will be `iad@iageneric:coin@1`\
String for an Arcane Ring from iaalchemy section of the samepack would be `iad@iaalchemy:arcane_ring@1` .\
\
The namespace (`iageneric` or `iaalchemy`) is not mandatory and can be ignored. However, it is advised to keep the namespaces as it would prevent confusion if an item with the same id is available in both the sections. The `1` at the end is kept as a countermeasure for any typos leading to crashes.

#### Oraxen

To set the delivery item to require 1 dagger from Oraxen's default items, the string will be `orx@dagger@1` .

#### ExecutableItems

To set the delivery item to require 1 Free Heal, the string will be: `exi@Free_Heal@1`\
String for a Free Fly would be `exi@Free_Fly@1`\
The `1` at the end is kept as a countermeasure for any typos leading to crashes.

#### EcoItems

To set the delivery item to require 1 grappling hook, the string will be: `eco@grappling_hook@1`\
The `1` at the end is kept as a countermeasure for any typos leading to crashes.

#### Serialized

This is an itemstack directly serialized into byte code and saved in the config. It can not be edited in the `config.yml` and appears when using either `add` or `edit` command to add items.

[^1]:


---

# 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://nukegh05t.gitbook.io/deliveryboard/deliveryboard-wiki/formatting-string/allowed-item-string.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.