Skip to Content
MinecraftInstallation GuidemacOS Installation Guide

macOS Installation Guide

Prerequisites

Before installing Qraft on macOS, ensure you have:

  • ✅ Minecraft Java Edition installed
  • ✅ macOS 10.14 or later
  • ✅ Administrator privileges
  • ✅ Stable internet connection

Mod Loader Options

🔥 Forge (Recommended for Qraft)

Advantages:

  • ✅ Maximum Qraft compatibility
  • ✅ Extensive mod ecosystem
  • ✅ Stable performance
  • ✅ Better modpack integration

🧵 Fabric (Performance Option)

Advantages:

  • ✅ Faster startup times
  • ✅ Lower resource usage
  • ✅ Quick updates
  • ✅ Modern architecture

💡 Recommendation: Choose Forge for the most stable Qraft experience.

Step 1: Install Minecraft 1.20.1

🎮 Verify or Install Minecraft

  1. Open the Minecraft Launcher
  2. Click on Installations
  3. Check if you have version 1.20.1 installed
  4. If not available:
    • Click New Installation
    • Name: “Qraft 1.20.1”
    • Version: Release 1.20.1
    • Click Create

☕ Install Java (if needed)

Method 1: Homebrew (Recommended)

# Install Homebrew if not already installed
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
 
# Install Java 17
brew install openjdk@17
 
# Link Java
sudo ln -sfn /opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk-17.jdk

Method 2: Direct Download

  1. Visit Adoptium 
  2. Download macOS version of Java 17
  3. Install the .pkg file

Step 2: Choose Your Mod Loader

🔥 Forge (Recommended for Qraft)

Advantages:

  • ✅ Maximum Qraft compatibility
  • ✅ Extensive mod ecosystem
  • ✅ Stable performance
  • ✅ Better modpack integration

🧵 Fabric (Performance Option)

Advantages:

  • ✅ Faster startup times
  • ✅ Lower resource usage
  • ✅ Quick updates
  • ✅ Modern architecture

💡 Recommendation: Choose Forge for the most stable Qraft experience.

Step 3A: Install Forge

📥 Download Forge

  1. Visit files.minecraftforge.net 
  2. Select version 1.20.1
  3. Click Installer under “Download Recommended”
  4. Wait 5 seconds, then click Skip
  5. Download the installer file

🔧 Run Forge Installer

Terminal Method:

cd ~/Downloads
java -jar forge-1.20.1-*-installer.jar --installClient

GUI Method:

  1. Navigate to your Downloads folder
  2. Double-click the installer file
  3. If you get a security warning:
    • Go to System Preferences → Security & Privacy
    • Click Open Anyway
  4. Select Install client
  5. Click OK and wait for completion

✅ Verify Forge Installation

  1. Open Minecraft Launcher
  2. Select forge profile
  3. Click Play
  4. Confirm “Forge” appears in main menu
  5. Exit game to continue installation

Step 3B: Install Fabric (Alternative)

📥 Download Fabric

  1. Visit fabricmc.net/use/installer 
  2. Download macOS installer
  3. Save to accessible location

🔧 Install Fabric

Terminal Method:

cd ~/Downloads
java -jar fabric-installer-*.jar client

GUI Method:

  1. Run the Fabric installer
  2. Set Minecraft Version: 1.20.1
  3. Select latest Loader Version
  4. Keep Create profile checked
  5. Click Install

📦 Install Fabric API

  1. Download Fabric API from CurseForge 
  2. Choose version for Minecraft 1.20.1
  3. Save the .jar file for later

Step 4: Locate .minecraft Folder

🍎 macOS Methods

Method 1: Go to Folder (Easiest)

  1. Open Finder
  2. Press Cmd + Shift + G
  3. Type: ~/Library/Application Support/minecraft
  4. Press Enter

Method 2: Terminal

cd ~/Library/Application\ Support/minecraft

Method 3: Show Library Folder

  1. Open Finder
  2. Press Cmd + Shift + H (go to Home)
  3. Press Cmd + Shift + . (show hidden files)
  4. Navigate to Library → Application Support → minecraft

