Skip to content

索引

包括方块及方块实体属性的接口,方块的放置和获取见世界/方块管理


方块状态与附加值

接口
描述
GetBlockAuxValueFromStates服务端根据方块名称和方块状态获取方块附加值AuxValue
GetBlockStates服务端获取方块状态
GetBlockStatesFromAuxValue服务端根据方块名称和方块附加值AuxValue获取方块状态
SetBlockStates服务端设置方块状态

属性

接口
描述
GetBlockBasicInfo服务端获取方块基本信息
GetBlockTags服务端获取方块在tags:*中定义的tags列表
GetLoadBlocks服务端获取已经加载的方块id
SetBlockBasicInfo服务端设置方块基本信息
SetChestLootTable服务端设置箱子战利品表

方块实体

接口
描述
CleanBlockTileEntityCustomData服务端清空指定位置的特殊方块(箱子、头颅、熔炉、花盆等)绑定的TileEntity内存储的自定义数据。
CreateFrameEffectForBlockEntity客户端在自定义方块实体上创建序列帧特效,创建后该接口返回序列帧特效的Id,利用该Id可以使用特效/序列帧中的接口对该序列帧特效进行播放、设置位置、大小等操作。与实体的序列帧特效创建方式类似。
CreateParticleEffectForBlockEntity客户端在自定义方块实体上创建粒子特效,创建后该接口返回粒子特效的Id,利用该Id可以使用特效/粒子中的接口对该粒子特效进行播放、设置位置、大小等操作。与实体的粒子特效创建方式类似。若自定义方块实体已存在键值名称相同的特效,则不会创建新的特效,接口返回已有的特效Id。
ExecuteCommandBlock服务端执行一次命令方块
GetBlockEntityData服务端用于获取可操作某个自定义方块实体数据的对象,操作方式与dict类似
GetBlockEntityData服务端用于获取方块(包括自定义方块)的数据,如需修改,请使用setblockentitydata接口
GetBlockEntityData客户端用于获取客户端当前维度中方块(包括自定义方块)的数据,数据只读不可写,无法获取箱子内的物品信息。
GetBlockEntityMolangValue客户端获取自定义方块实体的Molang变量的值。
GetBlockTileEntityCustomData服务端读取指定位置的特殊方块(箱子、头颅、熔炉、花盆等)绑定的TileEntity内存储的自定义数据
GetBlockTileEntityWholeCustomData服务端读取指定位置的特殊方块(箱子、头颅、熔炉、花盆等)绑定的TileEntity内存储的自定义数据字典。
GetCommandBlock服务端获取命令方块的设置内容
GetFrameEffectIdInBlockEntity客户端获取在自定义方块实体中已创建的指定序列帧特效的Id,已创建的特效分为两种:一是通过resource_pack/entity/下的实体json文件中使用“netease_frame_effects”所定义的特效;二是使用接口CreateFrameEffectForBlockEntity创建的特效。 返回的特效Id可以使用特效/序列帧中的接口对该序列帧特效进行播放、设置位置、大小等操作。与实体的序列帧特效创建方式类似。
GetFrameItem服务端获取物品展示框的物品
GetFrameItemDropChange服务端获取物品展示框里物品的掉落几率
GetFrameRotation服务端获取物品展示框里物品的顺时针旋转角度
GetHopperSpeed服务端获取漏斗运输一个物品所需的时间(单位:刻)
GetParticleEffectIdInBlockEntity客户端获取在自定义方块实体中已创建的指定粒子特效的Id,已创建的特效分为两种:一是通过resource_pack/entity/下的实体json文件中使用“netease_particle_effects”所定义的特效;二是使用接口CreateParticleEffectForBlockEntity创建的特效。 返回的特效Id可以使用特效/粒子中的接口对该粒子特效进行播放、设置位置、大小等操作。与实体的粒子特效创建方式类似。
RemoveFrameEffectInBlockEntity客户端移除在自定义方块实体上创建的序列帧特效。移除后的特效Id将会失效。
RemoveParticleEffectInBlockEntity客户端移除在自定义方块实体上创建的粒子特效。移除后的特效Id将会失效。
SetBlockEntityData服务端用于设置方块(包括自定义方块)的数据
SetBlockEntityMolangValue客户端设置自定义方块实体的Molang变量,与实体的molang变量作用相同。目前主要用于控制自定义实体的动画状态转变。Molang变量的定义方式与原版实体的Molang变量定义方法相同。详细可参考自定义方块实体动画的教学文档。
SetBlockTileEntityCustomData服务端设置指定位置的特殊方块(箱子、头颅、熔炉、花盆等)绑定的TileEntity内存储的自定义数据。
SetCommandBlock服务端对命令方块进行内容设置
SetEnableBlockEntityAnimations客户端设置是否开启自定义方块实体的动画效果,开启之后,自定义实体方块会按照实体文件中animation_controller所定义的动画状态机进行动画播放。关闭之后,则会停止所有动画播放。
SetFrameItem服务端设置物品展示框的物品
SetFrameItemDropChange服务端设置点击物品展示框时生成掉落的几率,默认为1
SetFrameRotation服务端设置物品展示框里物品的顺时针旋转角度
SetHopperSpeed服务端设置漏斗运输一个物品所需的时间(单位:红石刻,1秒10刻),默认值为4刻,该设置存档

