> 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 %}