Installation Guide

Modrinth App is the easiest way to install and manage Minecraft mods. It handles everything automatically!

Download Modrinth App

1. Visit modrinth.com/app
2. Click "Download" for your operating system (Windows, Mac, or Linux)
3. Run the installer and follow the setup instructions
4. Launch the Modrinth App

An instance is like a separate Minecraft installation where you can add mods.

Create New Instance

1. Open the Modrinth App
2. Click "Create Profile" or the "+" button
3. Select Minecraft version 1.21
4. Select Fabric as the mod loader
5. Give your instance a name (e.g., "My Modded Minecraft")
6. Click "Create"

These are essential mods that most other mods require. Fabric API is a library, and Sodium dramatically improves performance.

Install Fabric API

1. In Modrinth App, select your instance
2. Click on the "Browse" or "Add Content" button
3. Search for "Fabric API"
4. Click "Install" on the Fabric API mod
5. Wait for it to download and install

Install Sodium

1. In the same Browse section, search for "Sodium"
2. Click "Install" on the Sodium mod
3. Wait for it to download and install

Now you can add any mods you want from Ensis Hub!

Method 1: Install Directly in Modrinth App (Easiest)

1. In Modrinth App, click "Browse" or "Add Content"
2. Search for any mod you found on Ensis Hub
3. Click "Install"
4. The mod is automatically added to your instance!

Method 2: Download from Ensis Hub & Upload to Modrinth

1. Browse mods on Ensis Hub
2. Click on a mod to view its details
3. Click "Download from Modrinth"
4. Save the .jar file to your computer
5. In Modrinth App, select your instance
6. Click "Add Content" → "From File"
7. Select the downloaded .jar file
8. The mod is now installed!

Launch Your Modded Minecraft

1. In Modrinth App, select your instance
2. Click the "Play" button
3. Wait for Minecraft to launch
4. On the main menu, click "Mods" (added by Mod Menu)
5. You should see all your installed mods listed!

Verify Mods Are Working

• Fabric API: Should appear in the mods list
• Sodium: You'll notice much better FPS!
• Other mods: Check the mods list to confirm they loaded

Game Crashes on Launch

• Check mod compatibility: Make sure all mods are for Minecraft 1.21 and Fabric
• Install Fabric API: Most mods require it - install it first!
• Check dependencies: Some mods require other mods to work (check mod pages)
• Remove conflicting mods: Some mods don't work together - try removing mods one by one
• Update Java: Make sure you have Java 21 or newer installed

Mods Not Loading in Modrinth App

• Check instance version: Make sure your instance is set to Minecraft 1.21
• Verify Fabric loader: Ensure Fabric is selected as the mod loader
• Reinstall the mod: Remove and reinstall the mod in Modrinth App
• Check mod page: Verify the mod supports your Minecraft version

Performance Issues

• Install Sodium: Essential for good performance (2-3x FPS boost!)
• Add Lithium: Further optimizes game logic
• Add FerriteCore: Reduces memory usage
• Allocate more RAM: In Modrinth App settings, increase RAM allocation (4-6GB recommended)
• Remove shader mods: Iris Shaders requires powerful hardware

Can't Find Modrinth App Settings

• Windows/Linux: Click the gear icon in the top right
• Mac: Click "Modrinth" in the menu bar → "Preferences"
• Per-instance settings: Right-click your instance → "Edit"

Here are the best mods to install in your Modrinth App instance:

Essential Mods (Install These First!)

• Fabric API - Required by most mods
• Sodium - 2-3x FPS boost (must-have!)
• Mod Menu - View and configure your mods

Performance Boosters

• Lithium - Optimizes game logic
• FerriteCore - Reduces memory usage
• Entity Culling - Improves FPS by hiding invisible entities
• Dynamic FPS - Reduces FPS when game is in background

Quality of Life

• Roughly Enough Items - Recipe viewer
• AppleSkin - Shows food values
• Xaero's Minimap - In-game minimap
• Jade - Shows block/entity info
• Inventory Profiles Next - Better inventory management

Graphics Enhancements (Optional)

• Iris Shaders - Shader support (works with Sodium)
• LambDynamicLights - Dynamic lighting
• Falling Leaves - Aesthetic leaf particles
• Continuity - Connected textures