135 lines
18 KiB
Markdown
135 lines
18 KiB
Markdown
---
|
||
sidebarDepth: 1
|
||
---
|
||
# 索引
|
||
|
||
包括方块及方块实体属性的接口，方块的放置和获取见[世界/方块管理](../世界/索引.md#方块管理)
|
||
|
||
---
|
||
|
||
- [方块状态与附加值](#方块状态与附加值)
|
||
- [方块实体](#方块实体)
|
||
- [方块几何体模型](#方块几何体模型)
|
||
- [方块调色板](#方块调色板)
|
||
- [渲染](#渲染)
|
||
- [容器](#容器)
|
||
- [红石](#红石)
|
||
- [告示牌](#告示牌)
|
||
- [床](#床)
|
||
- [属性](#属性)
|
||
|
||
### 方块状态与附加值
|
||
|
||
| 接口 | <div style="width: 3em"></div> | 描述 |
|
||
| --- | --- | --- |
|
||
| [GetBlockAuxValueFromStates](方块状态与附加值.md#getblockauxvaluefromstates) | <span style="display:inline;color:#ff5555">服务端</span> | 根据方块名称和<a href="../../../../mcguide/20-玩法开发/10-基本概念/1-我的世界基础概念.html#物品信息字典#方块状态">方块状态</a>获取方块附加值AuxValue |
|
||
| [GetBlockStates](方块状态与附加值.md#getblockstates) | <span style="display:inline;color:#ff5555">服务端</span> | 获取<a href="../../../../mcguide/20-玩法开发/10-基本概念/1-我的世界基础概念.html#物品信息字典#方块状态">方块状态</a> |
|
||
| [GetBlockStatesFromAuxValue](方块状态与附加值.md#getblockstatesfromauxvalue) | <span style="display:inline;color:#ff5555">服务端</span> | 根据方块名称和方块附加值AuxValue获取<a href="../../../../mcguide/20-玩法开发/10-基本概念/1-我的世界基础概念.html#物品信息字典#方块状态">方块状态</a> |
|
||
| [SetBlockStates](方块状态与附加值.md#setblockstates) | <span style="display:inline;color:#ff5555">服务端</span> | 设置<a href="../../../../mcguide/20-玩法开发/10-基本概念/1-我的世界基础概念.html#物品信息字典#方块状态">方块状态</a> |
|
||
|
||
### 方块实体
|
||
|
||
| 接口 | <div style="width: 3em"></div> | 描述 |
|
||
| --- | --- | --- |
|
||
| [CleanBlockTileEntityCustomData](方块实体.md#cleanblocktileentitycustomdata) | <span style="display:inline;color:#ff5555">服务端</span> | 清空指定位置的特殊方块（箱子、头颅、熔炉、花盆等）绑定的TileEntity内存储的自定义数据。 |
|
||
| [CreateFrameEffectForBlockEntity](方块实体.md#createframeeffectforblockentity) | <span style="display:inline;color:#7575f9">客户端</span> | 在自定义方块实体上创建序列帧特效，创建后该接口返回序列帧特效的Id，利用该Id可以使用特效/序列帧中的接口对该序列帧特效进行播放、设置位置、大小等操作。与实体的序列帧特效创建方式类似。 |
|
||
| [CreateParticleEffectForBlockEntity](方块实体.md#createparticleeffectforblockentity) | <span style="display:inline;color:#7575f9">客户端</span> | 在自定义方块实体上创建粒子特效，创建后该接口返回粒子特效的Id，利用该Id可以使用特效/粒子中的接口对该粒子特效进行播放、设置位置、大小等操作。与实体的粒子特效创建方式类似。若自定义方块实体已存在键值名称相同的特效，则不会创建新的特效，接口返回已有的特效Id。 |
|
||
| [GetBlockEntityData](方块实体.md#getblockentitydata) | <span style="display:inline;color:#ff5555">服务端</span> | 用于获取可操作某个自定义方块实体数据的对象，操作方式与dict类似 |
|
||
| [GetBlockEntityData](方块实体.md#getblockentitydata) | <span style="display:inline;color:#ff5555">服务端</span> | 用于获取方块（包括自定义方块）的数据，数据只读不可写 |
|
||
| [GetBlockEntityMolangValue](方块实体.md#getblockentitymolangvalue) | <span style="display:inline;color:#7575f9">客户端</span> | 获取自定义方块实体的Molang变量的值。 |
|
||
| [GetBlockTileEntityCustomData](方块实体.md#getblocktileentitycustomdata) | <span style="display:inline;color:#ff5555">服务端</span> | 读取指定位置的特殊方块（箱子、头颅、熔炉、花盆等）绑定的TileEntity内存储的自定义数据 |
|
||
| [GetBlockTileEntityWholeCustomData](方块实体.md#getblocktileentitywholecustomdata) | <span style="display:inline;color:#ff5555">服务端</span> | 读取指定位置的特殊方块（箱子、头颅、熔炉、花盆等）绑定的TileEntity内存储的自定义数据字典。 |
|
||
| [GetFrameEffectIdInBlockEntity](方块实体.md#getframeeffectidinblockentity) | <span style="display:inline;color:#7575f9">客户端</span> | 获取在自定义方块实体中已创建的指定序列帧特效的Id，已创建的特效分为两种：一是通过resource_pack/entity/下的实体json文件中使用“netease_frame_effects”所定义的特效；二是使用接口CreateFrameEffectForBlockEntity创建的特效。 返回的特效Id可以使用特效/序列帧中的接口对该序列帧特效进行播放、设置位置、大小等操作。与实体的序列帧特效创建方式类似。 |
|
||
| [GetParticleEffectIdInBlockEntity](方块实体.md#getparticleeffectidinblockentity) | <span style="display:inline;color:#7575f9">客户端</span> | 获取在自定义方块实体中已创建的指定粒子特效的Id，已创建的特效分为两种：一是通过resource_pack/entity/下的实体json文件中使用“netease_particle_effects”所定义的特效；二是使用接口CreateParticleEffectForBlockEntity创建的特效。 返回的特效Id可以使用特效/粒子中的接口对该粒子特效进行播放、设置位置、大小等操作。与实体的粒子特效创建方式类似。 |
|
||
| [RemoveFrameEffectInBlockEntity](方块实体.md#removeframeeffectinblockentity) | <span style="display:inline;color:#7575f9">客户端</span> | 移除在自定义方块实体上创建的序列帧特效。移除后的特效Id将会失效。 |
|
||
| [RemoveParticleEffectInBlockEntity](方块实体.md#removeparticleeffectinblockentity) | <span style="display:inline;color:#7575f9">客户端</span> | 移除在自定义方块实体上创建的粒子特效。移除后的特效Id将会失效。 |
|
||
| [SetBlockEntityMolangValue](方块实体.md#setblockentitymolangvalue) | <span style="display:inline;color:#7575f9">客户端</span> | 设置自定义方块实体的Molang变量，与实体的molang变量作用相同。目前主要用于控制自定义实体的动画状态转变。Molang变量的定义方式与原版实体的Molang变量定义方法相同。详细可参考自定义方块实体动画的教学文档。 |
|
||
| [SetBlockTileEntityCustomData](方块实体.md#setblocktileentitycustomdata) | <span style="display:inline;color:#ff5555">服务端</span> | 设置指定位置的特殊方块（箱子、头颅、熔炉、花盆等）绑定的TileEntity内存储的自定义数据。 |
|
||
| [SetEnableBlockEntityAnimations](方块实体.md#setenableblockentityanimations) | <span style="display:inline;color:#7575f9">客户端</span> | 设置是否开启自定义方块实体的动画效果，开启之后，自定义实体方块会按照实体文件中animation_controller所定义的动画状态机进行动画播放。关闭之后，则会停止所有动画播放。 |
|
||
|
||
### 方块几何体模型
|
||
|
||
| 接口 | <div style="width: 3em"></div> | 描述 |
|
||
| --- | --- | --- |
|
||
| [CombineBlockBetweenPosToGeometry](方块几何体模型.md#combineblockbetweenpostogeometry) | <span style="display:inline;color:#7575f9">客户端</span> | 根据输入的两个位置，搜索这两个位置之间的所有方块，并将这些方块合并和转换为能用于实体的几何体模型。 |
|
||
| [CombineBlockFromPosListToGeometry](方块几何体模型.md#combineblockfromposlisttogeometry) | <span style="display:inline;color:#7575f9">客户端</span> | 根据输入的方块位置列表，搜索这些位置的所有方块，并将这些方块合并和转换为能用于实体的几何体模型。 |
|
||
| [CombineBlockPaletteToGeometry](方块几何体模型.md#combineblockpalettetogeometry) | <span style="display:inline;color:#7575f9">客户端</span> | 将BlockPalette中的所有方块合并并转换为能用于实体的几何体模型。 |
|
||
| [EnableActorBlockGeometryTransparent](方块几何体模型.md#enableactorblockgeometrytransparent) | <span style="display:inline;color:#7575f9">客户端</span> | 设置是否允许实体的方块几何体模型产生透明度，允许开启后通过调节方块几何体的透明度将会使得方块几何体模型变得透明。 |
|
||
| [SetActorBlockGeometryOffset](方块几何体模型.md#setactorblockgeometryoffset) | <span style="display:inline;color:#7575f9">客户端</span> | 设置实体的方块几何体模型的位置偏移。 |
|
||
| [SetActorBlockGeometryRotation](方块几何体模型.md#setactorblockgeometryrotation) | <span style="display:inline;color:#7575f9">客户端</span> | 设置实体的方块几何体模型的旋转角度。 |
|
||
| [SetActorBlockGeometryTransparency](方块几何体模型.md#setactorblockgeometrytransparency) | <span style="display:inline;color:#7575f9">客户端</span> | 设置实体的方块几何体模型的透明度。注意，只有调用接口EnableActorBlockGeometryTransparent开启了方块几何体模型的透明度后该接口才会生效。 |
|
||
|
||
### 方块调色板
|
||
|
||
| 接口 | <div style="width: 3em"></div> | 描述 |
|
||
| --- | --- | --- |
|
||
| [DeleteBlockInBlockPalette](方块调色板.md#deleteblockinblockpalette) | <span style="display:inline;color:#ff5555">服务端</span><br><span style="display:inline;color:#7575f9">客户端</span> | 删除方块调色板BlockPalette中某个类型的方块。 |
|
||
| [DeserializeBlockPalette](方块调色板.md#deserializeblockpalette) | <span style="display:inline;color:#ff5555">服务端</span><br><span style="display:inline;color:#7575f9">客户端</span> | 反序列化方块调色板数据字典中的数据，用于方块调色板在客户端及服务端的事件数据之间传输。 |
|
||
| [GetBlockCountInBlockPalette](方块调色板.md#getblockcountinblockpalette) | <span style="display:inline;color:#ff5555">服务端</span><br><span style="display:inline;color:#7575f9">客户端</span> | 获取方块调色板BlockPalette中某个类型的方块的数量。 |
|
||
| [GetLocalPosListOfBlocks](方块调色板.md#getlocalposlistofblocks) | <span style="display:inline;color:#ff5555">服务端</span><br><span style="display:inline;color:#7575f9">客户端</span> | 获取方块调色板中某种方块的相对位置列表。方块调色板记录了多个方块组成的一个三维空间下的方块组合，而相对位置则指的是，以这些方块中最小坐标的方块所在位置作为原点的坐标轴下的相对位置。 |
|
||
| [GetVolumeOfBlockPalette](方块调色板.md#getvolumeofblockpalette) | <span style="display:inline;color:#ff5555">服务端</span><br><span style="display:inline;color:#7575f9">客户端</span> | 获取方块调色板BlockPalette所占据的长方体的长宽高。长指的是在方块调色板BlockPalette在世界坐标中占据的x轴方向的长度，宽指的是z轴方向的长度，高指的是y轴方向的长度。 |
|
||
| [ReplaceAirByStructureVoid](方块调色板.md#replaceairbystructurevoid) | <span style="display:inline;color:#ff5555">服务端</span><br><span style="display:inline;color:#7575f9">客户端</span> | 设置是否将方块调色板BlockPalette中所有空气替换为结构空位。 |
|
||
| [ReplaceBlockInBlockPalette](方块调色板.md#replaceblockinblockpalette) | <span style="display:inline;color:#ff5555">服务端</span><br><span style="display:inline;color:#7575f9">客户端</span> | 替换方块调色板BlockPalette中某个类型的方块。 |
|
||
| [SerializeBlockPalette](方块调色板.md#serializeblockpalette) | <span style="display:inline;color:#ff5555">服务端</span><br><span style="display:inline;color:#7575f9">客户端</span> | 序列化方块调色板中的数据，用于方块调色板在客户端及服务端的事件数据之间传输。 |
|
||
|
||
### 渲染
|
||
|
||
| 接口 | <div style="width: 3em"></div> | 描述 |
|
||
| --- | --- | --- |
|
||
| [ChangeBlockTextures](渲染.md#changeblocktextures) | <span style="display:inline;color:#7575f9">客户端</span> | 替换方块贴图 |
|
||
| [GetBlockTextures](渲染.md#getblocktextures) | <span style="display:inline;color:#7575f9">客户端</span> | 获取方块的初始贴图信息 |
|
||
| [SetBlockEntityFramePosOffset](渲染.md#setblockentityframeposoffset) | <span style="display:inline;color:#7575f9">客户端</span> | 设置自定义方块实体中序列帧特效位置偏移值，用于调整序列帧特效相对于方块位置的偏移。与特效/序列帧/SetPos接口不同，该接口调整的是相对于方块位置的位置偏移值，而不是世界坐标。 |
|
||
| [SetBlockEntityModelPosOffset](渲染.md#setblockentitymodelposoffset) | <span style="display:inline;color:#7575f9">客户端</span> | 设置自定义方块实体的实体模型位置偏移值，用于调整实体模型相对于方块位置的偏移。可通过该接口来调整自定义方块实体的实体模型的位置。只有自定义方块实体定义实体模型才生效，实体模型在resource_pack/entity/下定义，详细可参考自定义方块实体动画的教学文档。 |
|
||
| [SetBlockEntityModelRotation](渲染.md#setblockentitymodelrotation) | <span style="display:inline;color:#7575f9">客户端</span> | 设置自定义方块实体的实体模型在各个轴上的旋转值，可通过该接口来调整自定义方块实体的实体模型的旋转。只有自定义方块实体定义实体模型才生效，实体模型在resource_pack/entity/下定义，详细可参考自定义方块实体动画的教学文档。 |
|
||
| [SetBlockEntityModelScale](渲染.md#setblockentitymodelscale) | <span style="display:inline;color:#7575f9">客户端</span> | 设置自定义方块实体的实体模型大小的缩放值，可通过该接口来调整自定义方块实体的实体模型的大小。只有自定义方块实体定义实体模型才生效，实体模型在resource_pack/entity/下定义，详细可参考自定义方块实体动画的教学文档。 |
|
||
| [SetBlockEntityParticlePosOffset](渲染.md#setblockentityparticleposoffset) | <span style="display:inline;color:#7575f9">客户端</span> | 设置自定义方块实体中粒子特效位置偏移值，用于调整粒子特效相对于方块位置的偏移。与特效/粒子/SetPos接口不同，该接口调整的是相对于方块位置的位置偏移值，而不是世界坐标。 |
|
||
|
||
### 容器
|
||
|
||
| 接口 | <div style="width: 3em"></div> | 描述 |
|
||
| --- | --- | --- |
|
||
| [GetChestBoxSize](容器.md#getchestboxsize) | <span style="display:inline;color:#ff5555">服务端</span> | 获取箱子容量大小 |
|
||
| [GetChestPairedPosition](容器.md#getchestpairedposition) | <span style="display:inline;color:#ff5555">服务端</span> | 获取与箱子A合并成一个大箱子的箱子B的坐标 |
|
||
| [GetContainerItem](容器.md#getcontaineritem) | <span style="display:inline;color:#ff5555">服务端</span> | 获取容器内的物品 |
|
||
| [GetContainerSize](容器.md#getcontainersize) | <span style="display:inline;color:#ff5555">服务端</span> | 获取容器容量大小 |
|
||
| [GetEnderChestItem](容器.md#getenderchestitem) | <span style="display:inline;color:#ff5555">服务端</span> | 获取末影箱内的物品 |
|
||
| [GetInputSlotItem](容器.md#getinputslotitem) | <span style="display:inline;color:#ff5555">服务端</span> | 获取熔炉输入栏物品, 支持使用下面参数清空特定槽位:itemDict为空，为{}, 或itemName为minecraft:air，或者count为0 |
|
||
| [GetOpenContainerItem](容器.md#getopencontaineritem) | <span style="display:inline;color:#ff5555">服务端</span> | 获取开放容器的物品 |
|
||
| [GetOutputSlotItem](容器.md#getoutputslotitem) | <span style="display:inline;color:#ff5555">服务端</span> | 获取熔炉输出栏物品 |
|
||
| [GetPlayerUIItem](容器.md#getplayeruiitem) | <span style="display:inline;color:#ff5555">服务端</span> | 获取合成容器的物品 |
|
||
| [SetChestBoxItemExchange](容器.md#setchestboxitemexchange) | <span style="display:inline;color:#ff5555">服务端</span> | 交换箱子里物品的槽位 |
|
||
| [SetChestBoxItemNum](容器.md#setchestboxitemnum) | <span style="display:inline;color:#ff5555">服务端</span> | 设置箱子槽位物品数目 |
|
||
| [SetInputSlotItem](容器.md#setinputslotitem) | <span style="display:inline;color:#ff5555">服务端</span> | 设置熔炉输入栏物品 |
|
||
| [SetPlayerUIItem](容器.md#setplayeruiitem) | <span style="display:inline;color:#ff5555">服务端</span> | 设置合成容器的物品 |
|
||
| [SpawnItemToContainer](容器.md#spawnitemtocontainer) | <span style="display:inline;color:#ff5555">服务端</span> | 生成物品到容器方块的物品栏 |
|
||
| [SpawnItemToEnderChest](容器.md#spawnitemtoenderchest) | <span style="display:inline;color:#ff5555">服务端</span> | 生成物品到末影箱 |
|
||
|
||
### 红石
|
||
|
||
| 接口 | <div style="width: 3em"></div> | 描述 |
|
||
| --- | --- | --- |
|
||
| [GetBlockPoweredState](红石.md#getblockpoweredstate) | <span style="display:inline;color:#ff5555">服务端</span> | 获取某个坐标方块的充能状态 |
|
||
| [GetStrength](红石.md#getstrength) | <span style="display:inline;color:#ff5555">服务端</span> | 获取某个坐标的红石信号强度 |
|
||
|
||
### 告示牌
|
||
|
||
| 接口 | <div style="width: 3em"></div> | 描述 |
|
||
| --- | --- | --- |
|
||
| [GetSignBlockText](告示牌.md#getsignblocktext) | <span style="display:inline;color:#ff5555">服务端</span> | 获取告示牌（方块）的文本内容 |
|
||
| [SetSignBlockText](告示牌.md#setsignblocktext) | <span style="display:inline;color:#ff5555">服务端</span> | 设置告示牌（方块）的文本内容 |
|
||
|
||
### 床
|
||
|
||
| 接口 | <div style="width: 3em"></div> | 描述 |
|
||
| --- | --- | --- |
|
||
| [GetBedColor](床.md#getbedcolor) | <span style="display:inline;color:#ff5555">服务端</span> | 获取床（方块）的颜色 |
|
||
| [SetBedColor](床.md#setbedcolor) | <span style="display:inline;color:#ff5555">服务端</span> | 设置床（方块）的颜色 |
|
||
|
||
### 属性
|
||
|
||
| 接口 | <div style="width: 3em"></div> | 描述 |
|
||
| --- | --- | --- |
|
||
| [GetBlockBasicInfo](属性.md#getblockbasicinfo) | <span style="display:inline;color:#ff5555">服务端</span> | 获取方块基本信息 |
|
||
| [SetBlockBasicInfo](属性.md#setblockbasicinfo) | <span style="display:inline;color:#ff5555">服务端</span> | 设置方块基本信息 |
|
||
|