[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要替换的方块对列表：target_block路径：{}.replace_block.replace_pairs[].target_block内容：将被替换方块的命名空间 ID示例："stone"replace_with路径：{}.replace_block.replace_pairs[].replace_with内容：新方块的命名空间 ID示例："air"替换生效维度列表：dimension路径：{}.replace_block.dimensions[].dimension内容：替换生效维度的命名空间 ID示例："minecraft:overworld"min_y路径：{}.replace_block.dimensions[].min_y内容：替换生效的最小高度示例：-64max_y路径：{}.replace_block.dimensions[].max_y内容：替换生效的最大高度示例：319