展示实体(Display)是一类用于灵活展示多种内容的实体,共有方块展示实体(Block Display)、物品展示实体(Item Display)、文本展示实体(Text Display)三种,分别用于展示方块、物品和文本。
生成[]
方块展示实体、物品展示实体和文本展示实体只能通过/summon
命令生成。
行为[]
展示实体自身没有移动行为,不会受到伤害,不会发出声音,不会阻碍方块放置,也不会将玩家或其他实体推开自己所在的位置。
使用调试组合键F3 + B时,展示实体不会显示判定箱,但是会显示代表其朝向的蓝色线段。
展示实体无法被选中,因此无法通过使用F3 + I将其实体数据复制到粘贴板。
使用不带实体数据参数的/summon
命令生成的展示实体是不可见的。对于方块展示实体和物品展示实体,其默认展示内容是minecraft:air
。对于文本展示实体,其默认展示内容是{"text":""}
。修改其实体数据,可以设置展示的内容和其他视觉效果,并旋转、缩放和平移模型。
对于物品展示实体,除了使用/data
操作实体数据外,还可以使用/loot
或/item
命令在container.0
槽位获取或变更展示的物品。
使用物品展示实体,配合custom_model_data
可以很方便的展示任何自定义模型。
插值[]
展示实体的某些属性可以通过插值实现渐变动画。
实体数据中所有标记为“可插值”的属性都可以插值,并且相互之间并非独立运作。对任一可插值属性的任何变更都会使客户端记录下之前的值和变更后的值。每游戏刻服务器最多与客户端同步一次实体,因此一游戏刻内的多次变更仍将计为单个变更。
实体将随时间在之前的值和当前值之间插值渐变。客户端接收到变更的start_interpolation
游戏刻后开始插值,并持续interpolation_duration
游戏刻,从接收变更到转变为变更后的状态一共需要start_interpolation + interpolation_duration
游戏刻。
数据值[]
ID[]
实体 | 命名空间ID | 本地化键名 |
---|---|---|
方块展示实体 | block_display | entity.minecraft.block_display |
物品展示实体 | item_display | entity.minecraft.item_display |
文本展示实体 | text_display | entity.minecraft.text_display |
实体数据[]
方块展示实体、物品展示实体和文本展示实体有与之相联系的包含许多该实体属性的存档数据。
物品展示实体:
- 根标签
- 实体共通标签
- 展示实体共通标签
- item:要展示的物品。
- 物品共通标签
- item_display:物品展示实体的模式,用于再次变换物品模型。可以为
none
(不变换)、thirdperson_lefthand
(第三人称视角左手变换)、thirdperson_righthand
(第三人称视角右手变换)、firstperson_lefthand
(第一人称视角左手变换)、firstperson_righthand
(第一人称视角右手变换)、head
(放置在头部物品栏的变换)、gui
(在图形界面中的变换)、ground
(平铺在地面的变换)和fixed
(默认变换)。默认为fixed
。
方块展示实体:
- 根标签
- 实体共通标签
- 展示实体共通标签
- block_state:要展示的方块状态。
- 方块状态
文本展示实体:
- 根标签
- 实体共通标签
- 展示实体共通标签
- alignment:文本对齐方向。可以为
center
(居中)、left
(左对齐)和right
(右对齐)。 - background:(可插值)文本展示实体的背景颜色,各颜色通道按ARGB排列。由于在渲染时会自动丢弃Alpha通道小于0.1的片段,所以当A小于26(0x1A)时背景会变为完全透明。默认为1073741824(0x40000000)。
- default_background:表示是否使用默认的文本背景,此项会覆盖 background的更改。默认为false。
- line_width:一行文本的最大宽度。如果展示文本超过了这个宽度会进行换行。默认为200。
- see_through:表示此文本展示实体是否能穿过方块渲染。默认为false。
- shadow:表示文本是否显示阴影。默认为false。
- text:要展示的文本,是一个原始JSON文本。
- text_opacity:(可插值)文本的不透明度,取值为-128~127。由于Java中没有无符号整数,所以大于127的值需要用
<opacity>-256
进行替代。当取值为4~25时渲染片段将直接丢弃,这时文本会完全透明而不可见。默认为-1,即不透明度255,完全不透明。
历史[]
Java版 | |||||
---|---|---|---|---|---|
1.19.4 | 23w06a | 加入了方块展示实体、物品展示实体和文本展示实体。 |
语言