Windows Installation Guide

Prerequisites

Before installing Qraft on Windows, ensure you have:

• ✅ Minecraft Java Edition installed
• ✅ Administrator privileges on your computer
• ✅ 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

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

1. Double-click the downloaded installer
2. Select Install client
3. Verify install path points to .minecraft
4. Click OK and wait for completion
5. Click OK when installation succeeds

✅ 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 Windows installer
3. Save to accessible location

🔧 Install Fabric

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

🪟 Windows Methods

Method 1: Run Dialog (Easiest)

1. Press Win + R
2. Type: %APPDATA%\.minecraft
3. Press Enter

Method 2: File Explorer

1. Open File Explorer
2. Navigate to: C:\Users\[YourUsername]\AppData\Roaming\.minecraft
3. If you don’t see AppData folder, enable “Show hidden files”:
   • Click View tab
   • Check Hidden items

Method 3: 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:

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

📥 Download Process

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

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

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 Windows Issues

Issue: “Java not found”

• Solution: Install Java 17 or higher from Oracle  or OpenJDK 

Issue: “Access denied” when accessing .minecraft

• Solution: Run File Explorer as Administrator

Issue: Game crashes on launch

• Solution: Check that you downloaded the correct mod version for your loader

Issue: Mod not loading

• Solution: Ensure the .jar file is in the mods folder, not extracted

Need Help?

If you encounter issues:

1. Check the Troubleshooting Guide
2. Visit our Discord Server 
3. Report bugs on GitHub