Группы Classpath 1.21.11

Документация по функции групп классов Fabric Loom.

WARNING

Эта страница написана для версии 1.21.11.
Документация для старых версий может быть неполной.

Loom предоставляет DSL для настройки системного свойства групп classpath загрузчика Fabric. Это позволяет Fabric Loader группировать различные записи classpath, что полезно для модификаций, которые разделяют свой код на несколько наборов исходных кодов, таких как клиентский и общий код или общий и платформенный код. Это может быть важно для обеспечения правильной загрузки ресурсов ваших модов. Если у вас есть один мод, созданный из нескольких наборов исходных кодов, вам следует определить все наборы исходных кодов в блоке loom.mods, чтобы Fabric Loader мог правильно сгруппировать их. Эта функция применяется только при запуске игры в вашей среде разработки и не влияет на окончательный мод jar, созданный вашей сборкой (т.к. все упаковано в один jar).

loom {
    mods {
        "example-mod" {
            sourceSet sourceSets.main
            sourceSet sourceSets.client
        }
    }
}

В приведенном выше примере example-mod скомпилирован из двух наборов исходных кодов: main и client. Loom настроит Fabric Loader для группировки этих наборов источников в одной группе classpath, обеспечивая их правильную загрузку во время выполнения.

loom {
    mods {
        "example-mod" {
            sourceSet sourceSets.main
            sourceSet sourceSets.client
        }
        "example-mod-test" {
            sourceSet sourceSets.testmod
        }
    }
}

В приведенном выше примере example-mod-test скомпилирован из одного набора исходных кодов: testmod. Loom настроит Fabric Loader так, чтобы сгруппировать этот набор источников в своей собственной группе classpath, отдельно от example-mod.

Подпроекты

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

loom {
    mods {
        "example-mod" {
            sourceSet sourceSets.main
            sourceSet("main", ":core")
        }
    }
}

Если проект, от которого вы зависите, не использует Loom, вы должны применить плагин net.fabricmc.fabric-loom-companion к этому проекту. Это позволяет проекту loom получать доступ к необходимым данным в соответствии с лучшими практиками Gradle. Этот плагин предоставляет только необходимую информацию для групп classpath и не применяет никаких других функций Loom.

plugins {
    id 'net.fabricmc.fabric-loom-companion'
}

Затененные зависимости

Если вы затеняете зависимости в своем моде jar, вам также следует определить конфигурацию, содержащую затененные зависимости, в блоке loom.mods. Это гарантирует, что Fabric Loader сможет правильно сгруппировать затененные зависимости с кодом вашего мода. Не следует делать это для других зависимостей мода или зависимостей, которые вы объединяете с помощью include.

loom {
    mods {
        "example-mod" {
            sourceSet sourceSets.main
            configuration configurations.shade
        }
    }
}