Skip to Content
MinecraftInstallation GuideLinux Installation Guide

Linux Installation Guide

Prerequisites

Before installing Qraft on Linux, ensure you have:

  • ✅ Minecraft Java Edition installed
  • ✅ Java 17 or higher
  • ✅ Terminal access
  • ✅ 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)

Ubuntu/Debian:

sudo apt update
sudo apt install openjdk-17-jdk

Fedora/RHEL:

sudo dnf install java-17-openjdk-devel

Arch Linux:

sudo pacman -S jdk-openjdk

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. Right-click the installer file
  3. Select Open With → OpenJDK Java 17
  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 Linux 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

🐧 Linux Methods

Method 1: Terminal (Easiest)

cd ~/.minecraft

Method 2: File Manager

  1. Open file manager (Nautilus, Dolphin, Thunar, etc.)
  2. Press Ctrl + H to show hidden files
  3. Navigate to your home directory
  4. Enter .minecraft folder

Method 3: Direct Path

open ~/.minecraft
# or
xdg-open ~/.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 wget
wget https://www.curseforge.com/minecraft/mc-mods/qraft/download/[file-id] -O qraft-forge-1.20.1-[version].jar
 
# 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 ~/.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 ~/.minecraft/mods/
 
# For Fabric (both files needed)
cp ~/Downloads/fabric-api-[version]+1.20.1.jar ~/.minecraft/mods/
cp ~/Downloads/qraft-fabric-1.20.1-[version].jar ~/.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 Linux Issues

Issue: “Java not found”

# Check Java version
java -version
 
# If not installed, install Java 17+
sudo apt install openjdk-17-jdk  # Ubuntu/Debian
sudo dnf install java-17-openjdk-devel  # Fedora

Issue: “Permission denied” when accessing .minecraft

# Fix permissions
chmod -R 755 ~/.minecraft

Issue: Game crashes on launch

  • Solution: Check that you downloaded the correct mod version for your loader
  • Check logs: ~/.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 ~/.minecraft/mods/

Issue: Launcher won’t start

# Try running with specific Java version
/usr/lib/jvm/java-17-openjdk/bin/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 Linux-specific issues in our FAQ 
Last updated on
DownloadmacOS Installation Guide