Preloading Tricks

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 PreloadingTricksCallbacks events:
  - SETUP_LANGUAGE_ADAPTER – early language adapter setup stage
  - COLLECT_MOD_CANDIDATES – dynamically add mod candidate paths before discovery
  - SETUP_MODS – modify mod list (add/remove/query via ModManager API)
Instrumentation-powered ClassTransform Can transform already-loaded classes, including Java core and classloader classes. Configure via MANIFEST.MF on all platforms (see below).
Forge variant detection (Forge-like only)
- Access ForgeVariants to detect specific Forge/NeoForge versions at runtime

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

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.

No gallery available for this project.

Version	Minecraft	Loader	Download
3.7.3	1.20.1, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2	fabric, forge, neoforge	Download
3.7.2	1.20.1, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2	fabric, forge, neoforge	Download
3.7.1	1.20.1, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2	fabric, forge, neoforge	Download
3.7.0	1.20.1, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2	fabric, forge, neoforge	Download
3.6.3	1.20.1, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2	fabric, forge, neoforge	Download
3.6.2	1.20.1, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2	fabric, forge, neoforge	Download
3.6.0	1.20.1, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2	fabric, forge, neoforge	Download
3.5.15	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2	fabric, forge, neoforge	Download
3.5.14	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2	fabric, forge, neoforge	Download
3.5.13	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2	fabric, forge, neoforge	Download
3.5.10	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2	fabric, forge, neoforge	Download
3.5.9	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2	fabric, forge, neoforge	Download
3.5.8	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11	fabric, forge, neoforge	Download
3.5.7	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11	fabric, forge, neoforge	Download
3.5.6	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11	fabric, forge, neoforge	Download
3.5.5	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11	fabric, forge, neoforge	Download
3.5.3	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11	fabric, forge, neoforge	Download
3.5.2	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11	fabric, forge, neoforge	Download
3.5.1	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11	fabric, forge, neoforge	Download
3.5.0	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11	fabric, forge, neoforge	Download
3.4.6	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11	fabric, forge, neoforge	Download
3.4.5	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11	fabric, forge, neoforge	Download
3.4.4	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11	fabric, forge, neoforge	Download
3.4.3	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11	fabric, forge, neoforge	Download
3.4.2	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11	fabric, forge, neoforge	Download
3.4.1	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11	fabric, forge, neoforge	Download
3.4.0	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11	fabric, forge, neoforge	Download
3.3.5	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11	fabric, forge, neoforge	Download
3.3.3	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11	fabric, forge, neoforge	Download
3.3.2	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11	fabric, forge, neoforge	Download
3.3.1	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10	fabric, forge, neoforge	Download
3.3.0	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10	fabric, forge, neoforge	Download
3.2.3	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10	fabric, forge, neoforge	Download
3.2.2	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10	fabric, forge, neoforge	Download
3.2.1	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10	fabric, forge, neoforge	Download
3.2.0	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10	fabric, forge, neoforge	Download
3.1.2	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10	fabric, forge, neoforge	Download
3.1.1	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10	fabric, forge, neoforge	Download
3.1.0	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10	fabric, forge, neoforge	Download
3.0.0	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10	fabric, forge, neoforge	Download
2.7.5	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10	fabric, forge, neoforge	Download
2.7.4	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10	fabric, forge, neoforge	Download
2.7.3	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10	fabric, forge, neoforge	Download
2.7.2	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10	fabric, forge, neoforge	Download
2.7.1	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10	fabric, forge, neoforge	Download
2.7.0	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10	fabric, forge, neoforge	Download
2.6.1	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10	fabric, forge, neoforge	Download
2.6.0	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10	fabric, forge, neoforge	Download
2.5.10	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10	fabric, forge, neoforge	Download
2.5.9	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10	fabric, forge, neoforge	Download
2.5.7	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10	fabric, forge, neoforge	Download
2.5.6	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10	fabric, forge, neoforge	Download
2.5.5	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10	fabric, forge, neoforge	Download
2.5.4	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10	fabric, forge, neoforge	Download
2.5.3	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10	fabric, forge, neoforge	Download
2.5.2	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10	fabric, forge, neoforge	Download
2.5.1	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10	fabric, forge, neoforge	Download
2.5.0	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10	fabric, forge, neoforge	Download
2.4.1	1.20.1, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10	fabric, forge, neoforge	Download
2.4.0	1.20.1, 1.21, 1.21.1	fabric, forge, neoforge	Download
2.3.0	1.20.1, 1.21, 1.21.1	fabric, forge, neoforge	Download
2.2.2	1.20.1, 1.21, 1.21.1	fabric, forge, neoforge	Download
2.2.1	1.20.1, 1.21, 1.21.1	fabric, forge, neoforge	Download
2.2.0	1.20.1, 1.21, 1.21.1	fabric, forge, neoforge	Download
2.1.0	1.20.1, 1.21, 1.21.1	fabric, forge, neoforge	Download
2.0.1	1.20.1, 1.21, 1.21.1	fabric, forge, neoforge	Download
2.0.0	1.20.1, 1.21, 1.21.1	fabric, neoforge	Download
1.2.3	1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21	fabric, forge, neoforge	Download
1.2.2	1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21	fabric, forge, neoforge	Download
1.2.1	1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21	fabric, forge, neoforge	Download
1.2.0	1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21	fabric, forge, neoforge	Download
1.1.0	1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21	fabric, neoforge	Download
1.0.6	1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2	fabric, forge, quilt	Download
1.0.5	1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2	fabric, forge, quilt	Download
1.0.4	1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2	fabric, forge, quilt	Download
1.0.3	1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2	fabric, forge, quilt	Download
1.0.2	1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2	fabric, forge, quilt	Download
1.0.1	1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2	fabric, forge, quilt	Download
1.0.0	1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2	fabric, forge, quilt	Download
0.0.14	1.16.5, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1	fabric, forge, quilt	Download
0.0.13	1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1	fabric, forge, quilt	Download
0.0.12	1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1	fabric, forge, quilt	Download
0.0.11	1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1	fabric, forge, quilt	Download
0.0.10	1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1	fabric, forge, quilt	Download
0.0.5	1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1	fabric, forge, quilt	Download
0.0.4	1.19, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1	fabric, forge, quilt	Download
0.0.3	1.19, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1	fabric, forge, quilt	Download
0.0.1	1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1	fabric, forge, quilt	Download