Компас шахтёра — ваш идеальный спутник в подземельях! 🧭⛏️

Miner's Compass — это революционный инструмент, который кардинально меняет подход к добыче ресурсов в Minecraft. Независимо от того, играете вы в ванильную версию или используете десятки модов, этот компас умно определяет и направляет вас к самым нужным рудам.

🚀 Что нового в версии 2.0

Автоматическое определение модовых руд

Больше не нужно настраивать вручную! Компас автоматически обнаруживает руды из ЛЮБЫХ модов:

• ✅ Create — цинковая руда
• ✅ Mythic Metals — все 20+ руд (адамантит, мифрил, орихалк и другие)
• ✅ Immersive Engineering — алюминий, свинец, никель, серебро, уран
• ✅ SoulsWeapons — лунный камень, верглас
• ✅ Blue Skies — хароит, диопсид, пироп и другие
• ✅ Многие другие моды поддерживаются автоматически

Умная группировка руд

Интеллектуальная система объединения вариантов руд:

• "Железная руда" включает как iron_ore, так и deepslate_iron_ore
• "Лунный камень" объединяет все варианты лунного камня
• Правильные названия — больше никаких "Лунная руда" или "Глубинный сланец"

Современная система интерфейса

• Правый клик для открытия стильного экрана выбора руд
• Визуальный список руд с правильными цветами и названиями
• Множественный выбор ваших любимых руд
• Поиск и нахождение именно того, что вам нужно

Мощная настройка

Полный контроль над обнаружением руд:

• Исключение целых типов руд ("coal", "zinc")
• Исключение конкретных блоков ("minecraft:coal_ore")
• Добавление пользовательских руд из любых модов
• Настройка производительности для больших сборок модов

🎯 Ключевые особенности

Универсальная совместимость с модами

Работает с ЛЮБОЙ сборкой модов из коробки:

• Автоматическое обнаружение 80+ распространённых модовых руд
• Резервные шаблоны для неизвестных модов
• Поддержка пользовательских руд для особых случаев
• Будущеустойчивый дизайн для новых модов

Интеллектуальная навигация

• Динамическое наведение — всегда указывает на ближайшую руду
• Многозадачное отслеживание — поиск до 20 типов руд одновременно
• Сканирование по чанкам — настраиваемый радиус поиска
• Поддержка между измерениями — работает в Аду, Крае и модовых измерениях

Продвинутая фильтрация

• Фильтрация по твёрдости — исключает декоративные блоки
• Исключение модов — игнорировать проблемные моды
• Умная группировка — связанные руды группируются вместе
• Пользовательские категории — создавайте свои собственные типы руд

Оптимизированная производительность

• Эффективное сканирование — минимальное влияние на производительность игры
• Настраиваемый радиус — баланс между охватом и производительностью
• Умное кэширование — запоминает предыдущие поиски
• Асинхронная обработка — не блокирует игровой процесс

🎮 Как использовать

Начало работы

1. Создайте компас по рецепту ниже
2. Правый клик для открытия интерфейса выбора руд
3. Выберите руды, которые хотите найти
4. Нажмите "Готово" и начинайте копать!

Продвинутое использование

• Shift+правый клик на блоках руды для быстрого добавления/удаления
• Shift+правый клик в воздухе для очистки всех выборов
• Настройте в .minecraft/config/miners-compass.json5

Рецепт крафта

⚙️ Полное руководство по настройке

Полный пример конфигурации

{
  // Сколько чанков вокруг игрока искать (0-100)
  // Большие значения = большая площадь, но большее влияние на производительность
  "chunkRadius": 2,

  // Максимальное количество типов руд, выбираемых одновременно (0-20)
  // Баланс между гибкостью и производительностью
  "maxBlocks": 3,

  // Включить автоматическое обнаружение модовых руд
  // Установите false для использования только пользовательских определений
  "enableAutoDiscovery": true,

  // Группировать варианты руд вместе (coal_ore + deepslate_coal_ore = "Угольная руда")
  // Установите false для обработки каждого блока отдельно
  "groupSimilarOres": true,

  // Минимальная твёрдость блока для обнаружения руды (0.0-50.0)
  // Большие значения фильтруют мягкие декоративные блоки
  "minimumHardness": 1.0,

  // Дополнительные ключевые слова для помощи в обнаружении пропущенных руд
  // Добавьте термины, обычно используемые в названиях модовых руд
  "additionalOreKeywords": [
    "gem",
    "crystal",
    "ingot",
    "core",
    "debris"
  ],

  // Исключить целые моды из обнаружения руд
  // Добавьте идентификаторы модов, вызывающих ложные срабатывания
  "excludedMods": [
    "decorative_blocks",
    "chisel"
  ],

  // Добавить пользовательские типы руд, не обнаруженные автоматически
  // Формат: "oreName:COLOR:blockId1,blockId2"
  "customOreTypes": [
    "exquisite:BLACK:arphex:exquisite_ore"
  ],

  // Принудительно включить конкретные блоки как руды
  // Для блоков, которые должны быть обнаружены, но не обнаруживаются
  "forceIncludeBlocks": [],

  // Исключить целые типы руд (удаляет все варианты)
  // Скрыть категории руд, которые вам не нужны
  "excludedOreTypes": [],

  // Исключить конкретные блоки руд, сохраняя тип
  // Тонкий контроль над отдельными блоками
  "excludedBlocks": []
}

Объяснение опций конфигурации

Основные настройки

• chunkRadius — область поиска вокруг игрока (больше = больше лагов)
• maxBlocks — сколько типов руд можно выбрать одновременно
• enableAutoDiscovery — автоматически находить модовые руды или только вручную
• groupSimilarOres — объединять варианты или отдельные записи
• 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

🔄 Миграция с версии 1.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"]
}

Миграция автоматическая — ваш старый конфиг продолжает работать, пока новые функции становятся доступными!

Вопросы и ответы

Поддержка Forge/бэкпорт?

Для поддержки Forge комбинация Sinytra Connector, Connector Extras и Forgified Fabric API протестирована и работает как ожидалось.

Направление по оси Y?

Для тех, кто интересуется направлением по оси Y, я настоятельно рекомендую использовать Compass3D, разработанный AdamRaichu. Я выражаю ему свою благодарность за интеграцию поддержки этой функции в мод.