方块几何体模型

接口
描述
CombineBlockBetweenPosToGeometry客户端根据输入的两个位置,搜索这两个位置之间的所有方块,并将这些方块合并和转换为能用于实体的几何体模型。
CombineBlockFromPosListToGeometry客户端根据输入的方块位置列表,搜索这些位置的所有方块,并将这些方块合并和转换为能用于实体的几何体模型。
CombineBlockPaletteToGeometry客户端将BlockPalette中的所有方块合并并转换为能用于实体的几何体模型。
EnableActorBlockGeometryTransparent客户端设置是否允许实体的方块几何体模型产生透明度,允许开启后通过调节方块几何体的透明度将会使得方块几何体模型变得透明。
GetActorBlockGeometryScale客户端获取实体的方块几何体模型的缩放倍率。
SetActorBlockGeometryOffset客户端设置实体的方块几何体模型的位置偏移。
SetActorBlockGeometryRotation客户端设置实体的方块几何体模型的旋转角度。
SetActorBlockGeometryScale客户端设置实体的方块几何体模型的缩放倍率。
SetActorBlockGeometryTransparency客户端设置实体的方块几何体模型的透明度。注意,只有调用接口EnableActorBlockGeometryTransparent开启了方块几何体模型的透明度后该接口才会生效。

方块调色板

接口
描述
DeleteBlockInBlockPalette服务端
客户端
删除方块调色板BlockPalette中某个类型的方块。
DeserializeBlockPalette服务端
客户端
反序列化方块调色板数据字典中的数据,用于方块调色板在客户端及服务端的事件数据之间传输。
GetBlockCountInBlockPalette服务端
客户端
获取方块调色板BlockPalette中某个类型的方块的数量。
GetLocalPosListOfBlocks服务端
客户端
获取方块调色板中某种方块的相对位置列表。方块调色板记录了多个方块组成的一个三维空间下的方块组合,而相对位置则指的是,以这些方块中最小坐标的方块所在位置作为原点的坐标轴下的相对位置。
GetVolumeOfBlockPalette服务端
客户端
获取方块调色板BlockPalette所占据的长方体的长宽高。长指的是在方块调色板BlockPalette在世界坐标中占据的x轴方向的长度,宽指的是z轴方向的长度,高指的是y轴方向的长度。
ReplaceAirByStructureVoid服务端
客户端
设置是否将方块调色板BlockPalette中所有空气替换为结构空位。
ReplaceBlockInBlockPalette服务端
客户端
替换方块调色板BlockPalette中某个类型的方块。
SerializeBlockPalette服务端
客户端
序列化方块调色板中的数据,用于方块调色板在客户端及服务端的事件数据之间传输。

渲染

