How to Use the Modrinth Launcher

Support / Minecraft / Mods / How to Use the Modrinth Launcher
Create a Minecraft Server today!
Start Free Trial

This guide walks you through using the Modrinth Launcher including signing into your Microsoft account, installing a modpack, creating custom instances, Importing/Exporting instances and changing common settings.

Downloading and logging in to Minecraft/Microsoft

  1. Download and install the Modrinth launcher as normal for your respective platform here.

  2. Once installed, open the launcher and you will be greeted with a home screen that looks like this.

    Modrinth app interface showing modpack recommendations, including

  3. First thing you need to sign into your Microsoft account. To do that, click on the “Select account” menu in the upper right corner. You’ll get a drop down that says you are not signed in. Click on the green box to open the login prompt and use your Microsoft login.

    Modrinth app interface showing modpack options with images. Highlighted section on the right for account selection, currently not signed in.

  4. Once the login is successful you should see your username appear in the account box. 

Installing a modpack

  1. Once the launcher is opened click on the compass icon located on the left-hand sidebar.

    Modrinth app interface showing modpacks: Fabulously Optimized, Cobblemon, Aged, and Vanilla Perfected, with mod details and images.

  2. Once on the discover page you will see a full list of all the modpacks available. By default, you will see some of the more popular modpack on Modrinth. 

  3. When you find a modpack you'd like to install, simply click on the “Install” button.

    Screenshot of the Modrinth app showing a list of modpacks with download counts and

  4. The modpack will immediately start the installation process and once completed automatically open its page where you can click “Play” to start the modpack.

    Modrinth app interface showing

How to remove an instance

  1. Click on the “Library” tab from your sidebar.

    Modrinth app interface showing modpack options with images, including a dragon and landscapes, and a sidebar with a graph icon highlighted.

  2. Locate the instance you want to delete, right click it, and select “Delete”.

    Modrinth app interface showing a dropdown menu with options: Play, View instance, Duplicate instance, Open folder, Copy path, and Delete.

How to create a custom instance

  1. Once the launcher is opened click on the plus icon located on the bottom of left-hand sidebar.

    Modrinth app interface showing modpack options like

  2. You will be given a 2nd window where you can pick an icon if you'd like, give it a name, pick your loader (Vanilla, Fabric, forge, etc.) and Minecraft version of the loader then click “create”.

    Screenshot of a software interface for creating an instance, showing options for custom settings, loader choice, and game version selection.

  3. Once created it should appear in your sidebar and give you a screen that looks like this.

    Screenshot of the Modrinth app interface showing a demo instance with no content added. Options to install content and upgrade are visible.

  4. To add mods to your new instance, click on the “install content" and you will be taken to a page where you can scroll through a list of mods or search for a specific mod that you would like to add to your instance.

    Modrinth app interface showing Minecraft mods list, including Fabric API, Sodium, and Cloth Config API, with install buttons and download counts.

  5. Once you find a mod that you'd like to add click the Install button and the mod will automatically be downloaded. 

    Additionally on the prior page you can click the triple dot menu and open the folder where you can manually install mods into the mods folder if you wish. 

How to export an instance

  1. To export an instance to share with others, open your library and select your instance that you'd like to export. 

  2. Once the instance is open, click on the triple dot menu and select “Export Modpack”.

  3. You can change the name, version number or select additional files if you'd like but it is not required, and you can simply use the default values.

How to import an instance

  1. Once the launcher is opened click on the plus icon located on the left-hand sidebar.

    Modrinth app interface showing modpack options like

  2. Select “From File” and then “Import from file”.

    Software interface showing a

  3. Browse and select the exported file that you have which should be a “.mcpack” file, then select open and the modpack will automatically import and download the needed mods. 

How to change the memory/RAM allocation

  1. Click on the Gear icon in the lower left corner.

    Screenshot of a modpack app interface showing a list of modpacks with details like name, creator, version, downloads, and install buttons.

  2. Next, click on "Default instance options”.

    Settings window showing color theme options for Modrinth App: Dark, Light, OLED, and Sync with system. Default instance options highlighted.

  3. Locate the options under the instance settings that says, “Memory allocated”. By default, it should be set to 2048 which is the same as 2GB.

    Settings window showing default instance options for a game launcher, including width, height, and memory allocation settings.

  4. Slide the slider to the new desired amount of memory you'd like to allocate to your game. Most modpacks will operate fine on 4-8GB of RAM depending on the total number of mods. Please note that if you try to allocate more memory/RAM than your computer has installed, the modpack may fail to load entirely. 

  5. Once the changes are completed all you would need to do is start the modpack. There is no save button needed to apply the new settings. 

Need Help?

If you have questions or run into any issues, our support team is here to help! Reach out using the support widget on our website or visit our support center for further assistance.