BlockDebugTools

Block Debug Tools 是一个轻量级命令工具，面向模组开发者、整合包作者、地图制作者和服务器管理员，用于检查方块放置与世界生成情况。

该模组可以定位任何已注册的原版或模组方块最近的一个实例，显示其坐标，将执行命令的玩家传送到其附近的安全位置，或在所选半径内统计匹配方块的数量。

所有搜索都在玩家当前所在维度中进行。

功能特性

• 定位最近的匹配方块
• 将玩家传送到所定位方块附近的安全位置
• 显示方块坐标而不传送玩家
• 在真正的三维球体内统计匹配方块数量
• 支持原版和已注册的模组方块
• 使用 Minecraft 原生的方块自动补全功能
• 显示距离、搜索半径、中心坐标和扫描时间
• 无需额外的库模组

命令

查找并传送

/findblock <block> [radius]

查找最近的匹配方块，并将玩家传送到其附近的安全空气位置。

示例：

/findblock minecraft:deepslate
/findblock minecraft:diamond_ore 100
/findblock modid:block_name 64

当省略半径时，默认使用 64 格的半径。

仅查找坐标

/findblockpos <block> [radius]

查找最近的匹配方块而不传送玩家。

示例：

/findblockpos minecraft:granite 50
/findblockpos minecraft:ancient_debris 128

统计方块数量

/countblock <block> <radius>

在以玩家方块位置为中心的真正三维球体内，统计每个匹配方块的数量。

示例：

/countblock minecraft:granite 50
/countblock minecraft:deepslate 64
/countblock modid:block_name 80

权限

所有命令都需要游戏管理员（Game Master）权限。

在单人游戏中，必须启用作弊。在专用服务器上，玩家必须拥有所需的管理员权限。

命令必须由玩家执行，目前无法直接从服务器控制台使用。

兼容性

• Minecraft 26.2
• NeoForge 26.2.0.59 或更新版本
• Java 25
• 服务端命令逻辑
• 无额外模组依赖

对于单人游戏，请将模组安装到客户端配置文件中，以便在集成服务器上运行。对于多人游戏管理，请将其安装在专用服务器的 mods 文件夹中。

搜索限制

• 默认的 /findblock 和 /findblockpos 半径：64 格
• 最大半径：128 格
• /countblock 需要明确指定半径
• 搜索使用真实的球体而非立方体

性能警告

方块扫描是同步执行的。

较大的搜索半径可能会导致集成或专用服务器短暂卡顿，尤其是在使用 /countblock 时。建议日常调试使用 32 到 64 之间的半径。仅在必要时才使用 128 的半径。

当前限制

• 1.0.3 版本不支持方块标签，例如 #minecraft:logs。
• 匹配是按方块类型进行的。像朝向、轴或含水状态等单独的方块状态属性不会被单独筛选。
• 搜索只检查玩家当前所在的维度。
• 该模组不提供图形界面或配置界面。

预期用途

Block Debug Tools 适用于：

• 测试矿石和地形生成
• 检查模组方块是否生成正确
• 调试结构放置
• 检查整合包世界生成
• 验证数据包和模组的兼容性
• 在开发期间定位稀有方块
• 统计测试位置周围生成的方块数量

整合包使用许可

只要使用原始 CurseForge 托管的文件，并且不单独重新托管或分发该模组，您可以将 Block Debug Tools 包含在 CurseForge 整合包中。