Quilt Installer for Minecraft – Download & Install

Download Quilt Installer for Minecraft from the official page

Quilt is a mod loader for Minecraft Java Edition. If you want to play mods built for Quilt, you need it installed before anything else will work. It runs alongside your regular Minecraft installation and does not replace it.

What is Quilt and Why Do Mods Need It?

Mods cannot run inside vanilla Minecraft on their own. They need a mod loader to hook into the game and give them the tools they need to function. Quilt is one of those loaders, sitting alongside Forge, Fabric, and NeoForge as the main options for Java Edition.

Quilt started as a fork of Fabric in 2021. A group of Fabric contributors had disagreements with how that project was being run, so they split off and built Quilt with different priorities around community governance and development pace. The result is a loader that is largely compatible with Fabric mods while adding its own set of APIs called the Quilt Standard Libraries (QSL) that mod authors can build on top of.

If a mod’s download page says “requires Quilt,” you need this. If it says “Fabric,” it will usually work on Quilt too, with one small catch covered below.

Quilt vs Fabric: What Is the Difference?

The short version: Quilt can run most Fabric mods, but Fabric cannot run Quilt mods. If you are already on Fabric and want to try a Quilt-only mod, you need to switch loaders. If you start on Quilt, you get access to both ecosystems at once, which is one of the main reasons people pick it.

The one thing to know is that Fabric mods often depend on a library called Fabric API. On Quilt, you use the Quilted Fabric API (QSL) instead. It is a drop-in replacement that also includes Quilt’s own libraries. You can get it from Modrinth or CurseForge just like any other mod. Do not run both Fabric API and QSL at the same time. That will cause conflicts and almost certainly crash your game.

For a full breakdown of how these loaders compare, see the Fabric Loader page.

Supported Minecraft Versions

Quilt supports Minecraft Java Edition from 1.14 onward, though support for older versions can be patchy. Realistically, if you are playing anything from 1.18 up to the current latest release, you will find solid Quilt support and an active mod scene around it. Older versions like 1.12.2 are not covered by Quilt at all. For those, Forge is your best option.

New Minecraft releases typically get Quilt support within a few days to a couple of weeks. Snapshots are hit or miss depending on how much changes between builds, so if you play snapshots, check the Quilt Discord before assuming everything will work.

How to Install Quilt

The official installer handles everything. You can get it from quiltmc.org/en/install/. There are versions for Windows, macOS, and Linux. If you want a closer look at what the installer does before running it, check the dedicated Quilt Installer page.

1. Download the Quilt Installer. Grab it from the official download link above. On Windows you get an .exe. On macOS and Linux you get a .jar file that requires Java to run.
2. Run the installer. On Windows, double-click the .exe. If you have a .jar file, you need Java installed first. Either right-click and open with Java, or run java -jar quilt-installer.jar in a terminal.
3. Select your Minecraft version. Use the dropdown in the installer to pick the version you want to mod. Make sure you have already downloaded that version through the vanilla Minecraft Launcher at least once, or the installer may not find it.
4. Check the install location. The default path points to your .minecraft folder. Leave it as is unless you use a custom launcher with a different directory set up.
5. Click Install. The installer downloads the Quilt loader files and creates a new profile in the Minecraft Launcher. The whole thing takes about 30 seconds on a decent connection.
6. Open the Minecraft Launcher. You will see a new profile named something like “Quilt Loader [version]”. Select it from the profile dropdown in the bottom left before hitting Play.
7. Launch the game once. Quilt needs to run once before it creates the mods folder. You should see a Quilt-branded title screen on the main menu. Close out after confirming it works.
8. Add your mods. Drop your mod .jar files into the mods folder inside your .minecraft directory. Each mod goes directly into that folder, not into a subfolder. Restart the game after adding mods.

Need help finding and installing mods once Quilt is set up? The mod install guide walks through the process in detail. It uses Forge as the example, but dropping .jar files into the mods folder works exactly the same way on Quilt.

Troubleshooting

If Minecraft crashes on launch after installing mods, open the crash report. It appears automatically in a popup, or you can find it in .minecraft/crash-reports/. The top of the log almost always tells you exactly which mod caused the problem and why.

• Game will not launch at all: Java is probably missing or outdated. The Quilt Installer itself needs Java to run. On Windows, download a current Java build from Adoptium or Azul. Minecraft 1.17 and newer require Java 17 or higher.
• Mod not loading or appearing in the mod list: Check that the .jar file is in the right mods folder for the version you are running, and that the mod targets the same Minecraft version as your Quilt install. A Quilt 1.20.1 setup will not load a mod built for 1.19.4.
• Fabric mod crashing on launch: The mod probably depends on Fabric API. Add the Quilted Fabric API (QSL) to your mods folder. If you accidentally have both QSL and a separate Fabric API jar in there, remove the Fabric API one.
• Profile not showing in the launcher: Open the Minecraft Launcher, go to Installations, and look for the Quilt profile. If it is not there, re-run the installer. Sometimes the launcher needs a full restart to pick up new profiles.

If you are switching from Forge or NeoForge, keep in mind that Forge and NeoForge mods are not compatible with Quilt. You need mods specifically built for Fabric or Quilt. Optionally, you can check whether the mod you want exists for Fabric as well, since Quilt will run it.

For graphics-related performance mods on Quilt, note that OptiFine does not work with Quilt. The Fabric and Quilt ecosystems use alternatives like Sodium and Iris for performance and shader support.