虚拟组件

:::warning 弃用警告

'虚拟组件'是一个旧版概念，现已被实体属性取代。建议尽可能使用实体属性代替。 :::

虚拟组件是仅用于数据存储的"无功能"组件。它们本身不会产生任何实际效果，需要配合其他机制才能发挥作用。这类组件的主要价值在于可将数据存储在实体上，并通过Molang查询来驱动图形/游戏机制。

典型案例包括 variant（变种）和 mark_variant（标记变种）。这些组件接受整数值设置，在原版资源包中用于定义猫和马匹的贴图选择。另一个典型案例是 is_tamed（驯服状态），用于控制马匹能否被骑乘。

虚拟组件的优势在于能够将数据与实体绑定，并通过Molang查询调用这些信息。

整型虚拟组件

整型组件存储整数值（例如1、10、1423），可使用Molang查询进行读取，是最常用的虚拟组件类型。

布尔型虚拟组件

布尔型组件存储单一状态信息，包括 True（真）和 False（假）。以 is_tamed 为例，组件存在表示为 True（已驯服），不存在则为 False（未驯服）。

组件列表

类型	查询语句	组件名称	备注
整型	q.variant	minecraft:variant
整型	q.mark_variant	minecraft:mark_variant
整型	q.skin_id	minecraft:skin_id
整型*	使用类似 `"test": "is_color"` 的过滤器，下方提供颜色列表	minecraft:color	同时在材质系统中设置颜色
整型*	无对应过滤器语法，可使用 `"has_component"`	minecraft:color2	同时在材质系统中设置颜色
布尔型	q.is_illager_captain	minecraft:is_illager_captain
布尔型	q.is_baby	minecraft:is_baby	禁用`minecraft:breedable`组件功能
布尔型	q.is_sheared	minecraft:is_sheared
布尔型	q.is_saddled	minecraft:is_saddled
布尔型	q.is_tamed	minecraft:is_tamed
布尔型	q.is_chested	minecraft:is_chested	死亡时会掉落储存箱
布尔型	q.is_powered	minecraft:is_charged
布尔型	q.is_stunned	minecraft:is_stunned
布尔型	q.can_climb	minecraft:can_climb	允许实体攀爬梯子
布尔型	q.can_fly	minecraft:can_fly	标记实体具有飞行能力，路径查找器将不限于下方有固体方块的位置
布尔型	q.can_power_jump	minecraft:can_power_jump	允许实体执行强力跳跃（如原版马匹动作）
布尔型	q.is_ignited	minecraft:is_ignited
布尔型	q.out_of_control	minecraft:out_of_control	新版功能，用于处理船体硬编码运动/粒子效果，Molang q查询可安全
布尔型	q.has_any_family('monster')	minecraft:type_family	可检测指定Family类型（如'monster'）返回布尔值

color与color2组件颜色对照表

::: code-group

-   black
-   blue
-   brown
-   cyan
-   gray
-   green
-   light_blue
-   light_green
-   magenta
-   orange
-   pink
-   purple
-   red
-   silver
-   white
-   yellow

:::

6.8 KiB Raw Permalink Blame History Unescape Escape

虚拟组件

整型虚拟组件

布尔型虚拟组件

组件列表

color与color2组件颜色对照表

6.8 KiB

Raw Permalink Blame History