ReplaceBlock

数据包

· 作者 white_elephant

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

0 本站下载 0 关注 更新于 1 个月前

需要前置:Localization Resource Pack

最新 2.0.0+mod · 1.21.10 · Fabric / Forge

一键开服(送7天)

[RB]方块替换 (ReplaceBlock)

英文说明见下文。

简介

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

功能

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

调用

下文会以 {{storage}} 作为占位符,代指您命令存储的命名空间 ID,例如 test:test。

  • 准备配置:请在您命令存储的 {}.replace_block 中存储 API 配置,可调用 replace_block:api/reset_settings 函数并传入 {storage:"{{storage}}"} 生成示例配置。完整配置格式见下文。
  • 调用函数:调用 replace_block:api/execute 函数并传入 {storage:"{{storage}}"},ReplaceBlock 会检测配置并从命令上下文中的命令执行位置开始遍历和替换。例如,如果要以一个命令方块为中心进行方块替换,在命令方块中输入 function replace_block:api/execute {storage:"{{storage}}"};如果要以所有玩家为中心进行方块替换,运行 execute at @a run function replace_block:api/execute {storage:"{{storage}}"}(注意,使用 as 修改命令执行者不会对 api 产生任何影响,api 只会读取由 at 更新的位置);如果要以玩家自己为中心进行方块替换,在聊天栏输入 /function replace_block:api/execute {storage:"{{storage}}"}。
  • 函数返回:如果成功替换了一个或多个区块,replace_block:api/execute 函数会返回替换成功的方块总数,如果配置解析错误、维度未加载、遍历范围到达上限等原因并没有成功执行过一次方块替换,函数会返回 fail。

配置

以下为完整的配置列表,缺一不可,ReplaceBlock 不会自动回退到某个默认值。

某些字符串会被展开进宏函数,如果提供的值非法,ReplaceBlock 可能会产生一些错误的行为而不一定有明确的报错。

另可查看 reset_settings.mcfunction 中的示例。

  • 替换范围:
    • 路径:{}.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
      • 内容:替换生效的最小高度,配置错误会导致 fill 命令失败
      • 示例:-64
    • max_y
      • 路径:{}.replace_block.dimensions[].max_y
      • 内容:替换生效的最大高度,配置错误会导致 fill 命令失败
      • 示例:319

Introduction

This datapack provides a powerful API that can replace blocks in the world after world generation in a completely vanilla way with high performance.

Features

此数据包逐区块地遍历并替换方块。每次调用会从当前区块向外扩展,直到成功清空一个区块,或者直到已遍历范围内所有已加载的区块为止。遍历范围可配置,详见下文。

用法

在下文中,{{storage}} 用作命令存储命名空间 ID 的占位符,例如 test:test。

  • 准备配置:将 API 配置存储在命令存储的 {}.replace_block 中。你可以调用 replace_block:api/reset_settings 函数并传入 {storage:"{{storage}}"} 来生成示例配置。完整配置格式见下文。
  • 调用函数:调用 replace_block:api/execute 函数并传入 {storage:"{{storage}}"}。ReplaceBlock 会检查配置,并从命令上下文中的命令执行位置开始进行遍历和替换。例如,若要围绕命令方块替换方块,请在命令方块中输入 function replace_block:api/execute {storage:"{{storage}}"};若要围绕所有玩家替换方块,请运行 execute at @a run function replace_block:api/execute {storage:"{{storage}}"}(注意,使用 as 更改执行实体对 API 没有影响,API 仅读取由 at 更新的位置);若要围绕你自己替换方块,请在聊天栏中输入 /function replace_block:api/execute {storage:"{{storage}}"}。
  • 返回值:如果成功替换了一个或多个区块,replace_block:api/execute 函数将返回成功替换的方块总数。如果由于配置解析错误、维度未加载、遍历范围达到限制等原因导致未成功执行任何方块替换,该函数将返回 fail。

配置

以下是完整的配置选项列表。不得省略其中任何一项;ReplaceBlock 不会自动回退到任何默认值。

某些值会被插入到宏函数中。如果提供了无效值,ReplaceBlock 可能会出现行为异常,且可能没有明确的错误提示。

你也可以在 reset_settings.mcfunction 中查看示例。

  • 搜索范围:
    • 路径:{}.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
      • 描述:替换生效的最小高度;配置错误会导致 fill 命令失败
      • 示例:-64
    • max_y
      • 路径:{}.replace_block.dimensions[].max_y
      • 描述:替换生效的最大高度;配置错误会导致 fill 命令失败
      • 示例:319

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源