Minecraft server help centre

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.

  1. Install the launcher and sign in with your Microsoft account.
  2. Search for the modpack and open it.
  3. Choose the same version as the server, not automatically the newest. Most launchers have a version dropdown on the pack page.
  4. Install and start it once from the launcher, so it can set everything up.
  5. 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:

LauncherHow to import the file
CurseForge appCreate Custom Profile, then the option to import, and pick the zip file
Prism LauncherAdd Instance, then Import, and pick the zip or .mrpack file
Modrinth AppImport 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.

  1. In your launcher, create a new profile with the same loader (Fabric, Forge or NeoForge) and the same Minecraft version as the server.
  2. Add the same mods, at the same versions. Many owners share a mod list or a small pack file to make this easy.
  3. 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:

  1. Download the installer of the loader the server uses from its official site: Fabric, Forge or NeoForge.
  2. Run it, choose the client install and the Minecraft version of the server. It adds a new installation to the Minecraft Launcher.
  3. Put the mod files in the mods folder 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.
  4. Start the new installation from the Minecraft Launcher and join.
Your computerThe 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 sizeMemory for your game
Light, under 100 mods4 GB
Medium, 100 to 250 mods6 GB
Heavy, 250 mods or more8 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

LauncherWhere the memory setting is
CurseForge appSettings, then Minecraft, then Java Settings: the allocated memory
Prism LauncherRight click the instance, Edit, Settings, Java: the maximum memory allocation
Modrinth AppThe settings of the instance, under Java and memory
FTB AppThe settings of the instance, with a slider for the memory
Minecraft LauncherInstallations, 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 seeWhat it means
Mismatched mod list, or missing modsYour mods differ from the server's. Install the exact pack version the owner named.
Incompatible client, or outdated clientYour Minecraft version differs from the server's.
Timed out while logging inA 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 menuUsually too little memory for the pack, see the table above.
You are not whitelistedThe 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 .