Player Setup
Help your players install the correct modpack so they can join your server without mod mismatch errors.
When running a modded server, all players need to have the exact same mods and versions installed on their computer. If there's a mismatch, they'll get a "mod mismatch" or "connection lost" error when trying to join.
Using the Player Setup Page
-
Open Player Setup
In your server dashboard, click Player Setup in the left sidebar under Management.
-
View Your Modpack Info
The page will show which modpack is installed on your server, including:
- Modpack name and icon
- Minecraft version
- Mod loader (Forge, Fabric, NeoForge)
- Direct link to the modpack page
-
Share with Your Players
You have two easy options:
- Copy the link - Click "Copy Link" and send the modpack URL to your players
- Copy the message - Use the pre-written message at the bottom of the page
How Players Install the Modpack
Once your players have the modpack link, they can install it using one of these launchers:
CurseForge App (Recommended)
- Download and install CurseForge App
- Click the modpack link you shared
- Click "Install" on the modpack page
- Once installed, click "Play" to launch
- Add your server IP in Multiplayer and connect!
Prism Launcher
- Download and install Prism Launcher
- Click "Add Instance" → "CurseForge" or "Modrinth"
- Search for the modpack name
- Select the same version as your server
- Install and launch, then add your server
Modrinth App
- Download and install Modrinth App
- Click the modpack link (if it's a Modrinth modpack)
- Click "Install"
- Launch and add your server IP
Make sure your players download the exact same version of the modpack that's installed on your server. Different versions = can't connect.
Common Issues
"Mod mismatch" or version error
- The player has a different version of the modpack
- Solution: Have them reinstall the exact version shown on your Player Setup page
"No Modpack Detected" on Player Setup page
- You installed mods manually instead of using the Modpacks tab
- Solution: Use the Modpacks tab to install a modpack, or manually share the mod list with your players
Player has extra mods
- Client-side mods (like minimaps, shaders) are usually fine
- Mods that add items/blocks must match exactly
- When in doubt, use the exact same modpack with no additions
Quick Share Message
The Player Setup page includes a pre-written message you can copy and send to your players:
Hey! To join our server, install this modpack:
https://modrinth.com/modpack/your-modpack
Make sure to get the 1.20.1 version!
Need help? Join our Discord!