Method 4: Minecraft Launcher

  1. Open Minecraft Launcher
  2. Click Installations
  3. Click the folder icon next to your installation
  4. Navigate to the .minecraft folder

Step 5: Download Qraft

🔍 Official Download Sources

Always download from official sources:

📥 Download Process

Terminal Method:

# Using curl
curl -L -o qraft-forge-1.20.1-[version].jar https://www.curseforge.com/minecraft/mc-mods/qraft/download/[file-id]

GUI Method:

  1. Visit an official download source
  2. Filter for Minecraft 1.20.1
  3. Select your mod loader:
    • qraft-forge-1.20.1-[version].jar (for Forge)
    • qraft-fabric-1.20.1-[version].jar (for Fabric)
  4. Download the file
  5. Verify file integrity (check file size and name)

🔐 Security Check

Before proceeding, verify:

  • ✅ File extension is .jar
  • ✅ Filename contains “qraft” and “1.20.1”
  • ✅ Downloaded from official sources only
  • ✅ File size is appropriate (typically 5-15MB)

Step 6: Install Qraft

📂 Prepare Mods Folder

Terminal Method:

cd ~/Library/Application\ Support/minecraft
mkdir -p mods

GUI Method:

  1. Navigate to your .minecraft folder (from Step 4)
  2. Look for a mods folder
  3. If it doesn’t exist, create it:
    • Right-click in .minecraft folder
    • Select New Folder
    • Name it mods

📋 Install Mod Files

Terminal Method:

# For Forge
cp ~/Downloads/qraft-forge-1.20.1-[version].jar ~/Library/Application\ Support/minecraft/mods/
 
# For Fabric (both files needed)
cp ~/Downloads/fabric-api-[version]+1.20.1.jar ~/Library/Application\ Support/minecraft/mods/
cp ~/Downloads/qraft-fabric-1.20.1-[version].jar ~/Library/Application\ Support/minecraft/mods/

GUI Method:

For Forge Users:

  1. Copy qraft-forge-1.20.1-[version].jar
  2. Paste into the mods folder
  3. Do not extract the jar file

For Fabric Users:

  1. Copy both files to mods folder:
    • fabric-api-[version]+1.20.1.jar
    • qraft-fabric-1.20.1-[version].jar
  2. Do not extract either file

Step 7: Launch Qraft

🚀 First Launch

  1. Open Minecraft Launcher
  2. Select appropriate version:
    • forge (for Forge installation)
    • fabric-loader (for Fabric installation)
  3. Click Play
  4. Create a new world
  5. Wait for game to load (first launch takes longer)
  6. Once inside the new save run /login to connect to Qraft’s servers

🎯 Success Indicators

You’ll know Qraft is working when:

  • ✅ Game launches without errors
  • ✅ Qraft mod appears in mod list (F3 + H)
  • ✅ /login command works in-game
  • ✅ You can access Qraft features

Troubleshooting

Common macOS Issues

Issue: “Java not found”

# Check Java version
java -version
 
# If using Homebrew
brew install openjdk@17
sudo ln -sfn /opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk-17.jdk

Issue: “App can’t be opened because it is from an unidentified developer”

  1. Go to System Preferences → Security & Privacy
  2. Click Open Anyway under “General” tab
  3. Or right-click the file and select Open

Issue: “Permission denied” when accessing Library folder

# Make Library folder visible
chflags nohidden ~/Library

Issue: Game crashes on launch

  • Solution: Check that you downloaded the correct mod version for your loader
  • Check logs: ~/Library/Application Support/minecraft/logs/latest.log

Issue: Mod not loading

  • Solution: Ensure the .jar file is in the mods folder, not extracted
  • Verify file permissions: ls -la ~/Library/Application\ Support/minecraft/mods/

Issue: Launcher won’t start on Apple Silicon Macs

# Run with Rosetta if needed
arch -x86_64 java -jar minecraft-launcher.jar

Need Help?

If you encounter issues:

  1. Check the Troubleshooting Guide
  2. Visit our Discord Server 
  3. Report bugs on GitHub 
  4. Check macOS-specific issues in our FAQ 
Last updated on
Linux Installation GuideWindows Installation Guide