Mods and plugins extend your Minecraft server, but they do not work the same way: plugins are intended for Paper or Spigot and usually run without client installation, while each Forge or Fabric mod declares where it must run. Server-only mods stay on the server; client-required mods must be installed in matching versions on the relevant player PCs. The decisive factors are Minecraft version, server software, dependencies, and a clean test after every restart.
Plugins or Mods: Choose the Right Foundation
Before you upload files, define what you want to achieve. If you want to add permissions, home points, protected regions, economy, moderation, or admin tools, Paper/Spigot plugins are usually the right path. If you want to add new blocks, biomes, tech systems, mobs, or deeper gameplay mechanics, you usually need Forge or Fabric mods.
| Feature | Plugins (Paper/Spigot) | Mods (Forge/Fabric) |
|---|---|---|
| Installation | Simple: JAR in /plugins | JAR in /mods |
| Client needed? | No | Depends on the mod environment |
| Performance | Better | Variable |
| Compatibility | High | Can collide |
| Examples | EssentialsX, WorldEdit | OptiFine, Biomes O Plenty |
The official Paper documentation describes Paper as server software for Minecraft: Java Edition and refers for plugins, among other things, to the PaperMC ecosystem. An obvious primary source for Paper plugins is therefore Hangar by PaperMC. For additional plugin management, the deeper internal guide Install and Manage Minecraft Plugins in the Panel also fits.
Requirements Before Installation
First check the installed Minecraft version of your server. A plugin or mod must match this version and the chosen server software. A file for another major version may sometimes start, but should not be assumed stable.
Stop the server before replacing JAR files. Create or check a current backup of world, configuration, and plugin or mod folder. Especially with Forge and Fabric setups, a single version conflict can prevent the server from starting fully.
Also watch for dependencies. Some plugins need additional libraries or base plugins such as Vault. Some mods require Fabric API, Cloth Config, or other mod libraries. These notes are normally listed on the project page of the respective extension.
Install Plugins with Paper or Spigot
- Download the plugin from Hangar or Modrinth.
- Go to your server dashboard on game-serverhosting.
- Navigate to the Mods & Plugins tab.
- Search for the desired plugin and click Install if it is available in the panel.
- Restart the server.
Alternatively, you can manually upload the JAR file to the /plugins folder. After the restart, the plugin usually automatically creates a configuration file in its own subfolder. Only open this file after the server has started once with the plugin, otherwise default values are often missing.
Recommended plugins for beginners remain typical basic tools, but install only what you really need:
EssentialsX – Basic functions (home, warp, kits)
LuckPerms – Permission system
WorldGuard – Region protection
Vault – Economy system
CoreProtect – Block logging / anti-grief
After installation, do not just test whether the server starts. In-game, check at least one plugin command, permission assignment, and console output. If a plugin loads but commands are blocked, the problem is often permissions or missing dependencies.
Install Mods with Forge or Fabric
- Make sure your server is running Forge or Fabric.
- Download the mod from Modrinth or CurseForge.
- Upload the JAR to the
/modsfolder. - Important: Check each mod's environment. Server-only mods stay on the server; client-required mods must be installed in matching versions on affected player PCs.
- Restart the server.
With client-required mods, version equality is especially important. The server, participating player clients, modloader, and shared mod files must match. If a player sees a mod list or registry error message when connecting, a mod is usually missing on the client, installed in a different version, or the client is using the wrong loader.
Install new mods step by step. Start the server after a few changes and check the console. This lets you find conflicts faster instead of no longer knowing which mod prevents startup after 30 new files. If you often work with modloaders, similar processes also help with other games, for example in the guide Install Valheim Mods with BepInEx or with V Rising Mods with BepInEx.
Check the Result
After the restart, the console is your first checkpoint. Look for messages such as ERROR, WARN, Could not load, Missing dependency, or version notes. Not every warning is critical, but startup aborts, disabled plugins, and missing classes must be fixed.
In-game, then check specific functions: does the world load correctly? Can players join? Do new commands work? Are new blocks, items, or menus displayed? For plugins, also test permissions and groups. For mods, at least one player with the exact same modpack should connect.
Troubleshooting Common Errors
Plugin does not load: Check the Minecraft version and whether the plugin is suitable for Paper/Spigot. A Forge mod does not work as a Paper plugin, even though both files are JARs.
Server does not start: Check the console for error messages. Dependencies are often missing, a file was built for another Minecraft version, or two extensions overwrite the same function.
Mod conflict: Remove mods individually or in small groups to find the conflict. Start with the most recently installed files and restart after every change.
Players cannot connect: Compare modloader, Minecraft version, and mod files between server and client. With Forge/Fabric, compare each mod's declared environment; only client-required mods belong on player clients.
Lag after installation: Use /spark profiler if Spark is installed to check whether a plugin or mod is using an unusually large amount of time. Disable extensions you do not need and test again with realistic player actions.
Testing, Limits, and a Safe Rollback
The guide “Install Minecraft Mods and Plugins – Simple Guide” applies to the server type described in the article and the version status visible at the time of review. Menu names, available versions, mod or plugin compatibility, and required resources may differ after updates. Therefore, do not transfer values to another game, loader, or server version without checking them first.
Before changing a world, savegame, configuration, or extensions, create a backup of the affected files. Then change only one related step and test it with the same client and server version you later want to play with.
| Checkpoint | Expected Result | Abort and Rollback |
|---|---|---|
| Server start | The server reaches the ready-to-run state without new error messages. | If startup errors occur, revert the change and restore the last backup. |
| Connection test | A test account can connect via the address shown in the panel. | If version or connection errors occur, compare version, port, and firewall/opening settings again. |
| Function test | The specifically changed function works without damaging existing world or game data. | If side effects occur, stop the server and restore the backed-up files. |
A successful individual test is not a performance or availability guarantee. World size, mods, plugins, player count, network path, and simultaneous load can change the result. Document version, change, and test result so you can trace later differences.
FAQ
Can I Use Paper Plugins and Forge Mods at the Same Time?
Not in a normal standard setup. Paper/Spigot plugins and Forge/Fabric mods belong to different server ecosystems. Choose the platform that fits your goal.
Do Players Have to Install Plugins?
With classic Paper or Spigot plugins, normally no. Players connect with a normal Minecraft client. Exceptions can be client-side extra features or resource packs that a plugin optionally uses.
Why Does My Server No Longer Start After Adding a Mod?
Usually a version does not match, a dependency is missing, or two mods are incompatible. Read the first relevant error message in the console and temporarily remove the most recently installed mod.
Where Do JAR Files Belong?
Plugins belong in /plugins, mods in /mods. The correct folder does not depend on the file type alone, but on the server software: Paper/Spigot uses plugins, Forge/Fabric uses mods.
Should I Install Many Extensions at Once?
No. Install them in small steps and test after every restart. This makes errors traceable and prevents you from having to check all files at the same time when conflicts occur.