Preloading Tricks - 预加载技巧

概述

Preloading Tricks 是一款仅供开发者使用的模组，它允许在模组加载器启动的极早期阶段执行高级操作。

该模组提供了早期钩子、基于 Java Instrumentation 的类转换，以及用于加载器扩展的 SPI 驱动回调。

支持的环境：

• 1.20.1 – Forge 与 Fabric
• 1.21.x – NeoForge 与 Fabric

由于它依赖于加载器版本而非 Minecraft 版本，你可以在更多版本上进行测试。

功能特性

• 早期加载器入口点 通过 PreloadingEntrypoint (基于 SPI)
• 使用 PreloadingTricksCallbacks 事件注册回调：
• SETUPLANGUAGEADAPTER – 早期语言适配器设置阶段
• COLLECTMODCANDIDATES – 在发现模组前动态添加模组候选路径
• SETUP_MODS – 修改模组列表（通过 ModManager API 进行添加/移除/查询）
• 基于 Instrumentation 的 ClassTransform

可以转换已加载的类，包括 Java 核心类和类加载器类。

• Forge 类加载器 (Forge/NeoForge)：通过 MANIFEST.MF 配置（见下文）
• Fabric：使用 AsmFabricLoader 入口点

• Forge 变体检测 (仅限 Forge 类加载器)
• 访问 ForgeVariants 以在运行时检测特定的 Forge/NeoForge 版本

ClassTransform 配置 (仅限 Forge 类加载器)

对于 Forge/NeoForge，请在你的 MANIFEST.MF 中添加以下属性：

ClassTransformConfig: xxxx.classtransform.json

配置示例 (xxxx.classtransform.json)：

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

对于 Fabric，请改用 AsmFabricLoader 入口点。

Forge 变体检测 (仅限 Forge 类加载器)

允许模组仅在特定的 Forge 类加载器变体上加载。这使得可以通过 jar-in-jar 方式，将 LexForge 和 NeoForge 的 JAR 文件打包在同一个模组文件中。

配置方法：

在 MANIFEST.MF 中指定你的模组的目标变体：

ForgeVariant: LexForge

或

ForgeVariant: NeoForge

指定了 ForgeVariant 的模组将仅在匹配的加载器变体上运行时加载，从而实现变体特定实现的安全共存。

专为需要触及 Minecraft 加载过程最早时刻的开发者打造。