Excavated Variants

Версия для NeoForge требует: Dynamic Asset Generator

Версия для Fabric/Quilt требует: Dynamic Asset Generator и Fabric API/Quilted Fabric API

Этот мод автоматически создаёт различные варианты руд, соответствующие разным типам камня в игре. Если вы используете моды, добавляющие новые виды камня или руд, Excavated Variants сгенерирует для каждой комбинации руды и типа камня соответствующие варианты блоков.

Основные возможности

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

Решение проблем

Если вы столкнулись с трудностями:

• При медленной загрузке мира или игры попробуйте включить более сильное кэширование ресурсов и данных в настройках Dynamic Asset Generator
• Если игра вылетает при запуске или текстуры руд становятся розово-черными, возможно, проблема в конфигурации — попробуйте удалить и сбросить настройки
• Если отсутствует совместимость с перечисленными ниже модами, удалите конфигурационные файлы для возврата к стандартным настройкам

Совместимость

Стандартная конфигурация включает варианты руд для следующих модов (помимо ванильных камней и руд):

• Quark
• Create
• Oh The Biomes You'll Go
• Tech Reborn
• Immersive Engineering
• Blockus
• Better End
• Better Nether
• Promenade
• Twigs
• Unearthed
• Bewitchment
• Mekanism
• Mystical Agriculture
• И многие другие!

Формат конфигурации

Основной файл настроек config/excavated_variants.json содержит несколько опций:

• attempt_worldgen_replacement: Включает/выключает изменения генерации руд; без этой опции руды не будут заменяться при создании мира
• add_conversion_recipes: Определяет, добавлять ли рецепты для преобразования вариантов обратно в базовую руду

Остальная конфигурация загружается через папку globalresources. Вы можете добавлять новые файлы настроек напрямую, но если хотите извлечь встроенные настройки для редактирования, откройте файл defaultresources.json. Он должен выглядеть примерно так:

{
  "extract": {
    "excavated_variants": "unextracted"
  }
}

Измените unextracted на extract и запустите игру один раз. Теперь стандартные настройки будут доступны для редактирования в папке globalresources.

Важно: Если вы просто хотите добавить больше настроек, вам не нужно (и не следует) делать это. Вы можете добавлять новые файлы конфигурации без извлечения существующих.

Типы данных в конфигурации

Настройки определяют четыре основных типа данных:

• Типы грунта (Ground Types): Представляют классы руд и камней. Используются для определения того, какие новые комбинации руд/камней (варианты) должны быть созданы. Например: excavated_variants:overworld — это категория, общая для обычного камня Minecraft, глубосланца и руд верхнего мира

• Руды (Ores): Типы блоков, которые могут существовать в любом количестве различных камней. При генерации мира они заменяются вариантами, соответствующими соседним камням. Например: excavated_variants:minecraft/iron_ore представляет как обычную, так и глубосланцевую железную руду, а также любые другие сгенерированные варианты

• Камни (Stones): Блоки, внутри которых генерируются руды. Например: excavated_variants:minecraft/granite представляет гранит и содержит информацию о том, какие новые варианты генерировать на основе гранита

• Модификаторы (Modifiers): Используются для изменения свойств вариантов. Могут добавлять теги, изменять свойства блоков, предотвращать создание вариантов и многое другое

За исключением случаев изменения модификаторами, варианты генерируются для всех комбинаций руд/камней, которые имеют общий тип грунта и ещё не имеют варианта.

Типы грунта

Размещаются в globalresources/[папка/пак]/globaldata/[пространство_имён]/excavated_variants/ground_type. Это JSON-файлы со следующей структурой:

• (ничего): пока не содержат данных! Просто используйте пустой JSON-файл: {}

Руды

Размещаются в globalresources/[папка/пак]/globaldata/[пространство_имён]/excavated_variants/ore. Это JSON-файлы со следующей структурой:

