How to install a Minecraft client
A plain guide for Fabric, Forge, NeoForge and standalone clients on Windows, macOS and Linux. Each client page on DonutSMP Clients also has its own exact steps.
Before you start
- You need Minecraft Java Edition and the official Minecraft Launcher.
- Open Minecraft once with the version you want to use, then close it. This creates the folders you need.
- Check which Minecraft version and mod loader the client needs. It is listed on every client card.
How to install a Fabric client
Most hacked and utility clients use Fabric.
-
Step 1: Download the client
Open the client page on this site and press its download button. Pick the file for your Minecraft version.
-
Step 2: Install Fabric for your version
The client runs on the Fabric mod loader. Get the official installer from fabricmc.net/use/installer, run it, pick your Minecraft version and press Install.
Already have Fabric for this version? Skip this step.
-
Step 3: Download the required mods
The client also needs these. Get the version that matches your Minecraft version:
-
Step 4: Open your mods folder
Windows%appdata%\.minecraft\modsPress Win + R, paste this, press Enter.macOS~/Library/Application Support/minecraft/modsIn Finder press Cmd + Shift + G and paste this.Linux~/.minecraft/modsOpen it in your file manager or terminal.If there is no
modsfolder yet, create one with exactly that name. -
Step 5: Move the files into the mods folder
Drag the
.jarfiles you downloaded into themodsfolder. Do not unzip them.Remove older versions of the client from the folder so they do not clash.
-
Step 6: Launch Minecraft with the Fabric profile
Open the Minecraft Launcher, pick the Fabric profile in the bottom-left dropdown and press Play.
Most clients open their menu with Right Shift. Check the description above if it is different.
How to install a Forge or NeoForge client
Same idea as Fabric, but with the Forge or NeoForge installer.
-
Step 1: Download the client
Open the client page on this site and press its download button. Pick the file for your Minecraft version.
-
Step 2: Install Forge for your version
The client runs on the Forge mod loader. Get the official installer from files.minecraftforge.net, run it, pick your Minecraft version and press Install.
Already have Forge for this version? Skip this step.
-
Step 3: Open your mods folder
Windows%appdata%\.minecraft\modsPress Win + R, paste this, press Enter.macOS~/Library/Application Support/minecraft/modsIn Finder press Cmd + Shift + G and paste this.Linux~/.minecraft/modsOpen it in your file manager or terminal.If there is no
modsfolder yet, create one with exactly that name. -
Step 4: Move the files into the mods folder
Drag the
.jarfile you downloaded into themodsfolder. Do not unzip it.Remove older versions of the client from the folder so they do not clash.
-
Step 5: Launch Minecraft with the Forge profile
Open the Minecraft Launcher, pick the Forge profile in the bottom-left dropdown and press Play.
Most clients open their menu with Right Shift. Check the description above if it is different.
How to install a standalone client
Some clients come with their own installer or launcher instead of a mods folder.
-
Step 1: Download the client
Open the client page on this site and press its download button. Pick the file for your Minecraft version.
-
Step 2: Run the installer
Open the file you downloaded. If it is a
.jar, double-click it (you need Java). If it is an.exe, run it like any other program. -
Step 3: Choose your version and install
Select your Minecraft version in the installer and follow its prompts.
-
Step 4: Launch it
Open the Minecraft Launcher (or the client's own launcher), choose the profile it created and press Play.
Where is the .minecraft folder?
%appdata%\.minecraft\modsPress Win + R, paste this, press Enter.~/Library/Application Support/minecraft/modsIn Finder press Cmd + Shift + G and paste this.~/.minecraft/modsOpen it in your file manager or terminal.If there is no mods folder yet, create one with exactly that name.
Troubleshooting
The game crashes on launch
The client and Minecraft versions do not match, or a required mod is missing. Check the versions on the client page, download the matching file, and add Fabric API if it is listed.
The client does not show up in game
Make sure you launched the loader profile (for example Fabric), not the normal release profile. The profile is chosen in the bottom-left of the Minecraft Launcher.
There is no Fabric or Forge profile
Run the loader installer again with the Minecraft Launcher closed, then reopen the launcher.
Two versions of the same mod
Delete older copies of the client from the mods folder. Only keep one file per mod.
The .jar opens as a zip file
Do not open or unzip mod files. Move the .jar into the mods folder as it is. For standalone .jar installers, install Java and open the file with it.
My antivirus flagged the file
Only download from the official links on the client page and check the file on VirusTotal. If you are unsure, do not run it.