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

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