指南针方块查找器

指南针方块查找器

罗盘方块查找器让你快速找到我的世界中的任何方块。使用游戏内搜索菜单选择方块，左键点击开始搜索，让罗盘引导你前往最近的已发现位置。

矿石与资源

指南针方块查找器预览查看大图

🧭 Compass Block Finder

Compass Block Finder 是一个 Fabric 模组，它将指南针变成一个简单而强大的方块寻找工具。

从游戏内菜单中选择任意方块，然后使用 Compass Block Finder 在附近的区块中搜索它。当找到该方块时，指南针会指向它的位置。

无需记住坐标。无需手动搜索洞穴。只需选择一个方块并搜索。

✨ 功能

  • 🧭 自定义的 Compass Block Finder 物品
  • 🔎 使用游戏内搜索菜单搜索方块
  • 🧱 从可用的 Minecraft 方块中进行选择
  • ⚡ 从玩家位置开始搜索附近的区块
  • 📍 指南针指向已发现的方块
  • 📊 实时搜索进度
  • 💬 搜索过程中显示清晰的状态消息
  • 🔄 通过左键点击进行手动搜索
  • 📏 搜索玩家周围最多 6 个区块
  • 🎮 专为使用 Fabric 的 Minecraft 设计

📸 截图

方块选择菜单

使用游戏内方块选择菜单选择你想要寻找的方块。

Block Selection Menu

搜索方块

使用搜索框快速找到你要找的方块。

Menu Search

例如，搜索：

melon

将显示匹配搜索的方块。

开始搜索

选择方块后，手持 Compass Block Finder 时左键点击即可开始搜索。

Left Click Search

该模组会从距离你最近的区块开始搜索附近的区块。

你将看到如下进度：

Searching for melon...
Searching for melon... 5/169 chunks

找到方块

当发现匹配的方块时，模组会报告其距离，并且指南针会指向它。

Block Found

示例：

Found Melon - 42.3 blocks away

🎮 使用方法

1. 获取 Compass Block Finder

安装模组并使用 Fabric 加载器启动 Minecraft。

进入你的世界后，从创造模式物品栏中获取 Compass Block Finder。

2. 选择方块

手持 Compass Block Finder 并右键点击。

这将打开方块选择菜单。

Block Menu UI

你可以浏览可用的方块，或使用搜索框。

Menu Search

点击你想要搜索的方块。

3. 开始搜索

选择方块后，手持 Compass Block Finder 并左键点击。

搜索立即开始。

Left Click Search

该模组会从距离你当前位置最近的区块开始搜索附近的区块。

4. 跟随指南针

当找到目标方块时，指南针将指向它。

该模组还会显示到已发现方块的大致距离。

Block Found

例如：

Found Melon - 42.3 blocks away

按照指南针的方向前进即可到达你的目标。

🔎 搜索系统

Compass Block Finder 会逐区块搜索世界。

搜索会从距离玩家最近的区块开始，并逐步检查更远的区块。

默认搜索半径为：

6 chunks

这形成了如下搜索区域：

13 × 13 chunks

或：

169 chunks

搜索是增量执行的，因此该模组不会尝试在单次操作中扫描整个搜索区域。

💬 搜索消息

该模组会在你使用它时提供反馈。

未选择方块

如果你在未选择方块的情况下尝试搜索：

Select a block first!

搜索已开始

Searching for Melon...

搜索进度

Searching for Melon... 15/169 chunks

找到方块

Found Melon - 42.3 blocks away

未找到任何东西

如果在搜索半径内未找到匹配的方块：

No Melon found within 6 chunks

🕹️ 控制

操作 控制方式
打开方块选择器 右键点击
开始搜索 左键点击
选择方块 在菜单中点击一个方块
搜索方块 在搜索框中输入

🧱 支持的方块

方块选择器使用 Minecraft 已注册的方块，允许你搜索各种各样的方块。

示例包括：

  • 钻石矿石
  • 深层钻石矿石
  • 铁矿石
  • 金矿石
  • 远古残骸
  • 煤矿石
  • 红石矿石
  • 绿宝石矿石
  • 青金石矿石
  • 铜矿石
  • 石头
  • 深板岩
  • 沙子
  • 沙砾
  • 木头
  • 以及更多

搜索菜单可用于快速筛选可用的方块。

📦 安装

要求

  • Minecraft 26.3
  • Fabric Loader 0.19.5 或更新版本
  • Fabric API
  • Java 25 或更新版本

安装步骤

  1. 为 Minecraft 26.3 安装 Fabric Loader。
  2. 安装 Fabric API。
  3. 下载最新的 Compass Block Finder .jar。
  4. 将 .jar 文件放入你的 Minecraft mods 文件夹中。
  5. 使用 Fabric 配置文件启动 Minecraft。
  6. 进入你的世界。
  7. 在创造模式物品栏中找到 Compass Block Finder。

你的 mods 文件夹应类似于：

.minecraft/
└── mods/
    ├── fabric-api-....jar
    └── compass-block-finder-....jar

🛠️ 开发

Compass Block Finder 使用以下内容构建：

  • Java
  • Minecraft 26.3
  • Fabric
  • Fabric Loader
  • Fabric API
  • Fabric Loom

从源代码构建

克隆仓库：

git clone <your-repository-url>

进入项目目录：

cd compass-block-finder

构建模组：

./gradlew build

在 Windows 上：

.\gradlew.bat build

编译后的模组将位于：

build/libs/

🗺️ 路线图

计划的改进可能包括：

  • 改进搜索性能
  • 更精确的最近方块检测
  • 搜索配置
  • 可配置的搜索半径
  • 额外的指南针行为
  • 更好的视觉反馈
  • 多人游戏支持改进
  • 额外的 Minecraft 版本
  • 在可行的情况下支持 Fabric 及其他平台

🤝 贡献

欢迎贡献、错误报告和建议。

如果你遇到问题，请创建一个 issue 并提供：

  • Minecraft 版本
  • Fabric Loader 版本
  • Fabric API 版本
  • Compass Block Finder 版本
  • 重现问题的步骤
  • 相关的崩溃日志或错误消息

🐛 错误报告与功能请求

发现了错误或有想法？

在项目的 GitHub 仓库中创建一个 issue 并描述发生了什么。

在报告错误时，截图和日志尤其有帮助。

📄 许可证

本项目依据此仓库中包含的许可证进行授权。

详情请参阅 LICENSE。

❤️ 致谢

由 Harfy 创建。

为 Minecraft Fabric 模组社区构建。

如果你喜欢这个模组，请考虑在 GitHub 上 ⭐ 为项目加星，并与其他玩家分享！

🧭 Compass Block Finder

选择 → 搜索 → 找到 → 跟随

祝你挖矿愉快！⛏️