modrinth.com

What is Modrinth?

Modrinth is an open-source platform for discovering, playing, and sharing Minecraft content. Its catalog covers the main categories players look for: mods, resource packs, data packs, shaders, modpacks, plugins, and server-side mods. The site describes itself as community-built and emphasizes a modern, easy-to-use interface plus an API for publishing and managing projects.

What you can actually do there

• Find content by type: Browse mods, resource packs, data packs, shaders, modpacks, plugins, and server mods in one place rather than jumping between separate sites.
• Judge projects by their descriptions: Listings shown on the page include short summaries, so you can tell at a glance whether something adds cosmetics (Lucky's Wardrobe), building tools (Architects Measuring Tape), exploration and technology (NauTec), or themed gameplay (Colosseum of Fools).
• Publish your own work: The "让你的作品走向世界" section points to creator tools for releasing projects and reaching players.
• Use the API: Developers can integrate Modrinth's catalog into launchers, servers, or their own tools.

Who it suits

A practical next step

Decide what you need first, then search by that category instead of browsing broadly. For example, if you run a Paper server, filter for plugins; if you want a visual change on a client, look at shaders or resource packs. Check the listed game version and loader (Forge, Fabric, and similar) on each project page before downloading, since a mod built for one version or loader often will not work with another. If you are evaluating a modpack, read the included project list to see whether the mix of exploration, tech, and cosmetic content matches what your group enjoys.

Related communities and hosts worth knowing: Minecraft for the base game, CurseForge as another large mod host, and GitHub where many open-source Minecraft projects are developed.

How do I install a Minecraft mod from Modrinth?

Installing a mod from Modrinth usually means downloading the correct file for your Minecraft version and loader, then dropping it into your mods folder. Modrinth itself is a discovery and download platform; the actual install happens in your game launcher and file system.

Modrinth hosts mods, resource packs, data packs, shaders, modpacks and plugins, and each project page lists the supported game versions and loaders. That is the information you need before downloading anything.

The basic steps

1. Check your setup first. Know your Minecraft version (for example, 1.20.1) and your mod loader (Fabric, Forge, NeoForge or Quilt). Vanilla Minecraft cannot load mods on its own.
2. Install a mod loader if you have not already. Most players use a launcher that supports creating modded profiles.
3. Find the mod on Modrinth and open its page. Use the version filter to match your game version and loader.
4. Download the file that matches. For most mods this is a .jar file. Do not download a version marked for a different loader or game version.
5. Open your mods folder. In the official launcher this is typically .minecraft/mods on Windows, or ~/Library/Application Support/minecraft/mods on macOS. Many launchers have a button that opens this folder for you.
6. Place the .jar file in the mods folder and start the game using the modded profile.

Matching versions matters more than anything else

A common failure is downloading a Fabric mod for a Forge profile, or a mod for 1.19 when you play 1.20. The game will either crash on startup or the mod simply will not appear.

Dependencies and modpacks

Some mods require other mods to run, such as a shared library or an API. The project page usually lists these requirements, so install them in the same folder. If you are assembling many mods, a modpack is often easier: Modrinth hosts modpacks that bundle compatible versions together, which removes most of the guesswork.

A practical example

Suppose you want to play with Create: Bionics, a mod that adds robot animals to Create. You would confirm you are on the right Minecraft version and loader, install Create and any required dependencies first, then place the Bionics .jar in your mods folder. If the game crashes, the first thing to check is whether every dependency is present and version-matched.

If something goes wrong

• Game crashes on launch: remove the newest mod and test again, or check that all dependencies are installed.
• Mod does not appear in game: confirm the loader and game version match, and that the file is in the correct mods folder.
• Works in singleplayer but not on a server: server-side mods and plugins must be installed on the server, not just your client.

As a next step, open the Modrinth page for the mod you want, note its required game version, loader and dependencies, then install those in that order before adding the mod itself.

How can I publish my own Minecraft project on Modrinth?

Publishing on Modrinth is a creator-facing workflow: you upload a project page, attach version files for specific Minecraft versions and loaders, and let players browse, download and follow it. Modrinth describes itself as an open-source platform where you can explore, play and share Minecraft content, and its project categories cover mods, resource packs, data packs, shaders, modpacks, plugins and server-side mods — so you pick the right project type before you start.

The practical path

1. Create an account and open the project creation flow from the dashboard.
2. Choose the project type (mod, plugin, data pack, resource pack, shader, modpack, etc.). This determines which metadata fields you must fill in.
3. Write the project page: a clear title, a short summary, a full description, and a license. Add a gallery image or icon, and link your source repository if it is public.
4. Add at least one version. Each version needs the file itself, the supported Minecraft versions, the loader (Fabric, Forge, NeoForge, Quilt, or none for data packs/resource packs), and release channel (release, beta, alpha).
5. Set the environment and dependency fields honestly — for example, whether a mod is client-side, server-side or both, and whether it requires another library.
6. Publish and then update by adding new versions rather than replacing old files, so existing players keep working installs.

What to get right

• Version accuracy matters more than a long description. If a file is tagged for the wrong loader or game version, players will report crashes and move on.
• Dependencies: list required libraries explicitly. A mod that silently needs a third-party API is a support burden.
• Licensing: choose a real license. If you plan to allow modpack inclusion, say so in the description.
• Gallery and summary: the first line of the summary is what appears in search and browse listings, so make it concrete ("Adds functional cosmetic clothing") rather than vague.

Where Modrinth fits

Modrinth's audience skews toward players who use modern launchers and modpack tools, and its API and open-source platform make it convenient for pack authors and tool developers to pull projects programmatically. That is a trade-off: you get a clean, modern listing and API access, but you may still want to mirror your release on other platforms if part of your audience lives there. For broader distribution, the long-standing alternative is CurseForge; for open-source code hosting and issue tracking alongside your downloads, GitHub is the common companion.

A useful next step: before uploading, write the version metadata for one release in a plain text file — game versions, loader, dependencies, license — then copy it into the form. It keeps your first upload consistent and makes later releases a matter of repeating the same checklist.

What are the differences between mods, plugins, resource packs, shaders, and modpacks on Modrinth?

Modrinth groups Minecraft content by what it changes and where it runs, not by file size. The practical split is: mods and plugins add or change game behavior, resource packs change how things look or sound, shaders change lighting and rendering, and modpacks bundle mods plus configuration into one installable package.

Quick comparison

How to choose

If you want new blocks, mobs or machines, look for a mod. If you run a server and want new commands or game modes without requiring clients to install anything, look for a plugin. If you only want different textures or sounds, a resource pack is the lightest option. If you care most about lighting and atmosphere, a shader is the targeted choice. If you would rather not assemble dozens of mods and configs yourself, a modpack saves that work but commits you to its chosen versions and balance.

A useful next step: decide first whether the change must be visible to other players on a server. Server-side behavior points to plugins or server-compatible mods; purely visual changes point to resource packs or shaders. For everything else, Modrinth lets you browse by these categories and check each project's supported loaders and game versions before downloading.

Does Modrinth have an API for developers to integrate with?

Yes. Modrinth presents itself as a platform where you can "探索、畅玩并分享" Minecraft projects, and its own description explicitly mentions publishing and exploring projects "通过我们现代化而易用的界面与 API." So an API is part of the offering, not something you have to reverse-engineer from the website.

What that means in practice

• Discovery and metadata: An API is the natural route for pulling project listings, versions, and download information into a launcher, server panel, or dashboard instead of scraping pages.
• Publishing workflows: The same description ties the API to publishing, which suggests automation for uploading or updating projects is intended, useful if you maintain many releases.
• Content types covered: The page groups 模组、资源包、数据包、光影包、整合包、插件 and 服务器 模组, so expect the API surface to span more than just mods.

A concrete scenario

Suppose you run a small modded server and want a status page that shows which mod versions are current. Rather than checking each project page by hand, you would query the API on a schedule, store the version strings, and flag mismatches against what is installed. That is exactly the kind of integration an API enables and a website alone does not.

Decision criterion

If you only need to browse and download occasionally, the web interface is enough. If you need repeatable, automated access — launchers, CI checks, server tooling, or your own front end — the API is the right layer to build on. Check the platform's developer documentation for authentication, rate limits, and endpoint coverage before committing, since those details determine how much you can automate.

For a broader view of the ecosystem, Modrinth is the platform in question, and CurseForge is a common alternative with its own developer tooling.

How can I find compatible mods for my specific Minecraft version and mod loader?

Use Modrinth's search filters rather than browsing the front page. On Modrinth, open the Browse/Discover section and set the game version (e.g. 1.20.1) and loader (Fabric, Forge, NeoForge, Quilt) before you search. Every project page lists the versions and loaders it supports, so you can confirm compatibility on the page itself instead of installing and hoping.

A practical workflow

1. Filter first: choose your exact Minecraft version and loader, then add keywords for what you want (e.g. "furniture", "redstone", "dragons").
2. Check the project page: look at the supported versions/loaders list and the last-updated date. A mod that matches your loader but not your exact version may still crash or fail to load.
3. Read the dependencies: many mods require a library or API. Install those too, and check for conflicts with mods you already run.
4. Test in a copy of your world or a fresh test profile before committing.

Version vs. loader: know which one matters

Example

If you play 1.20.1 Forge and want building aids, filter to 1.20.1 + Forge, then search "measuring". You'll find tools like Architects Measuring Tape, whose page confirms the version and loader. For a vanilla-friendly cosmetic option, Lucky's Wardrobe appears in the same filtered results; check its page for the exact supported versions before adding it.

Decision criterion

If a mod's supported version list doesn't include your version, don't force it — either pick a different mod or move your instance to a version that mod supports. For pack-level compatibility, start from a modpack that already matches your version and loader, then add mods that list the same targets.