Preloading Tricks

模组

· 作者 settingdust

用于早期加载器访问、类转换和预加载黑客的开发者工具。

0 本站下载 0 关注 更新于 4 个月前

需要前置:Fabric API

最新 3.7.3 · 26.1.2 · Fabric / Forge

一键开服(送7天)

概览

Preloading Tricks 是一款仅限开发者使用的模组,可在加载器启动的极早期阶段启用高级操作。 它提供了早期钩子、基于 Java Instrumentation 的类转换以及由 SPI 驱动的回调以支持加载器扩展。

支持的环境:

  • Fabric – 1.20.1, 1.21+
  • Forge (LexForge) – 1.20.1
  • NeoForge – 1.20.6, 1.21+

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


功能

  • 通过 PreloadingEntrypoint (基于 SPI) 实现的早期加载器入口点

    • 使用 PreloadingTricksCallbacks 事件注册回调:
      • SETUP_LANGUAGE_ADAPTER – 早期语言适配器设置阶段
      • COLLECT_MOD_CANDIDATES – 在发现之前动态添加模组候选路径
      • SETUP_MODS – 修改模组列表(通过 ModManager API 添加/移除/查询)
  • 基于 Instrumentation 的 ClassTransform 可以转换已加载的类,包括 Java 核心类和类加载器类。 在所有平台上通过 MANIFEST.MF 进行配置(见下文)。

  • Forge 变体检测 (仅限类似 Forge 的环境)

    • 访问 ForgeVariants 以在运行时检测特定的 Forge/NeoForge 版本

用法 (Gradle)

将 Maven 仓库和依赖项添加到你的构建文件中:

Kotlin DSL:

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

dependencies {
  // 推荐:使用基础工件(无 classifier)。
  // Gradle 变体匹配 / cloche 将自动解析正确的平台工件。
  implementation("settingdust.preloading_tricks:PreloadingTricks:VERSION")

  // 可选:当希望避免意外使用其他平台的 API 时,固定特定的 classifier。
  // 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)。

如果你正在使用 cloche,将根据加载器/Minecraft 属性自动选择相应的变体。


ClassTransform 配置

对于所有平台,请在你的 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-in-jar 技术在单个模组文件中同时捆绑 LexForge 和 NeoForge JAR。

配置:

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

ForgeVariant: LexForge

或

ForgeVariant: NeoForge

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


适用于需要深入 Minecraft 加载过程最早期的开发者。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源