接口
描述
AddDropItemToWorld客户端在客户端添加一个掉落物渲染
ChangeBlockTextures客户端替换方块贴图
DeleteClientDropItemEntity客户端删除AddDropItemToWorld创建的客户端掉落物
GetBlockEntityExtraUniforms客户端获取在自定义方块实体的shader当中使用的自定义变量的值,该自定义变量总共可设置EXTRA_ACTOR_UNIFORM1,EXTRA_ACTOR_UNIFORM2,EXTRA_ACTOR_UNIFORM3,EXTRA_ACTOR_UNIFORM4,总共4组,每组为一个vec4(float, float, float ,float)类型的向量。
GetBlockRenderDistance客户端获取玩家周围的可渲染距离
GetBlockTextures客户端获取方块的初始贴图信息
GetClientDropItemEntityIdList客户端获得所有通过AddDropItemToWorld创建的entityId的list
SetBlockEntityExtraUniforms客户端设置可在自定义方块实体的shader当中使用的自定义变量的值,该自定义变量总共可设置EXTRA_ACTOR_UNIFORM1,EXTRA_ACTOR_UNIFORM2,EXTRA_ACTOR_UNIFORM3,EXTRA_ACTOR_UNIFORM4,总共4组,每组为一个vec4(float, float, float ,float)类型的向量,向量的默认值为(1.0,1.0,1.0,1.0)。
SetBlockEntityFramePosOffset客户端设置自定义方块实体中序列帧特效位置偏移值,用于调整序列帧特效相对于方块位置的偏移。与特效/序列帧/SetPos接口不同,该接口调整的是相对于方块位置的位置偏移值,而不是世界坐标。
SetBlockEntityModelPosOffset客户端设置自定义方块实体的实体模型位置偏移值,用于调整实体模型相对于方块位置的偏移。可通过该接口来调整自定义方块实体的实体模型的位置。只有自定义方块实体定义实体模型才生效,实体模型在resource_pack/entity/下定义,详细可参考自定义方块实体动画的教学文档。
SetBlockEntityModelRotation客户端设置自定义方块实体的实体模型在各个轴上的旋转值,可通过该接口来调整自定义方块实体的实体模型的旋转。只有自定义方块实体定义实体模型才生效,实体模型在resource_pack/entity/下定义,详细可参考自定义方块实体动画的教学文档。
SetBlockEntityModelScale客户端设置自定义方块实体的实体模型大小的缩放值,可通过该接口来调整自定义方块实体的实体模型的大小。只有自定义方块实体定义实体模型才生效,实体模型在resource_pack/entity/下定义,详细可参考自定义方块实体动画的教学文档。
SetBlockEntityParticlePosOffset客户端设置自定义方块实体中粒子特效位置偏移值,用于调整粒子特效相对于方块位置的偏移。与特效/粒子/SetPos接口不同,该接口调整的是相对于方块位置的位置偏移值,而不是世界坐标。
SetBlockRenderDistance客户端设置玩家周围方块的可渲染距离

容器

接口
描述
GetBrewingStandSlotItem服务端获取酿造台指定槽位物品
GetChestBoxSize服务端获取箱子容量大小
GetChestPairedPosition服务端获取与箱子A合并成一个大箱子的箱子B的坐标
GetContainerItem服务端获取容器内的物品
GetContainerSize服务端获取容器容量大小
GetEnderChestItem服务端获取末影箱内的物品
GetInputSlotItem服务端获取熔炉输入栏物品, 支持使用下面参数清空特定槽位:itemDict为空,为{}, 或itemName为minecraft:air,或者count为0
GetOpenContainerItem服务端获取开放容器的物品
GetOutputSlotItem服务端获取熔炉输出栏物品
GetPlayerUIItem服务端获取合成容器的物品
SetBrewingStandSlotItem服务端设置酿造台指定槽位物品
SetChestBoxItemExchange服务端交换箱子里物品的槽位
SetChestBoxItemNum服务端设置箱子槽位物品数目
SetInputSlotItem服务端设置熔炉输入栏物品
SetPlayerUIItem服务端设置合成容器的物品
SpawnItemToContainer服务端生成物品到容器方块的物品栏
SpawnItemToEnderChest服务端生成物品到末影箱

红石

接口
描述
GetBlockPoweredState服务端获取某个坐标方块的充能状态
GetStrength服务端获取某个坐标的红石信号强度

告示牌

接口
描述
GetSignBlockText服务端获取告示牌(方块)的文本内容
GetSignTextStyle服务端获取告示牌的文本样式信息
SetSignBlockText服务端设置告示牌(方块)的文本内容
SetSignTextStyle服务端设置告示牌的文本样式

接口
描述
GetBedColor服务端获取床(方块)的颜色
SetBedColor服务端设置床(方块)的颜色