Minecraft · Mods · Client guide

How to use mods on your Minecraft server

For a mod to work, your server and launcher must use the same Minecraft version, the same loader and compatible mods. This guide takes you through each step, even if it is your first time.

Go to My services View Minecraft plans
!

Uploading a .jar file does not turn a Vanilla server into a modded server

You can upload files to the folder mods/, but they will only load if the server uses a compatible loader such as Forge, Fabric, NeoForge or Quilt.

Before you start

A Minecraft mod is not simply a file uploaded to the server. For it to work, the server must be prepared and players must launch Minecraft with the correct profile.

Vanilla

This is Minecraft without a mod loader. It works for standard play, but it will not run mods even if a folder exists mods/.

Modded server

Use Forge, Fabric, NeoForge, Quilt or another compatible loader. That loader is what allows the mods to load.

Client mods

They are installed on the player computer. Some change graphics, interface or performance.

Server mods

They are installed on the server. Some mods must be on the server and also in the launcher.

Quick steps

Follow this order to avoid errors. If a step does not match, the server will usually fail to load or the player will be unable to join.

Check the Minecraft version Example: if the server uses 1.20.1, the launcher must also open 1.20.1.
Check the loader The mod should state whether it requires Forge, Fabric, NeoForge or Quilt.
Upload the mods to the server From QHItech go to My services, click Manage, open Files and use the folder mods/.
Install what you need in your launcher If the player also needs the mod, install the same loader and the same mods on your computer.
Restart the server After uploading, removing or changing mods, restart the server so it loads the new configuration.
Join with the correct profile Do not join with Vanilla if the server uses Forge, Fabric, NeoForge or Quilt.

What must match

Most mod issues come from incompatibility between server, launcher and files.

Item What to check Clear example
Minecraft version Server and launcher must use the same version. 1.20.1 with 1.20.1.
Loader Forge, Fabric, NeoForge and Quilt are not the same. A Fabric mod does not work on Forge unless the mod says so.
Mod version The mod file must be compatible with your version. A mod for 1.21 may fail on 1.20.1.
Dependencies Some mods need other mods to work. If a library is missing, the server may not start.
Correct side There are client, server or both-side mods. If it is required on both sides, it must be on the server and launcher.

How to upload mods from the QHItech panel

Use the panel as your management area. You do not need to run commands: open the service and work from the files section.

  1. Go to My services.
  2. Find your Minecraft server.
  3. Click Manage.
  4. Open the Files.
  5. Go to the folder mods/.
  6. Only upload files .jar compatible.
  7. Restart the server.
Do not mix mods at random. If the server stops starting immediately after you upload a mod, remove the last file added and check for missing dependencies.

How to prepare your launcher

If the server uses mods, you should normally not start Minecraft with the standard profile. Start it with the correct loader profile.

Official launcher

Install the loader you need and select that profile before playing.

Modpacks

If you use a modpack, all players must use the same modpack version.

Simple rule: if the server uses Minecraft 1.20.1 with Forge, your launcher must start Minecraft 1.20.1 with Forge. If you join with Vanilla, it will not work.

Mods and plugins are not the same

It is normal to confuse them. The difference matters because they are installed and work differently.

Mods

They require loaders such as Forge, Fabric, NeoForge or Quilt. Many mods must also be installed on the player's computer.

Forge Fabric NeoForge Quilt

Plugins

They are used on servers such as Paper, Spigot or Purpur. Players normally do not install anything on their computers.

Paper Spigot Purpur

If it does not work

When a modded server fails, the most useful first step is to review the latest change. The problem is usually an incompatible version, a missing dependency or a mod installed on the wrong side.

  • Check that the server is not Vanilla.
  • Check that Minecraft version, loader and mod match.
  • Remove the last added mod and restart.
  • Check whether the mod requires a dependency.
  • Check whether the mod must also be installed in the launcher.
  • Check the logs from the panel if the server does not start.
  • If in doubt, contact support before wasting time testing randomly.

FAQ

Can I upload mods to a Vanilla server?

You can upload files, but Vanilla will not run them. To play with actual mods, you need a server with a compatible loader.

Do all players need to install the mods?

It depends on the mod. Some are server-only, others client-only, and many must be on both sides.

Can I mix Forge and Fabric?

Not as a general rule. Use the loader specified by the mod or modpack.

What do I do if the server does not start after uploading mods?

Remove the last added mod, restart and check whether a dependency is missing or the mod is for another version.

Final checklist before joining

  • Server with the correct loader.
  • Correct Minecraft version.
  • Mods compatible with that version.
  • Dependencies installed.
  • Launcher using the same loader.
  • Client mods installed if needed.
  • Server restarted after uploading changes.

Do you want to manage your mods now?

Enter your client area, open your Minecraft server and use the files section.

Go to My services Contact support