自定义玩家渲染

:::success{title=太棒了}

• 使用自动化程序创建自定义玩家渲染帮助你快速导入资产和编写自定义玩家渲染Json
• 原本需要2~4小时的开发周期，现仅需5分钟！ :::

描述

如果没有指定渲染控制器，将会自动使用名为geometry.{JsonId}的模型及位于资源包/textures/entity/{JsonId}的模型贴图

示例

{
  "format_version": "1.2.1",
  "dafeimian:render": {
    "components": {
      "dafeimian:entity": {
        "animations": [
          "idle",
          "none"
        ],
        "animation_controllers": [
          "controller.animation.bgbox.idle"
        ],
        "render_controllers": [
          {
            "controller.render.la": "!query.mod.la"
          },
          {
            "controller.render.is_la": "query.mod.la"
          }
        ],
        "material_by_render_controller": {
          "la": "dfm_nolight"
        },
        "geometry_by_render_controller": {
          "la": "geometry.bgbox"
        },
        "texture_by_render_controller": {
          "la": "textures/entity/bgbox",
          "is_la": "textures/entity/bgbox_mohu"
        }
      }
    }
  }
}

components

json该Json类型的组件库

dafeimian:entity

必需json自定义玩家实体渲染

:::info{title=提示}

• animations动画Id列表可以填写完整动画Id(animation.xxx.zzz)，也可以填写短动画Id(zzz)，将会自动补全为(animation.{JsonId}.zzz)，这将指定xxx
• 例如：一个名为dafeimian.json的自定义玩家渲染Json，我将animations动画Id列表中填写animation.player.idle和walk，那么实际渲染的完整动画Id为
  • animation.player.idle
  • animation.dafeimian.walk
• 如果将animations动画Id列表中填写animation.player.idle和idle，这是不被允许的，因为两者动画键将被命名为idle，对此该配置组件暂未进行区分规避动画键 :::

render_controllers

str, json指定自定义渲染控制器，可以添加条件

material_by_render_controller

json为渲染控制器指定材质，其中key为渲染控制器指定材质Key，value为该材质Key使用的材质Id

geometry_by_render_controller

json为渲染控制器指定模型，其中key为渲染控制器指定模型Key，value为该模型Key使用的模型Id

texture_by_render_controller

json为渲染控制器指定纹理，其中key为渲染控制器指定纹理Key，value为该纹理Key使用的纹理路径

dafeimian:hide_item_inhand

选填int隐藏手中物品，仅可取值如下：

• 0： 表示第一人称和第三人称下均隐藏手持物品
• 1： 表示仅隐藏第三人称下的手持物品
• 2： 表示仅隐藏第一人称下的手持物品

### dafeimian:hand_item_visible

选填bool手中物品是否显示

{
  "dafeimian:hand_item_visible": {
    "value": false
  }
}