物品和方块模型

物品/方块模型

• 物品和方块模型建议使用 bbmodel 格式，只有该格式支持调整位置。
• 如果方块模型需要发光（作为方块光源），请参阅模型篇第一章的相关说明，此处不再赘述。

设置模型到物品

• 设置物品模型只需通过指令或 NBT 编辑即可完成。
• 指令方式：/a item setModel [模型ID]
• NBT 方式：将 model 的值设置为模型 ID，你可以使用支持 NBT 编辑的物品库进行设定。
• 以下示范指令方式：手持物品后输入 /a item setModel test，其中 test 是模型篇第一章中导入的模型。

大型模型的渲染消耗较高。如果是需要长期手持的物品模型，会在HUD和手持位置同时渲染两次。建议为此类物品设置2D贴图，在UI模式下会优先使用2D图标以减少性能消耗。

设置模型手持位置

默认情况下模型的手持位置需要调整，请安装 ArcartX BlockBench 插件 后在 BlockBench 中进行调整。

设置模型到方块

• 设置方块模型的方式与物品相同，区别在于设置的是 头颅方块，其余流程完全一致。
• 原版基岩模型不支持 3×3 以上大小的方块模型，按照上述物品模型的步骤进行转换即可突破该限制。
• 方块模型的体积为自动计算，无需担心模型过大导致超出原版体积范围而不渲染的问题。
• 方块模型的渲染结果与 BlockBench 中编辑时的位置一致。

方块靠近动画

方块模型支持玩家靠近时自动触发动画。当玩家进入设定距离范围内，方块会依次播放过渡动画和循环动画；离开范围后回到默认待机。

触发距离通过模型的 axmeta.json 中的 distance 字段配置，默认为 16 格：

{
  "distance": 16
}

方块模型需要在动画文件中包含以下动画名称：

播放逻辑：玩家进入范围 → 播放 closeTo_in（如果有）→ 循环播放 closeTo → 玩家离开范围 → 回到 idle。