手册:数据驱动

  本页面介绍的是国际版数据驱动接口。关于网易特色数据驱动接口，请见“Manual:数据驱动 (网易)”。

数据驱动接口通常以JSON的形式使用，它们根据功能可以分为不同类型，且都需要遵循一定的格式。

类型

大多数文件的基本结构相同，都是如下框架：

{
  "format_version": "<version>", //格式版本
  "minecraft:<domain>": { //模式类型（有些文件中不含“minecraft”命名空间）
    "description": {
      //描述
    },
    //其他内容
  }
}

而大框架下还包含了很多其他内容，这些内容可以分为以下这些种类。

描述

描述用于对这个JSON文件所定义的内容进行大致定义，它是一个名为description的对象。在描述对象中有一个名为identifier的参数，它用于定义赋命名空间标识符（有些文件中不含命名空间，仅为标识符）；有些文件中还有其他参数，例如实体行为定义文件中有is_spawnable、is_summonable和is_experimental三个参数。

组件

组件被包含在与描述同级且名为components的对象中，它们用于赋予所编写内容一些基本功能和特性。

组件可以分为以下几种类型：

• 基础组件——实现最基本功能的组件。
• 触发器——用于触发事件。
• 内置事件。
• AI意向——用于控制实体的AI行为。
• 生成规则——用于定义实体的生成规则。
• 特性。
• 实体属性。

条件

条件被包含在与描述同级且名为conditions的数组中，它们用于判断是否能在特定条件下执行所编写内容。

事件响应

一个事件可以包含多个事件响应。事件响应用于在特定条件下（被触发器触发时）执行其中所包含的事件响应。事件被包含在与描述同级且名为events的对象中，其基本格式如下：

"events": {
  "<name>": { //事件名称
    //事件响应
  },
  //……
}

过滤器

部分组件中可填写过滤器，其本质上是一个对象，里面包含了test、subject、operator和value四个参数。过滤器用于根据条件筛选目标。

模式

游戏使用模式来校验JSON文本。所有JSON文本都应该按照模式所指定的格式来编写，这样才能将描述、组件、事件等内容组合起来，使游戏正常读取并达到预期效果。部分文件的模式比较特殊，它们不采用上述基本框架，而是直接对一些属性进行参数设置，例如配方、模型、战利品表等。

下面列出了这些文件的模式：

• 动画
• 动画控制器
• 附着物
• 行为树
• 生物群系
• 方块
• 相机
• 对话
• 维度
• 实体行为定义
• 地物（模式列表）
• 地物规则
• 迷雾
• 物品
• 战利品表
• 模型
• 粒子
• 配方（模式列表）
• 渲染控制器
• 生成组
• 生成规则
• 交易
• 功能域

接口

下方列出了国际版数据驱动接口：

• 行为树
• 生物群系
• 相机
• 维度
• 实体
• 迷雾
• 物品
• 方块
• 粒子
• 生成组
• 生成规则
• 功能域

以上均为最新测试版的内容，欲查看当前最新测试版或预览版（1.19.70.20）中已被移除或被禁用的组件，请前往过时内容页面查看。