Creating a Quilt mod for unsupported versions

Written by

This guide shows you how to create a new Quilt mod for Minecraft versions not yet supported.

Download the mod template closest to your target version

First, try to use the Quilt Mod Generator as this allows you to change all the information about your mod without having to do it manually. Alternatively, you can clone/download the branch closest to your target version from the Quilt mod template repository.

Edit libs.versions.toml to match your target version

Here you can use the “Latest Quilt versions” page on quiltmc.org to get the matching version strings for your target version. You can use the Quilt Maven repository to find versions not listed previously.

Your libs.versions.toml should start with something like this in the end:

[versions]
minecraft = "1.21.1"
quilt_mappings = "1.21.1+build.9"

quilt_loom = "1.8.5"
quilt_loader = "0.29.1"

quilt_standard_libraries = "10.0.0-alpha.3+1.21.1"

My mod does not launch anymore once I removed the Quilted Fabric API

In the case you explicitly don’t want to use the Fabric APIs and purely rely on Vanilla code and the QSL, you can remove the QFAPI. QFAPI automatically includes the QSL. Once you remove it, you have to explicitly include the QSL in your build.gradle.

dependencies {
	minecraft libs.minecraft
	mappings variantOf(libs.quilt.mappings) { classifier 'intermediary-v2' }
	// Replace the above line with the block below if you want to use Mojang mappings as your primary mappings, falling back on QM for parameters and Javadocs
	/*
	mappings loom.layered {
		mappings "org.quiltmc:quilt-mappings:${libs.versions.quilt.mappings.get()}:intermediary-v2"
		officialMojangMappings()
	}
	*/
	modImplementation libs.quilt.loader
+	modImplementation libs.quilt.standard.libraries

	// QSL is not a complete API; You will need Quilted Fabric API to fill in the gaps.
	// Quilted Fabric API will automatically pull in the correct QSL version.
-	modImplementation libs.bundles.quilted.fabric.api
	// modImplementation libs.bundles.quilted.fabric.api.deprecated // If you wish to use Fabric API's deprecated modules, you can replace the above line with this one
}

Don’t forget to rebuild your Gradle project after this.