一、模型文件结构

以下为 FurnitureCore 所接受的一个家具模型文件的格式要求：

• mode_name.zip
  • model.json模型json
  • texture_1.png 材质
  • path
    • texture_2.png包含在路径中的材质
  • properties.json家具属性（可选）
  • recipes.json 此模型内置的合成配方（可选）

约束规则：

• 模型压缩包名称（mode_name.zip）即为模型名称，会被用作游戏内的调用；
• 名称只能包含 a-z、0-9、.、_、-；
• 模型 json 应当处于压缩包顶级，不允许嵌套在压缩包中的文件夹内；

二、model.json 模型文件

FurnitureCore 采用的模型格式与 Minecraft 自带模型格式一致，通常包含以下内容：

{
  "textures": {
    "0": "texture_1",
    "1": "path/texture_2"
  },
  "elements": [...],
  "display": {...},
  "groups": [...]
}

从其他方转换模型到 FurnitureCore 时

显然有经验的开发者发现了，几乎所有用来导入 Minecraft 的模型都是这种格式。这也就意味着你可以直接将其他插件、mod 的模型拿到此处来使用。

不过需要注意的是，由于不同来源模型、材质包对内容物的路径管理方式不同，model.json 文件中的材质文件路径也许需要你手动调整为与 FurnitureCore 的文件组织格式一致（确保路径正确）。

三、properties.json 家具属性

为了丰富家具功能，FurnitureCore 模型允许配置一些家具属性，包含在 properties.json 文件中：

{
  "display_name": "家具显示名称",
  "can_rotate": true,
  "can_hanging": false,
  "function": {...}
}

• display_name：配置模型的显示名称，当没有此字段时则显示模型文件名；
• can_rotate：配置模型是否可以旋转角度（默认 true）
  • 模型共有 16 种朝向角度（间隔 22.5°），当启用时，玩家放置模型则会自动朝向玩家；
  • 放置后可以通过使用 螺丝刀 右键旋转模型；
• can_hanging：配置模型是否可以被悬挂在方块侧面（默认 false）
  • 一种类似于展示框的悬挂效果，通常用于挂画类的装饰模型；
  • 当can_rotate与此项均为true时，如果模型放置在地上则同样可以旋转；
  • 由于游戏的限制，目前无法将东西挂在天花板上 天杀的mojang；
• function：配置家具的功能，当没有此字段则表示家具仅用作展示，具体可用功能配置如下

chair （椅子）

椅子功能，具备此功能的模型可以让玩家坐在上面。

{
  "function": {
    "type": "chair",
    "height": 0.0
  }
}

height 字段用于调整玩家坐在模型上的高度。

1.0 为模型放置位置方块的顶面，0.0 为模型放置位置方块的底面，0.5 为模型放置位置方块的中间位置。

storage （存储）

存储功能，具备此功能的模型可以用作存储物品。

{
  "function": {
    "type": "storage",
    "size": 27
  }
}

size 字段用于配置存储模型的大小，应当为 9 的倍数，（可选： 9、18、27、36、45、54 六种大小）

如果 size 不是 9 的倍数，会自动向上取整到最接近的 9 的倍数。

illumination （照明）

照明功能，具备此功能的模型可以发光，作为光源。

{
  "function": {
    "type": "illumination",
    "light_level": 15,
    "switchable": false
  }
}

• light_level 字段用于配置光照等级，取值范围为 0-15。
• switchable 字段用于配置是否可以开关，当为 true 时，玩家可以右键开关照明。

work_block （工作方块）

可以指定一个 Minecraft 工作台类型，具备此功能的模型可以作为对应工作台使用。

{
  "function": {
    "type": "work_block",
    "block": "workbench"
  }
}

block 字段用于指定工作台类型，目前支持的工作台类型有：

• workbench：工作台
• furnace：熔炉
• smoker：烟熏炉
• blast_furnace：高炉
• brewing_stand：酿造台
• loom：织布机
• cartography_table：制图台
• stonecutter：切石机
• smith：铁砧
• grindstone：磨石机

四、recipes.json 家具合成配方

此文件是可选的，当没有此文件时表示此模型不包含一个内置的合成配方。

一个家具可以指定多种配方，包含在文件内的 recipes JsonArray 中：

{
  "recipes": []
}

合成配方分为有序配方与无序配方两种，通过配方中的 type 字段区分。配方材料只支持 Minecraft 自带物品。

① 有序配方（shaped）

例子 1

{
  "recipes": [
    {
      "type": "shaped",
      "shape": [
        "sss",
        "sas",
        "sss"
      ],
      "ingredients": {
        "s": "minecraft:stone",
        "a": "minecraft:stick"
      }
    }
  ]
}

• shape: 定义了合成配方的形状。每个字符串代表合成网格中的一行，每个字符代表一个材料槽位。字符与 ingredients 中的键对应，并且只能是单字符。
  • 例如，上述示例中，"sss", "sas", "sss" 表示一个 3x3 的合成网格，其中：
    • s 代表 minecraft:stone
    • a 代表 minecraft:stick
• ingredients: 定义了合成配方中使用的材料。键是 shape 中使用的字符，值是对应的材料。
  • 例如，上述示例中：
    • s 对应 minecraft:stone
    • a 对应 minecraft:stick

例子 2

{
  "recipes": [
    {
      "type": "shaped",
      "shape": ["s", "a"],
      "ingredients": {
        "s": "minecraft:ditr",
        "a": "minecraft:stone"
      }
    }
  ]
}

这样配置则下面两种合成方式都可以得到产物，如果希望只能在特定的位置摆放请看例子3：

例子 3

{
  "recipes": [
    {
      "type": "shaped",
      "shape": [
        "bsb",
        "bab",
        "bbb"
      ],
      "ingredients": {
        "s": "minecraft:ditr",
        "a": "minecraft:stone",
        "b": "minecraft:dir"
      }
    }
  ]
}

② 无序配方（shapeless）

{
  "recipes": [
    {
      "type": "shapeless",
      "ingredients": [
        "minecraft:stone",
        "minecraft:stone",
        "minecraft:stick"
      ]
    }
  ]
}

无序配方配置起来要简单的多，仅需要将合成材料填写在 ingredients 列表中即可。