Plugins and mods
How to join a modded Minecraft server
This page is for the people joining a modded server, so you can send it straight to your friends. A modded server only lets in players who have exactly the same mods, because both sides need to know every block and item in the world.
In short
To join a modded Minecraft server, ask the owner for the name of the modpack and its exact version, install that version in a launcher such as Prism Launcher, the Modrinth App, the CurseForge app or the FTB app, start it once and add the server address under Multiplayer. Give the game 4 to 8 GB of memory, depending on the size of the pack. A mismatched mod list means your pack version differs from the server's.
What you need from the Minecraft server owner
- The name of the modpack and its exact version, or the list of mods if it is not a pack.
- The server address.
- Whether you need to be added to the whitelist.
Joining a Minecraft modpack server
Use the launcher that hosts the pack. The CurseForge app and the FTB app cover most packs; Prism Launcher and the Modrinth App can install packs from CurseForge and Modrinth too.
- Install the launcher and sign in with your Microsoft account.
- Search for the modpack and open it.
- Choose the same version as the server, not automatically the newest. Most launchers have a version dropdown on the pack page.
- Install and start it once from the launcher, so it can set everything up.
- Go to Multiplayer, Add Server, paste the address and join.
Join with a pack file the owner sent you
Owners who put their own set together often share it as one file. Launchers turn that file into a ready profile:
| Launcher | How to import the file |
|---|---|
| CurseForge app | Create Custom Profile, then the option to import, and pick the zip file |
| Prism Launcher | Add Instance, then Import, and pick the zip or .mrpack file |
| Modrinth App | Import the .mrpack file while you create a new instance |
The file holds the list of mods and their settings, and the launcher downloads the mods themselves. Only import files from an owner you trust, because a pack can contain any mod.
Joining a Minecraft server with its own mod list
Some servers use a hand picked set of mods instead of a pack. Then you rebuild the same set.
- In your launcher, create a new profile with the same loader (Fabric, Forge or NeoForge) and the same Minecraft version as the server.
- Add the same mods, at the same versions. Many owners share a mod list or a small pack file to make this easy.
- Mods that only change what you see, like a minimap or shaders, are fine to add on your side. Mods that add blocks or items must match the server.
Install Fabric, Forge or NeoForge in the official Minecraft Launcher
No extra launcher? The normal Minecraft Launcher runs mods too, after one installer:
- Download the installer of the loader the server uses from its official site: Fabric, Forge or NeoForge.
- Run it, choose the client install and the Minecraft version of the server. It adds a new installation to the Minecraft Launcher.
- Put the mod files in the
modsfolder of your game, shown in the table below. Create the folder if it is not there. On Fabric, most sets also need Fabric API in that folder. - Start the new installation from the Minecraft Launcher and join.
| Your computer | The mods folder |
|---|---|
| Windows | %appdata%\.minecraft\mods |
| Mac | ~/Library/Application Support/minecraft/mods |
| Linux | ~/.minecraft/mods |
This works well for one server. For several modded servers, a launcher such as Prism keeps each set of mods in a profile of its own, so they never get mixed.
When you can join a modded server without mods
Not every modded server needs mods on your side. A Fabric server that only runs server side mods, such as performance mods, Chunky or LuckPerms, lets players in with the normal game. As soon as a mod adds blocks, items or mobs, everyone needs it, and on Forge and NeoForge servers you almost always need the mods.
Ask the owner which kind of server it is. If you guessed wrong, the error table further down tells you quickly.
Give the Minecraft game enough memory
Your own game needs memory too, separate from the server. Big packs crash or freeze on the default setting.
| Pack size | Memory for your game |
|---|---|
| Light, under 100 mods | 4 GB |
| Medium, 100 to 250 mods | 6 GB |
| Heavy, 250 mods or more | 8 GB |
Set it in your launcher's settings for that profile, usually under Java or Memory. Do not give more than half of your computer's RAM.
Where to set the memory in each launcher
| Launcher | Where the memory setting is |
|---|---|
| CurseForge app | Settings, then Minecraft, then Java Settings: the allocated memory |
| Prism Launcher | Right click the instance, Edit, Settings, Java: the maximum memory allocation |
| Modrinth App | The settings of the instance, under Java and memory |
| FTB App | The settings of the instance, with a slider for the memory |
| Minecraft Launcher | Installations, edit the installation, More options: change -Xmx2G in the JVM arguments to, for example, -Xmx6G |
The new amount counts from the next start of the game, so close it fully and start again.
Mods you may add on your own side
Mods that only change what you see, or how the game runs on your computer, can be added without the server having them:
- Performance: Sodium on Fabric and NeoForge, Embeddium on Forge, for more frames per second.
- Shaders, with the shader loader that fits your pack, see the question about shaders below.
- Maps: a minimap such as Xaero's Minimap or JourneyMap.
- Small comforts such as zoom or a nicer chat.
Check the rules of the server first. Mods that give an unfair edge, such as x-ray, are banned almost everywhere, and some servers switch off the cave view of minimaps.
The modded Minecraft server errors, in plain words
| What you see | What it means |
|---|---|
| Mismatched mod list, or missing mods | Your mods differ from the server's. Install the exact pack version the owner named. |
| Incompatible client, or outdated client | Your Minecraft version differs from the server's. |
| Timed out while logging in | A big pack takes long to sync. Try again once; if it repeats, ask the owner to check the server console. |
| The game closes before the menu | Usually too little memory for the pack, see the table above. |
| You are not whitelisted | The owner needs to add your exact username. |
When your game crashes with the modpack
A crash on your side leaves a report in the folder of your profile, in crash-reports, and the full log in logs/latest.log. Most launchers have a button that opens the profile folder.
- A crash before the main menu is mostly memory or a wrong Java; see the memory tables above.
- A crash when you join, while others can play, points at a mod only you have. Remove what you added yourself and try again.
- A crash for everyone at the same spot is a matter for the server. Send the owner the time and the place.
Sending the crash report to the owner, or to the makers of the pack, usually gets an answer faster than describing it.
When the server updates its modpack
After a pack update on the server, your old version no longer fits. Update the profile in your launcher to the version number the owner names, not simply to the newest, and join again. The world and your buildings live on the server, so updating costs you nothing.
Questions from Minecraft server owners
Can I join a modded Minecraft server from Bedrock or a phone?
No. Mods are for Java Edition on a computer only. Phones and consoles run Bedrock, which cannot load these mods.
Do I need to buy the Minecraft modpack?
No. Modpacks on CurseForge, FTB and Modrinth are free. You only need your own copy of Minecraft Java Edition.
Can I use shaders on a modded Minecraft server?
Yes. Shaders only change what you see, so they are yours to add. On Fabric use Iris, on Forge or NeoForge use Oculus or a similar loader that fits your pack.
Do I need mods to join a modded Minecraft server?
Usually yes, the same ones as the server. Only servers with nothing but server side mods, which happens on Fabric, let you in with the normal game.
Where is the mods folder of Minecraft?
On Windows in %appdata%\.minecraft\mods, on Mac in Library/Application Support/minecraft/mods in your home folder, and on Linux in .minecraft/mods in your home folder. Launchers such as Prism keep a separate folder for each profile.
Can I add my own mods to a modpack when I join a server?
Only mods that work on your side alone, such as a minimap, shaders or performance mods. Mods that add content must be on the server too.
Why does joining a modded Minecraft server take so long?
A big pack sends a lot of data about its blocks and items when you log in, and your game has to load the area around you. The first join after an update is the slowest.
Checked against the CurseForge app, Prism Launcher and Modrinth App, September 2026. Written by the Cheapest Minecraft Hosting team, first published , updated .