概览
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– 修改模组列表(通过ModManagerAPI 添加/移除/查询)
- 使用
-
基于 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 加载过程最早期的开发者。
Overview
Preloading Tricks is a developer-only mod that enables advanced operations during the very early stage of the mod loader. It provides early hooks, Java Instrumentation-based class transformation, and SPI-driven callbacks for loader extension.
Supported environments:
- Fabric – 1.20.1, 1.21+
- Forge (LexForge) – 1.20.1
- NeoForge – 1.20.6, 1.21+
You can test on more versions since it depends on the loader version instead of the Minecraft version.
Features
-
Early loader entrypoint via
PreloadingEntrypoint(SPI-based)- Register callbacks using
PreloadingTricksCallbacksevents:SETUP_LANGUAGE_ADAPTER– early language adapter setup stageCOLLECT_MOD_CANDIDATES– dynamically add mod candidate paths before discoverySETUP_MODS– modify mod list (add/remove/query viaModManagerAPI)
- Register callbacks using
-
Instrumentation-powered
ClassTransformCan transform already-loaded classes, including Java core and classloader classes. Configure viaMANIFEST.MFon all platforms (see below). -
Forge variant detection (Forge-like only)
- Access
ForgeVariantsto detect specific Forge/NeoForge versions at runtime
- Access
Usage (Gradle)
Add the Maven repository and dependency to your build:
Kotlin 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")
}
Replace VERSION with the latest release (e.g. 3.5.9).
If you are using cloche, the corresponding variant is selected automatically based on loader/minecraft attributes.
ClassTransform Configuration
For all platforms, add the following attribute to your MANIFEST.MF:
ClassTransformConfig: xxxx.classtransform.json
Multiple configs can be specified as comma-separated values:
ClassTransformConfig: first.classtransform.json,second.classtransform.json
Example config (xxxx.classtransform.json):
{
"package": "settingdust.preloading_tricks.neoforge.transformer",
"transformers": [
"mod_setup_hook.FMLLoaderTransformer"
]
}
Forge Variant Detection (Forge-like only)
Allows a mod to load only on a specific Forge-like loader variant. This enables bundling both LexForge and NeoForge JARs together via jar-in-jar in a single mod file.
Configuration:
Specify your mod's target variant in MANIFEST.MF:
ForgeVariant: LexForge
or
ForgeVariant: NeoForge
Mods with a ForgeVariant specified will only load when running on the matching loader variant, allowing safe coexistence of variant-specific implementations.
For developers who need to reach into the earliest moments of Minecraft’s loading process.
下载 Preloading Tricks
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Preloading Tricks
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Preloading Tricks
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Preloading Tricks
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Preloading Tricks
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Preloading Tricks
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Preloading Tricks
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Preloading Tricks
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Preloading Tricks
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Preloading Tricks
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
:bug: 错误修复
9285f5d- 转换器错误 (由 @SettingDust 提交)
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
一个用于收集生物掉落物的多区块模组。
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
查看物品与配方
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
适用于 MC 1.18+ 的 Effekseer 加载器
模组
添加区块认领和玩家组队功能,并与 Xaero's Minimap 和 World Map 集成
评论 0
登录后参与评分
还没有评论,来抢沙发吧