• types: список типов грунта, в которых может генерироваться эта руда. Например: ["excavated_variants:overworld"]
• translations: объект с локалями в качестве ключей (такими как en_us) и переведёнными названиями руды в качестве значений. Переводы будут дополнены названием камня, если только перевод не содержит %s, в этом случае название камня будет вставлено в это место
• tags: список тегов, к которым будут добавлены варианты этой руды, как теги блоков и предметов
• blocks: карта, представляющая сопоставления вариантов этой руды с камнями. Каждый ключ — идентификатор блока, представляющего вариант руды. Значения принимают одну из двух форм:
  • строка, представляющая идентификатор камня. Например: "excavated_variants:minecraft/granite". Предполагается, что этот вариант существует, если присутствует мод, чей ID пространства имён соответствует ID блока
  • объект со следующими полями:
    • stone: строка, представляющая идентификатор камня. Например: "excavated_variants:minecraft/granite"
    • required_mods: список ID модов, которые должны присутствовать для генерации этого варианта. Например: ["spelunkery", "create"]
    • generating: (опционально, по умолчанию true) может ли этот вариант использоваться как родитель для новых, сгенерированных вариантов

Камни

Размещаются в globalresources/[папка/пак]/globaldata/[пространство_имён]/excavated_variants/stone. Это JSON-файлы со следующей структурой:

• types: список типов грунта, в которых может генерироваться этот камень. Например: ["excavated_variants:overworld"]
• translations: объект с локалями в качестве ключей (такими как en_us) и переведёнными названиями камня в качестве значений
• block: идентификатор блока, соответствующего этому камню. Например: "minecraft:granite"
• ore_tags: список тегов, к которым будут добавлены варианты руд для этого камня, как теги блоков и предметов

Модификаторы

Размещаются в globalresources/[папка/пак]/globaldata/[пространство_имён]/excavated_variants/modifier. Это JSON-файлы со следующей структурой:

• tags: (опционально) список тегов, которые будут добавлены к вариантам, соответствующим фильтру. Могут быть тегами блоков или предметов в формате "пространство_имён:[блоки/предметы]/путь"
• flags: (опционально) список флагов из следующего набора, которые будут применены к соответствующим вариантам:
  • "original_without_silk": вариант должен выпадать так же, как его исходный блок, если не используется шёлковое касание. Этот флаг не имеет значения для блоков руд, которые выпадают как "сырые куски руды" или подобное, и актуален только когда исходный блок выпадает сам
  • "original_always": вариант должен всегда выпадать так же, как его исходный блок, даже при использовании шёлкового касания
  • "disable": вариант не должен генерироваться или распознаваться модом
  • "non_generating": вариант не должен использоваться как родитель для новых вариантов, но мод всё равно знает о нём
• properties: (опционально) объект со следующими полями, который изменяет свойства сгенерированных блоков:
  • destroy_time: время, необходимое для разрушения блока
  • explosion_resistance: сопротивление блока взрывам
  • xp: количество опыта, выпадающего из блока. Может принимать тот же тип целочисленного диапазона, что и в ванильных датапаках
• filter: описывает, к каким вариантам применяется этот модификатор

Фильтры

Фильтры модификаторов могут принимать форму либо строки, либо объекта. Как объект, они имеют по крайней мере одно поле type, которое описывает тип фильтра. Доступные типы:

• all соответствует всему
• empty не соответствует ничему
• not соответствует всему, что не соответствует его полю "filter"
• and соответствует всему, что соответствует всем членам его поля "filters"
• or соответствует всему, что соответствует хотя бы одному члену его поля "filters"

Как строка, они принимают одну из следующих форм:

• : соответствует всему
• ~: не соответствует ничему
• ~[фильтр]: соответствует всему, что не соответствует [фильтру]
• ground_type@[пространство_имён]:[путь]: соответствует всем вариантам с данным типом грунта
• stone@[пространство_имён]:[путь]: соответствует всем вариантам с данным камнем
• ore@[пространство_имён]:[путь]: соответствует всем вариантам с данной рудой
• mod@[ID_мода]: соответствует всему, но только если присутствует мод с данным ID
• generated: соответствует всем вариантам, которые сгенерированы модом
• block@[пространство_имён]:[путь]: соответствует всем вариантам с данным ID блока. Указанные пространство имён и путь могут использовать как подстановочный знак для соответствия одному или нескольким символам