[RB]方块替换 (ReplaceBlock) - MC百科

简介

此数据包提供了一个强大的 API，可以以完全原版的方式在世界生成后高性能地替换世界中的方块。

功能

此数据包以区块为单位遍历并替换方块，每次调用会从目标实体所在区块向远处遍历，直到成功清除一个区块，或者遍历完加载范围内所有区块。遍历范围可以进行配置，见下文。

调用

要调用 API，请先在您命令存储的 {}.replace_block 中存储 API 配置，可调用 replace_block:api/reset_settings 函数并传入 {storage:"您命令存储的命名空间 ID"} 生成示例配置，然后调用 replace_block:api/execute 函数并传入 {storage:"您命令存储的命名空间 ID"}。方块替换将立即开始，并在同一 Tick 内结束。请务必确认您的配置包含所有要求的数据，ReplaceBlock 会验证您的配置参数，若缺失参数会导致 API 调用失败。

配置

以下为完整的配置列表，另可查看 reset_settings.mcfunction 中的示例。

目标选择器：

路径：{}.replace_block.selector；

内容：一个目标选择器，可包含参数；

示例："@e[type=player]"。

替换范围：

路径：{}.replace_block.search_range；

内容：遍历距离，为 1 即以玩家为中心的 9 个区块；

示例：3。

成功数量：

路径：{}.replace_block.success_threshold；

内容：一次区块替换视为成功所需的方块替换数量，如果某区块所有方块对成功替换的方块数量总和未达到此数值，则继续遍历下一区块；

示例：50。

要替换的方块对列表：

路径：{}.replace_block.replace_pairs[].replace_with；

内容：新方块的命名空间 ID；

示例："air"；

路径：{}.replace_block.replace_pairs[].target_block；

内容：将被替换方块的命名空间 ID；

示例："stone"；

target_block；

replace_with。

替换生效维度列表：

路径：{}.replace_block.dimensions[].max_y；

内容：替换生效的最大高度；

示例：319；

路径：{}.replace_block.dimensions[].min_y；

内容：替换生效的最小高度；

示例：-64；

路径：{}.replace_block.dimensions[].dimension；

内容：替换生效维度的命名空间 ID；

示例："minecraft:overworld"；

dimension；

min_y；

max_y。