方块-Block

包含了一系列关于方块的操作

参考链接：微软文档 Block

属性

dimension

只读返回方块所在的维度

Details

类型：

Dimension

示例：

block_dim = block.dimension

location

只读指定方块的坐标

Details

类型：

Vector3

示例：

pos = block.location
print(f"方块位置: {pos.x}, {pos.y}, {pos.z}")

type

只读获取方块的类型

Details

类型：

BlockType

示例：

block_type = block.type

typeId

只读获取方块的类型ID

Details

类型：

str

示例：

type_id = block.typeId

isAir

只读如果方块是空气则返回true

Details

类型：

bool

示例：

if block.isAir:
    print("这是空气方块")

isLiquid

只读如果方块是液体方块则返回true

Details

类型：

bool

示例：

if block.isLiquid:
    print("这是液体方块")

isWaterloggeed

只读返回或设置此方块是否有水

Details

类型：

bool

示例：

if block.isWaterloggeed:
    print("方块被水淹没")

permutation

只读描述方块的附加方块配置数据

Details

类型：

BlockPermutation

示例：

perm = block.permutation

x

只读方块的X坐标

Details

类型：

int

示例：

x_pos = block.x

y

只读方块的Y坐标

Details

类型：

int

示例：

y_pos = block.y

z

只读方块的Z坐标

Details

类型：

int

示例：

z_pos = block.z

方法

above

返回此方块上方的方块（Y轴正方向）

Details

above(steps=1)

参数：

steps
- 向上的步数
- 类型：int

返回值类型：

Block

示例：

# 获取上方1格的方块
block_above = block.above()

# 获取上方3格的方块
block_above_3 = block.above(3)

below

返回此方块下方的方块（Y轴负方向）

Details

below(steps=1)

参数：

steps
- 向下的步数
- 类型：int

返回值类型：

Block

示例：

# 获取下方1格的方块
block_below = block.below()

# 获取下方2格的方块
block_below_2 = block.below(2)

east

返回此方块东侧的方块（X轴正方向）

Details

east(steps=1)

参数：

steps
- 向东的步数
- 类型：int

返回值类型：

Block

示例：

# 获取东侧1格的方块
block_east = block.east()

west

返回此方块西侧的方块（X轴负方向）

Details

west(steps=1)

参数：

steps
- 向西的步数
- 类型：int

返回值类型：

Block

示例：

# 获取西侧1格的方块
block_west = block.west()

north

返回此方块北侧的方块（Z轴负方向）

Details

north(steps=1)

参数：

steps
- 向北的步数
- 类型：int

返回值类型：

Block

示例：

# 获取北侧1格的方块
block_north = block.north()

south

返回此方块南侧的方块（Z轴正方向）

Details

south(steps=1)

参数：

steps
- 向南的步数
- 类型：int

返回值类型：

Block

示例：

# 获取南侧1格的方块
block_south = block.south()

bottomCenter

返回此方块在X和Z轴上中心点的Vector3

Details

bottomCenter()

返回值类型：

Vector3

示例：

center = block.bottomCenter()
print(f"方块底部中心: {center.x}, {center.y}, {center.z}")

setPermutation

将维度中的方块设置为指定排列的状态

Details

setPermutation(permutation)

参数：

permutation
- 方块排列
- 类型：BlockPermutation

无返回值

示例：

# 设置方块的排列状态
block.setPermutation(new_permutation)

getTags

返回方块的标签集合

Details

getTags()

返回值类型：

list[str]

示例：

tags = block.getTags()
for tag in tags:
    print(f"标签: {tag}")

hasTag

检查此方块的排列是否具有特定标签

Details

hasTag(tag)

参数：

tag
- 要检查的标签
- 类型：str

返回值类型：

bool

示例：

if block.hasTag("minecraft:dirt"):
    print("这是泥土类方块")

hasComponent

如果指定组件存在于此方块上则返回true

Details

hasComponent(componentId)

参数：

componentId
- 组件ID
- 类型：str

返回值类型：

bool

示例：

if block.hasComponent("minecraft:inventory"):
    print("这个方块有物品栏组件")

getComponent

获取实体的组件（表示额外能力）

Details

getComponent(componentId)

参数：

componentId
- 组件ID
- 类型：str

返回值类型：

BlockComponent

示例：

# 获取方块的物品栏组件
inventory_component = block.getComponent("minecraft:inventory")

属性​

dimension​

类型：​

示例：​

location​

类型：​

示例：​

type​

类型：​

示例：​

typeId​

类型：​

示例：​

isAir​

类型：​

示例：​

isLiquid​

类型：​

示例：​

isWaterloggeed​

类型：​

示例：​

permutation​

类型：​

示例：​

x​

类型：​

示例：​

y​

类型：​

示例：​

z​

类型：​

示例：​

方法​

above​

参数：​

返回值类型：​

示例：​

below​

参数：​

返回值类型：​

示例：​

east​

参数：​

返回值类型：​

示例：​

west​

参数：​

返回值类型：​

示例：​

north​

参数：​

返回值类型：​

示例：​

south​

参数：​

返回值类型：​

示例：​

bottomCenter​

返回值类型：​

示例：​

setPermutation​

参数：​

无返回值​

示例：​

getTags​

返回值类型：​

示例：​

hasTag​

参数：​

返回值类型：​

示例：​

hasComponent​

参数：​

返回值类型：​

示例：​

getComponent​

参数：​

返回值类型：​

属性

dimension

类型：

示例：

location

类型：

示例：

type

类型：

示例：

typeId

类型：

示例：

isAir

类型：

示例：

isLiquid

类型：

示例：

isWaterloggeed

类型：

示例：

permutation

类型：

示例：

x

类型：

示例：

y

类型：

示例：

z

类型：

示例：

方法

above

参数：

返回值类型：

示例：

below

参数：

返回值类型：

示例：

east

参数：

返回值类型：

示例：

west

参数：

返回值类型：

示例：

north

参数：

返回值类型：

示例：

south

参数：

返回值类型：

示例：

bottomCenter

返回值类型：

示例：

setPermutation

参数：

无返回值

示例：

getTags

返回值类型：

示例：

hasTag

参数：

返回值类型：

示例：

hasComponent

参数：

返回值类型：

示例：

getComponent

参数：

返回值类型：