Join our Discord and be part of our community!
Install Client Side Mods
This guide explains how to identify and install client-side Minecraft: Java Edition mods with the Modrinth App. Client-side mods run on your computer rather than your UltraServers server and commonly add visual, performance, interface, or accessibility features.
Understand Mod Environments
Before installing a mod, open its Modrinth project page and review the Supported environments, Platforms, and Minecraft: Java Edition sections.
Modrinth identifies mods using the following environments:
- Client-side: Install the mod only on your computer. Do not upload it to your UltraServers server.
- Server-side: Install the mod on the server. It is not a client-side mod.
- Client and server: The mod may need to be installed on both the server and every connecting client.
A mod's environment is separate from its loader and Minecraft version. For example, a client-side mod may support only Fabric and Minecraft 1.21.1.
Prerequisites
Before proceeding:
- Confirm that you own Minecraft: Java Edition.
- Identify the Minecraft version you intend to play.
- Check which loader the mod supports, such as Fabric, Forge, NeoForge, or Quilt.
- Check the mod's project page for required dependencies, such as Fabric API.
- If you are joining a modded server, confirm the server's Minecraft version and mod loader.
Download the Modrinth App
- Visit the official Modrinth App download page.
- Click the 1 download option for your operating system.
- Select the Windows download when using Windows.
- Select the macOS download when using macOS.
- Modrinth recommends Flathub when using Linux.
- Run the downloaded installer.
- Open the Modrinth App after installation.
- Sign in to your Microsoft account when prompted so that the app can launch Minecraft.
Create an Instance
- Open the Play page in the Modrinth App.
- Click the 1 Create instance option.
- Select the Custom instance option.
- Enter a 1 Name for the instance.
- Select the mod's supported 2 Loader.
- Select the required 3 Game version.
- Click 4 Create.
Add Mods
- Open the instance you created.
- Select 1 Content.
- Click 2 Add content.
- Select the 1 Mods tab.
- Enter the mod's name in the 2 search field.
- Review the mod's compatibility information.
- Confirm that the mod supports:
- Your Minecraft version.
- Your selected mod loader.
- The client environment.
- Click 3 Install.
- Repeat these steps for any required dependencies.
Start Minecraft
- Return to the 1 Play page.
- Locate the instance you created.
- Click the instance's 2 Play button.
- Wait for Minecraft to start.
- Confirm that the mod appears or operates as described by its developer.
Troubleshooting
Minecraft Crashes During Startup
- Confirm that every installed mod supports the instance's Minecraft version.
- Confirm that every installed mod supports the selected loader.
- Install any dependencies listed on the mod's project page.
- Remove the most recently installed mod, then start the instance again.
- Review the instance logs for the mod or dependency named in the error.
The Mod Does Not Appear In-Game
- Confirm that you launched the correct Modrinth instance.
- Confirm that the mod appears in the instance's Content section.
- Check whether the mod requires configuration, a keybind, or another dependency.
- Confirm that the mod supports the client environment.
- Restart Minecraft after installing the mod.
Unable to Join the Server
- Confirm that the client and server use compatible Minecraft versions.
- If the server requires client mods, install compatible versions of those mods locally.
- Confirm that your client uses the required mod loader.
- Remove any mod that reports an incompatibility during connection.
- Do not upload client-side-only mods to the UltraServers server.
If you require further assistance, you can open a support ticket here.
Feedback and suggestions can be submitted here or further discussed on our Discord server.