> For the complete documentation index, see [llms.txt](https://docs.superiormc.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.superiormc.cn/itemsadder-doc/jia-ju/jia-ju-ji-chu.md).

# 家具基础

方块本身由 **6** 个面堆叠而成，我们虽然可以部分巧妙的使用透明像素来实现非正方体方块，但对于像椅子、桌子这样需要大量方向的装饰品来说，还是太限制了，所以我们需要使用 **ItemsAdder** 家具功能。

虽然称之为家具，但实际上是在 **Minecraft** 中放置我们前文在 **物品** 一章已经提及的 **3D** 模型，只不过这次不是只在手上看，而是实实在在的放在地上了。

家具通过盔甲架或者物品展示框的方式显示，而不是方块的不同的唱片机、刷怪笼原版材质修改（这意味着有数量上的上限）。

### 家具材质

与方块近乎一样，但是这里要用的是模型：

```
    resource:
      material: PAPER
      generate: false
      model_path: lamp
```

其中：

* material：见 **方块基础** 一节。
* generate：见 **方块基础** 一节，此处请保持 `false`。
* model\_path：模型文件路径，其填写规则与贴图的 `path` 一致，请见 **贴图** 一节。

### 家具行为属性

不同于方块需要添加特殊属性，家具需要给这个物品添加一个行为属性。不止对于家具本身，行为属性还可以为物品带来其他丰富多彩的内容，例如饰品、售卖机、枪等，具体的内容请见下一节。

在你需要设置为家具的物品的配置下添加如下内容：

```
behaviours:
  furniture:
    entity: armor_stand
    small: true
    gravity: true
    fixed_rotation: false
    light_level: 7  
    solid: false
    opposite_direction: false #makes the model rotate 180 when placed
    hitbox:
      length: 2
      width: 2.3
      height: 1
      length_offset: 0.5
      width_offset: 0.5
      height_offset: 0.5
    placeable_on:
      walls: false
      ceiling: false
      floor: true

```

其中：

* entity：该家具的实体类型，家具可以通过盔甲架或者物品展示框显示，两者的区别将在下文指出。
* small：是否为小型盔甲架。
* solid：是否具有像方块那样的固态。如果是，那么玩家将可以“踩在”家具上，如果不是，那么玩家可以穿透家具。
* fixed\_rotation：是否固定朝向，如果不是，那么家具每次朝玩家所在的朝向设置**（你可以理解为 Citizen 每次创建 NPC 后，NPC 都是朝着玩家创建时候方向看，很难做到两个 NPC 朝向一模一样）**。建议如果你是椅子等装饰品，请修改为 `true`，否则玩家放置每把椅子朝向不一致将会非常影响美观，如果是收音机这种小装饰品，可以修改为 `false`。

![这是一个没有固定朝向的家具](https://1341925849-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M28TcKgSDvuFN510qye-887967055%2Fuploads%2F5506uokIEO7CxQAj59ZT%2Fimage.png?alt=media\&token=6f9bef2c-6c2d-45d2-8155-ffa49bda3c54)

* hitbox：家具的 `hitbox`。每个 **Minecraft**  的实体都有 `hitbox`，玩家只有在命中这个实体的 `hitbox` 后才会使其受到伤害，在家具中即破坏它。你可以在客户端按住 **F3 + B** 键以查看各个实体的 `hitbox` 范围。其分别为长宽高和长宽高的偏移。
* placed\_on：可以放置的位置，分布为墙上、地上、天花板。

### 家具实体

家具可以由 **2** 种实体显示，我们可以将这个物品套在盔甲架的头上以将其显示，或者放在物品展示框上以将其显示。盔甲架和物品展示框实际上都会隐形，所以就实现了家具的效果。

#### 盔甲架

* 可以无限朝向，而不是物品展示框的 **8** 个朝向。
* 只能放在地上，不能是墙上和天花板。
* 可以实现椅子坐上去的效果。

它的标准配置是（未列出的选项代表该选项对于盔甲架无效，下同）：

```
behaviours:
  furniture:
    entity: armor_stand
    small: true
    solid: true
    fixed_rotation: true
    hitbox:
      length: 1
      width: 2
      height: 1
      width_offset: 0.5
    placeable_on:
      walls: false
      ceiling: false
      floor: true
  furniture_sit:
    sit_height: 0.5
```

`furniture_sit` 为另外一个行为属性，将在下节提及。

#### 物品展示框

* 只能 **8** 个朝向。
* 什么地方都可以放。
* 不能很好实现椅子坐上去的效果。

它的标准配置是：

```
behaviours:
  furniture:
    entity: item_frame
    light_level: 15
    solid: false
    hitbox:
      length: 1
      width: 1
      height: 1.5
    placeable_on:
      walls: true
      ceiling: true
      floor: true
```