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

Open the Minecraft Launcher
Click on Installations
Check if you have version 1.20.1 installed
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

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

Run Forge Installer

Terminal Method:


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

GUI Method:

Navigate to your Downloads folder
Right-click the installer file
Select Open With → OpenJDK Java 17
Select Install client
Click OK and wait for completion

Verify Forge Installation

Open Minecraft Launcher
Select forge profile
Click Play
Confirm “Forge” appears in main menu
Exit game to continue installation

Step 3B: Install Fabric (Alternative)

Download Fabric

Visit fabricmc.net/use/installer
Download Linux installer
Save to accessible location

Install Fabric

Terminal Method:


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

GUI Method:

Run the Fabric installer
Set Minecraft Version: 1.20.1
Select latest Loader Version
Keep Create profile checked
Click Install

Install Fabric API

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

Step 4: Locate .minecraft Folder

Linux Methods

Method 1: Terminal (Easiest)


cd ~/.minecraft

Method 2: File Manager

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

Method 3: Direct Path


open ~/.minecraft
# or
xdg-open ~/.minecraft

Method 4: Minecraft Launcher

Open Minecraft Launcher
Click Installations
Click the folder icon next to your installation
Navigate to the .minecraft folder

Step 5: Download Qraft

Official Download Sources

Always download from official sources:

Primary: CurseForge - Qraft
Alternative: Modrinth - Qraft
Official: qraft.ai/downloads

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:

Visit an official download source
Filter for Minecraft 1.20.1
Select your mod loader:
- qraft-forge-1.20.1-[version].jar (for Forge)
- qraft-fabric-1.20.1-[version].jar (for Fabric)
Download the file
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:

Navigate to your .minecraft folder (from Step 4)
Look for a mods folder
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:

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

For Fabric Users:

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

Step 7: Launch Qraft

First Launch

Open Minecraft Launcher
Select appropriate version:
- forge (for Forge installation)
- fabric-loader (for Fabric installation)
Click Play
Create a new world
Wait for game to load (first launch takes longer)
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:

Check the Troubleshooting Guide
Visit our Discord Server
Report bugs on GitHub
Check Linux-specific issues in our FAQ