矿工指南针

矿工指南针

矿工指南针是为精明的Minecraft矿工设计的一款创新工具。凭借其独特功能，这个指南针不仅是方向指示器，更是你采矿冒险中的变革者。

冒险

矿工指南针预览查看大图

终极采矿伴侣！🧭⛏️

矿工指南针是一款革命性的工具，彻底改变你在 Minecraft 中的挖矿方式。无论你是玩原版还是安装了 100+ 模组，这款指南针都能智能检测并引导你找到最需要的矿石。

非常适合模组服务器、大型模组包以及原版玩家！

🚀 2.0 版本新特性

自动模组矿石检测

不再需要手动配置！指南针自动检测来自任何模组的矿石：

  • ✅ Create - 锌矿石
  • ✅ Mythic Metals - 全部 20+ 种矿石（Adamantite、Mythril、Orichalcum 等）
  • ✅ Immersive Engineering - 铝、铅、镍、银、铀
  • ✅ SoulsWeapons - 月石、Verglas
  • ✅ Blue Skies - Charoite、Diopside、Pyrope 等
  • ✅ 许多其他模组自动支持

智能矿石分组

智能分组系统，合并矿石变种：

  • "Iron Ore" 同时包含 iron_ore 和 deepslate_iron_ore
  • "Moonstone Ore" 合并所有月石变种
  • 正确的名称 - 不再有 "Moon Ore" 或 "Deepslate Ore"

现代 GUI 系统

  • 右键点击打开精美的矿石选择界面
  • 可视化矿石列表，带有正确的颜色和名称
  • 多选你喜欢的矿石
  • 搜索并找到你确切需要的内容

强大的配置

对矿石检测的完全控制：

  • 排除整个矿石类型（"coal", "zinc"）
  • 排除特定方块（"minecraft:coal_ore"）
  • 从任何模组添加自定义矿石
  • 针对大型模组包的性能调优

🎯 主要特性

通用模组兼容性

开箱即用，兼容任何模组包：

  • 自动检测 80+ 种常见模组矿石
  • 后备模式适用于未知模组
  • 自定义矿石支持应对边缘情况
  • 面向未来的设计，适配新模组

智能导航

  • 动态定位 - 始终指向最近的矿石
  • 多矿石追踪 - 同时搜索最多 20 种矿石类型
  • 基于区块的扫描 - 可配置的搜索半径
  • 跨维度支持 - 在下界、末地和模组维度中均可使用

高级过滤

  • 硬度过滤 - 排除装饰性方块
  • 模组排除 - 忽略有问题的模组
  • 智能分组 - 相关矿石归为一组
  • 自定义类别 - 创建你自己的矿石类型

性能优化

  • 高效扫描 - 对游戏性能影响极小
  • 可配置半径 - 在覆盖范围和性能之间取得平衡
  • 智能缓存 - 记住之前的搜索
  • 异步处理 - 不阻塞游戏运行

🎮 使用方法

快速上手

  1. 使用下方配方合成指南针
  2. 右键点击打开矿石选择 GUI
  3. 选择你想找到的矿石
  4. 点击 "Done" 并开始挖矿！

高级用法

  • Shift+右键点击矿石方块可快速添加/移除它们
  • Shift+右键点击空气可清除所有选择
  • 在 .minecraft/config/miners-compass.json5 中进行配置

合成配方

合成配方

⚙️ 完整配置指南

完整配置示例

