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