How to Get Started with QuiltMC

QuiltMC is a Minecraft mod loader, and getting started means two different things depending on who you are: players install the loader and then add Quilt-compatible mods, while developers set up a development environment and build against Quilt's APIs. In both cases the first step is the same — confirm that Quilt supports the Minecraft version you want to play or target, because a mod loader only works with the game versions it has been built for. The official site at quiltmc.org is the entry point for downloads, documentation, and community links.

For players: install the loader and run mods

1. Check the Minecraft version you need

Decide which Minecraft version you want to play on. Mod loaders track specific game versions, and mods are usually written for one version at a time, so pick the version your favorite mods support before installing anything.

2. Get the installer

Download the Quilt installer from the official QuiltMC website. The site is the canonical source — avoid third-party mirrors, since a mod loader installer runs with your game and should come from the project itself.

3. Run the installer

The installer detects your existing Minecraft launcher installation and adds a Quilt profile to it. After it finishes, open the Minecraft launcher and select the Quilt profile from the version dropdown instead of the vanilla one. Launching that profile starts the game with Quilt loaded.

Expected result: the game launches normally, but with Quilt active. If the game starts and behaves like vanilla, you are probably still on the vanilla profile.

4. Add mods

Place Quilt-compatible mod files into your mods folder (the same mods directory convention used by other loaders). Then launch the Quilt profile again. Mods that are not compatible with Quilt, or that target a different Minecraft version, will typically cause a crash or simply not load.

Common snags

• Wrong game version. A mod built for a different Minecraft version than your Quilt profile will usually fail. Match versions first.
• Vanilla profile selected. The most common "nothing happened" cause is launching the wrong profile.
• Mod compatibility. Not every mod written for another loader works on Quilt. Check each mod's stated loader support.

For developers: set up and build against Quilt

1. Read the official documentation

QuiltMC publishes developer documentation covering its modding APIs, tooling, and project setup. Start there rather than guessing at APIs, since the documented interfaces are what you should build against.

2. Set up a development environment

Follow the documented setup for a Quilt mod project. This typically means a Gradle-based project configured with Quilt's tooling, which pulls in the loader and API dependencies and gives you a runnable development client.

3. Target the right Minecraft version

Your build configuration pins a Minecraft version. Keep it aligned with the version you intend to support, and be aware that updating it may require API changes.

4. Use the community channels

Quilt's community spaces — linked from the website — are where you ask questions, report issues, and follow updates. For a fast-moving project, these channels are often more current than any single doc page.

What the QuiltMC website offers

The site is the hub for the project. Visitors can expect to find:

• Downloads, including the installer for players.
• Documentation for developers working with Quilt's APIs and tooling.
• Community links for support, discussion, and announcements.
• Project information describing what Quilt is and how it positions itself as a mod loader.

Choosing whether Quilt is right for you

The practical rule: match your Minecraft version first, install from the official source, and verify by launching the Quilt profile before adding mods. For development, let the official documentation define your setup rather than copying configuration from unrelated loaders.