# Reference ItemModel

A **Reference,** *or Model,* **ItemModel** is the simplest form of ItemModel.\
All it does is reference the path to a Model[^1] file to use.

If we want to use this in an example here;

{% code title="NexoItem Example with pre-made Model file" %}

```yaml
myitem:
  ItemModel:
    type: model
    model: namespace:mymodel #References assest/namespace/models/mymodel.json
```

{% endcode %}

{% code title="NexoItem Example for a 2D NexoItem with just a Texture provided" %}

```yaml
myitem:
  Pack:
    texture: namespace:mytexture #References assest/namespace/textures/mytexture.png
  ItemModel:
    type: model
    model: myitem # When only a texture is provided, Nexo generates the Model for <itemid>
```

{% endcode %}

{% hint style="warning" %}
Should be noted that this example is not needed if you just want a basic Item like shown above.\
When using `prefer_item_models` ( [ItemModels vs. CustomModelData](/general-usage/faq/itemmodels-vs.-custommodeldata.md) ), this is done automatically.\
If normally relying on CustomModelData, you can also just set the ItemModel-Component<br>

```
myitem:
  Pack:
    texture: namespace:mytexture
  Components:
    item_model: namespace:myitem
```

{% endhint %}

[^1]: Models are what control the visual aspects of Items & Blocks. These files are found in `assets/<namespace>/models/...`


---

# 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://docs.nexomc.com/configuration/items/itemmodel-builder/reference-itemmodel.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.