Preloading Tricks

Обзор

Preloading Tricks — это мод, предназначенный только для разработчиков, который обеспечивает расширенные операции на самой ранней стадии загрузки мода. Он предоставляет ранние перехватчики, преобразование классов на основе инструментов Java и обратные вызовы, управляемые SPI, для расширения загрузчика.

Поддерживаемые среды:

• Ткань – 1.20.1, 1.21+
• Фордж (LexForge) – 1.20.1
• NeoForge – 1.20.6, 1.21+

Вы можете протестировать больше версий, поскольку это зависит от версии загрузчика, а не от версии Minecraft.

Особенности

• Точка входа раннего загрузчика через PreloadingEntrypoint (на основе SPI)

• Регистрируйте обратные вызовы, используя события PreloadingTricksCallbacks: * SETUP_LANGUAGE_ADAPTER – этап ранней настройки языкового адаптера. * COLLECT_MOD_CANDIDATES — динамически добавлять пути кандидатов на мод перед обнаружением. * SETUP_MODS — изменить список модов (добавление/удаление/запрос через ModManager API)

• Приборное питание ClassTransform Может преобразовывать уже загруженные классы, включая ядро Java и классы загрузчика классов. Настройте через MANIFEST.MF на всех платформах (см. ниже).

• Обнаружение варианта Forge (только в версии Forge)

  • Доступ к ForgeVariants для обнаружения конкретных версий Forge/NeoForge во время выполнения.

Использование (Gradle)

Добавьте репозиторий Maven и зависимость в свою сборку:

Котлин DSL:

repositories {
    maven("https://raw.githubusercontent.com/settingdust/maven/main/repository/")
}

dependencies {
  // Recommended: use the base artifact (no classifier).
  // Gradle variant matching / cloche will resolve the correct platform artifact automatically.
  implementation("settingdust.preloading_tricks:PreloadingTricks:VERSION")

  // Optional: pin to a specific classifier when you want to avoid accidentally using APIs
  // from other platforms.
  // implementation("settingdust.preloading_tricks:PreloadingTricks:VERSION:fabric")
  // implementation("settingdust.preloading_tricks:PreloadingTricks:VERSION:forge-service")
  // implementation("settingdust.preloading_tricks:PreloadingTricks:VERSION:neoforge-modlauncher")
  // implementation("settingdust.preloading_tricks:PreloadingTricks:VERSION:neoforge-fancy-mod-loader")
}

Замените VERSION последней версией (например, 3.5.9).

Если вы используете клош, соответствующий вариант выбирается автоматически на основе атрибутов загрузчика/Minecraft.

Конфигурация преобразования классов

Для всех платформ добавьте следующий атрибут к вашему MANIFEST.MF:

ClassTransformConfig: xxxx.classtransform.json

Несколько конфигураций можно указать как значения, разделенные запятыми:

ClassTransformConfig: first.classtransform.json,second.classtransform.json

Пример конфигурации (xxxx.classtransform.json):

{
  "package": "settingdust.preloading_tricks.neoforge.transformer",
  "transformers": [
    "mod_setup_hook.FMLLoaderTransformer"
  ]
}

Обнаружение вариантов Forge (только в стиле Forge)

Позволяет моду загружаться только в определенном варианте загрузчика, подобного Forge. Это позволяет объединять JAR-файлы LexForge и NeoForge через jar-in-jar в один файл мода.

Конфигурация:

Укажите целевой вариант вашего мода в MANIFEST.MF:

ForgeVariant: LexForge

или

ForgeVariant: NeoForge

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

Для разработчиков, которым необходимо изучить самые ранние моменты процесса загрузки Minecraft.