{
  // 在玩家周围搜索多少区块 (0-100)
  // 数值越高 = 范围越大但性能影响越大
  "chunkRadius": 2,
  
  // 一次最多可选择的矿石类型数量 (0-20)
  // 在灵活性和性能之间取得平衡
  "maxBlocks": 3,
  
  // 启用模组矿石的自动检测
  // 设为 false 则仅使用自定义定义
  "enableAutoDiscovery": true,
  
  // 将矿石变种分组 (coal_ore + deepslate_coal_ore = "Coal Ore")
  // 设为 false 则分别处理每个方块
  "groupSimilarOres": true,
  
  // 矿石检测的最低方块硬度 (0.0-50.0)
  // 数值越高越能过滤掉柔软的装饰性方块
  "minimumHardness": 1.0,
  
  // 用于帮助检测遗漏矿石的额外关键词
  // 添加模组矿石名称中常用的术语
  "additionalOreKeywords": [
    "gem",
    "crystal", 
    "ingot",
    "core",
    "debris"
  ],
  
  // 从矿石检测中排除整个模组
  // 添加会导致误报的模组 ID
  "excludedMods": [
    "decorative_blocks",
    "chisel"
  ],
  
  // 添加无法自动检测的自定义矿石类型
  // 格式: "oreName:COLOR:blockId1,blockId2"
  "customOreTypes": [
    "exquisite:BLACK:arphex:exquisite_ore"
  ],
  
  // 强制将特定方块包含为矿石
  // 用于应被检测但未被检测的方块
  "forceIncludeBlocks": [],
  
  // 排除整个矿石类型（移除所有变种）
  // 隐藏你不需要的矿石类别
  "excludedOreTypes": [],
  
  // 排除特定矿石方块但保留该类型
  // 对单个方块进行精细控制
  "excludedBlocks": []
}

配置选项说明

基础设置

  • chunkRadius - 玩家周围的搜索区域（越大 = 越卡顿）
  • maxBlocks - 可同时选择的矿石类型数量
  • enableAutoDiscovery - 自动查找模组矿石 vs 仅手动
  • groupSimilarOres - 合并变种 vs 分开条目
  • minimumHardness - 过滤掉柔软的装饰性方块

检测增强

  • additionalOreKeywords - 帮助检测名称不寻常的矿石
  • customOreTypes - 添加无法自动检测的矿石
  • forceIncludeBlocks - 强制将特定方块视为矿石

排除控制

  • excludedMods - 忽略导致问题的整个模组
  • excludedOreTypes - 隐藏整个矿石类别（所有煤炭、所有锌等）
  • excludedBlocks - 隐藏特定方块但保留矿石类型

常见配置示例

性能优化

{
  "chunkRadius": 2,
  "maxBlocks": 3,
  "minimumHardness": 2.0,
  "excludedOreTypes": ["coal", "iron", "copper"]
}

仅稀有矿石

{
  "excludedOreTypes": ["coal", "iron", "copper", "zinc", "tin", "lead", "aluminum"]
}

仅原版设置

{
  "excludedMods": ["create", "mythicmetals", "immersiveengineering", "soulsweapons"]
}

无深板岩变种

{
  "excludedBlocks": [
    "minecraft:deepslate_coal_ore",
    "minecraft:deepslate_iron_ore", 
    "minecraft:deepslate_gold_ore",
    "create:deepslate_zinc_ore"
  ]
}

自定义矿石可用颜色

WHITE、YELLOW、GOLD、RED、DARK_RED、GREEN、DARK_GREEN、AQUA、DARK_AQUA、BLUE、DARK_BLUE、LIGHT_PURPLE、DARK_PURPLE、GRAY、DARK_GRAY、BLACK

🔄 从 v1.x 迁移

v1.x 用户：你的旧配置仍然可用，但建议升级：

旧配置 (v1.x)

{
  "chunkRadius": 2,
  "maxBlocks": 3
}

新配置 (v2.0)

{
  // 基础设置（兼容）
  "chunkRadius": 2,
  "maxBlocks": 3,
  
  // 新功能
  "enableAutoDiscovery": true,
  "excludedOreTypes": ["coal", "iron"],
  "customOreTypes": ["mythril:AQUA:modname:mythril_ore"]
}

迁移是自动的 - 你的旧配置继续工作，同时新功能变得可用！

Q&A

Forge/移植版？

关于 Forge 支持，Sinytra Connector、Connector Extras、Forgified Fabric API 组合已经过测试并按预期工作。

Y 轴方向？

对于那些有兴趣了解 Y 轴方向的人，我强烈推荐使用 Compass3D，由 AdamRaichu 开发。感谢他将对此功能的支持集成到模组中。