> For the complete documentation index, see [llms.txt](https://3504743864.gitbook.io/yu-lan/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://3504743864.gitbook.io/yu-lan/plugin-usage/adding-content/item-properties/resource.md).

# 自定义资源属性（resource）

{% hint style="danger" %}
请确保没有使用任何 **大写字符** 以及 **特殊字符** 在物品的 **名称**, **命名空间**, **贴图文件（png）** 以及 **模型文件（json）**
{% endhint %}

## 自动生成物品模型

为了让 ItemsAdder 识别有哪些 模型/材质 用于该物品, 您必须设定 `resource` 属性.\
示例：

```yaml
  resource:
    material: DIAMOND_SWORD
    generate: true
    textures:
    - item/example_item.png
```

`material` 是为物品的源材质

`generate` 告诉 IA 是否要根据您列出的材质自动生成物品模型

`textures` 是 IA 用于自动生成模型的材质列表（文件）.

### 我应该将材质放在哪里？

您在 `textures` 属性中列出的材质必须放置在正确的文件夹中.\
因此, 如果您向示例那样设置 `textures` 属性, 并且您的 **命名空间** (参照示例) 为 `myitems`, 就需要将材质文件 `example_item.png` \*\*\*\* 放置在此路径的文件夹中: `plugins\ItemsAdder\data\resource_pack\assets\myitems\textures\item`

如果指定的路径不存在, 请手动创建所需的所有文件夹.

{% hint style="info" %}
无需在 `textures` 属性中设置材质的 `.png` 文件后缀, IA 会自动识别它.
{% endhint %}

## 使用自定义的模型 (.json 文件)

如果您有自定义的剑或者物品模型, 您可以让 IA 不要自动生成模型.\
这是一个例子:

```yaml
  resource:
    material: DIAMOND_SWORD
    generate: false
    model_path: item/floating_sword
```

### 我应该把模型放在哪里?

在 `model_path` 属性中设置的模型必须放置在正确的文件夹中.\
因此, 如果您向示例那样设置 `model_path` 属性, 并且您的 **命名空间** (参照示例) 为 `myitems`, 就需要将模型文件 `floating_sword.json` \*\*\*\* 放置在此路径的文件夹中: `plugins\ItemsAdder\data\resource_pack\assets\myitems\models\item`

如果指定的路径不存在, 请手动创建所需的所有文件夹.

{% hint style="warning" %}

#### 物品材质无法加载/显示

如果自定义模型材质不显示, 则必须打开模型文件并尝试修复材质路径.\
这是一个例子:

```yaml
  {
  "textures": {
    "4": "item/alchemy_candles/white_candle",
    "6": "item/alchemy_candles/candle_top",
    "7": "item/alchemy_candles/red_candle",
    "8": "item/alchemy_candles/fire"
  },
```

根据下方示例配置中的修复方法来进行修复 (`your_namespace` 为你的 [命名空间 ](/yu-lan/plugin-usage/adding-content/basic-concepts/namespace.md)文件夹):\
为材质贴图路径前面加上命名空间

```yaml
{
  "textures": {
    "4": "your_namespace:item/alchemy_candles/white_candle",
    "6": "your_namespace:item/alchemy_candles/candle_top",
    "7": "your_namespace:item/alchemy_candles/red_candle",
    "8": "your_namespace:item/alchemy_candles/fire"
  },
```

{% endhint %}

## 半透明材质 (玻璃和类似方块)

{% content-ref url="/pages/66H2vKYFJ0XY47jLZJr3" %}
[如何创建半透明材质的家具](/yu-lan/faq/create-slabs-stairs-tridents-armors-etc/transparent-textured-furnitures.md)
{% endcontent-ref %}

## 手动指定 custom\_model\_data

如果你想为自定义物品设置指定的 custom\_model\_data id, 您可以这样设置:\
使用 `model_id` 属性

```yaml
    resource:
      material: CLOCK
      model_id: 4000
      generate: false
      model_path: "item/multimeter"
```

在该示例中你还需要在此 `assets\YOUR_NAMESPACE\models\item` 路径下新建一个名为 "multimeter" 的文件夹

也可以让 IA 根据材质自动生成模型:

```yaml
info:
  namespace: slimefun
items:
  carbonado:
    resource:
      material: PLAYER_HEAD
      generate: true
      model_id: 4000
      textures:
      - slimefun/carbonado.png
```

{% hint style="warning" %}

#### 提醒

如果您之前创建了该物品并使用了指令 `/iazip` 但是你现在为物品添加了 **model\_id** 属性:\
**非常重要** 请运行命令 `/iacleancache items` 来清理物品缓存，以 **删除未使用的 IDs** 并 **更新修改后的 IDs**.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://3504743864.gitbook.io/yu-lan/plugin-usage/adding-content/item-properties/resource.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.