> ## Documentation Index
> Fetch the complete documentation index at: https://optimism.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# How To Install Mods

> A simple tutorial on how to install Mods

## Before you start

### Choose the Correct Version

Make sure that the mods you are installing match the version of Minecraft you're playing. For example, Mods for 1.16 won't work with 1.21.

## Installing Mods with Fabric

<Steps>
  <Step title="Download Minecraft">
    Make sure you have Minecraft Java Edition installed.
  </Step>

  <Step title="Download Fabric">
    * Visit the [Fabric](https://fabricmc.net/) website and download the installer.
    * Run the installer, choose the Minecraft version you want to use, and click "Install."
  </Step>

  <Step title="Installing Fabric API">
    Most mods that are made with Fabric needs Fabric API to work.

    * Download [Fabric API](https://www.curseforge.com/minecraft/mc-mods/fabric-api/files) and choose the one that matches the version you chose earlier.
    * Place the downloaded .jar file into your mods folder:
      * For Windows: Press Win + R, type %appdata%/.minecraft, and navigate to the mods folder. If it doesn't exist, create one.
      * For Mac: Open Finder, press Command + Shift + G, and enter \~/Library/Application Support/minecraft, then find or create the mods folder.
  </Step>

  <Step title="Download and Install Mods">
    * Visit CurseForge or go to the [mods](mods) section or another mod website.
    * Download mods that are compatible with Fabric and your Minecraft version.
    * Place the mod .jar files in the same mods folder as the Fabric API.
  </Step>

  <Step title="Launch Minecraft">
    * Open the Minecraft launcher.
    * In the Version dropdown, select the Fabric Loader version.
    * Click Play. Your mods should now be active!
  </Step>
</Steps>

## Installing Mods With Forge

<Steps>
  <Step title="Download Minecraft">
    Make sure you have Minecraft Java Edition installed.
  </Step>

  <Step title="Download Forge">
    * Visit the [Forge](https://files.minecraftforge.net/net/minecraftforge/forge/) website and download the installer.
    * Run the installer, choose the Minecraft version you want to use, and click "Install."
  </Step>

  <Step title="Downloading Mods For Forge">
    * Visit CurseForge or go to the [mods](mods) section or another mod website.
    * Place the downloaded .jar file into your mods folder:
      * For Windows: Press Win + R, type %appdata%/.minecraft, and navigate to the mods folder. If it doesn't exist, create one.
      * For Mac: Open Finder, press Command + Shift + G, and enter \~/Library/Application Support/minecraft, then find or create the mods folder.
  </Step>

  <Step title="Launch Minecraft">
    * Open the Minecraft launcher.
    * In the Version dropdown, select the Fabric Loader version.
    * Click Play. Your mods should now be active!
  </Step>
</Steps>