Компас шахтера - ваш идеальный помощник в добыче руды! 🧭⛏️

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"
  ],

  // Исключить целые моды из обнаружения руд
  // Добавьте ID модов, вызывающих ложные срабатывания
  "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/Backport?

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

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

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