Modded Minecraft server or plugin server: which one do you need?

Mod or plugin: what is the difference?

A mod is a file that changes the Minecraft game itself. It can add blocks, creatures, dimensions, or change how the game is drawn on screen. To work, it needs a mod loader, meaning a program added to the game that knows how to read those files: Fabric and NeoForge are the two names you will run into. And because a mod touches the game, it has to be installed on every player's computer and on the server, in the same version.

A plugin is a program written in Java, the language Minecraft is made in, that runs only on the server. It comes as a .jar file, the format a Java program is shipped in, and you drop it into the plugins folder of a Paper server, the most used server software and the one Minax targets first. Your players launch the game exactly as they installed it, with nothing added. The only difference they see is what happens in game.

The same logic applies to Spigot and Bukkit, older than Paper and compatible with the same plugins, and to Purpur and Folia, two variants of Paper. Folia spreads the world across several processor cores, but not every plugin works with it: start with Paper. The vanilla server, meaning Mojang's official software with nothing added, accepts no plugins at all: only datapacks, which are packs of rules and are far more limited.

Modded server vs plugin server: how do you choose?

Ask yourself one question: does my idea change the game, or what people do in it? A new dimension, a creature that does not exist with its own animated model, a machine system the game has never had: the game changes, so that is a mod. PvP rules, meaning fights between players, an economy, ranks, a minigame, a /spawn command that brings people back to the arrival point of the server, a protected zone around that point: that is what people do in it, so that is a plugin.

The second question is your players. On a modded server, everyone has to install the loader and exactly the same mods as the server. A friend who cannot manage it does not get in. On a plugin server, everyone joins with the game as it is. If your server is open to the public, or if your friends are not comfortable installing things, that is a strong argument for plugins.

• Choose mods if your idea needs new blocks, creatures or dimensions, or if a specific modpack, meaning a bundle of mods already put together, is the heart of the project
• Choose plugins if your idea fits in rules, commands, an economy, ranks or a minigame
• Choose plugins if you want anyone to be able to join without installing anything
• When in doubt, start with plugins: your server stays open to everyone, and you can move to a modded server later if a real mod is missing

Why not mix mods and plugins on the same server?

Because they are not the same server software. Fabric and NeoForge load mods and ignore the plugins folder. Paper loads plugins and cannot read a mod. A plugin dropped on a Fabric server does nothing, and a mod dropped on a Paper server does nothing either: the file just sits there without starting, or throws an error at startup.

Hybrid server software that tries to load mods and plugins together is said to exist. From what people report, it would be more fragile, and some plugins would not behave the way they do on Paper. If you ever try one, test each plugin one at a time before opening to players, and expect to hunt down the causes of crashes yourself.

The clean path when you really want both is two separate servers: a Paper server for the part open to everyone, and a modded server for the players who installed the modpack. Two addresses, two worlds, two audiences. It is more work, but each server does what it was designed for.

• Fabric and NeoForge read the mods folder, Paper reads the plugins folder: a file in the wrong place does nothing
• A Paper plugin does not convert into a mod, and a mod does not convert into a plugin: they are two different ways of talking to the game
• Hybrid software may exist, but at the price of crashes you would have to diagnose alone

How to create a modded server with Fabric or NeoForge, in brief

Here is the path, without the screen by screen detail: this page is here to help you decide, and the neighbouring pages of this guide walk through installing a server step by step. The principle is the same as for a regular server, with one extra constraint: everything you install on the server side, your players install too.

• 1. Install the Java version your Minecraft version asks for: Java 25 for a 26.x server, Java 21 for a 1.21.x server. Get it from adoptium.net: that site hands out Temurin, a free version of Java you can download without making an account
• 2. Pick your loader. A mod is usually written for one loader, Fabric or NeoForge: look for the mod you cannot live without on Modrinth or CurseForge, the two big mod sites, check the loader named on its download page, and take that one
• 3. Download the loader's installer, which should offer a server option, and run it in an empty folder: it prepares the server for you
• 4. Drop your mods into the mods folder of the server, all in the same Minecraft version as the server
• 5. Start the server once: it creates a file called eula.txt. Open it, replace eula=false with eula=true to accept Mojang's terms of use, start it again, then open port 25565 on your router or pick a host
• 6. Send your players the exact mod list, with versions, and the loader to install on their side: without that, nobody gets in

If you run into the name Forge, it is the same family: NeoForge is said to be its modern successor. A mod announced for Forge would not necessarily run on NeoForge, nor the other way round. Always check the loader and version written on the mod's page, and ask your players for exactly the same thing.

What is a modpack server?

A modpack is a bundle of mods chosen to work together, with their settings, that you install in one go instead of hunting for them one by one. It is the simplest way to play modded with friends: everyone installs the same pack, in the same version, and nobody wonders which mod is missing.

On the server side, you need the same bundle. Some packs would ship with a server version ready to launch, others would ask you to rebuild the mods folder by hand, leaving out the mods that only matter on the player's screen, like a minimap in the corner of the screen or shaders, the lighting effects that change how the game looks. Read the pack's page: it usually says what is planned. And keep the basic rule in mind: the pack version on the players' side and on the server must be exactly the same, or the connection is likely to be refused.

• A modpack is mods plus their settings: the server needs both
• Mods that only change what the player sees would have no business on the server side
• Updating the pack happens on every player at the same time as on the server

How to create a plugin server with Paper, in brief

This is the shortest path, and the one this guide recommends by default. Paper performs far better than the vanilla server and accepts plugins written for Bukkit and Spigot, so pretty much everything out there.

• 1. Install Java: Java 25 for a 26.x server, Java 21 for a 1.21.x server. Paper tells you at startup if the version does not fit
• 2. Download Paper from papermc.io, in the Downloads section, and take a file marked stable for your Minecraft version. Most servers still run 1.21, and 26.2 is the latest version: choose based on what your friends play
• 3. Run the file once: it creates a file called eula.txt. Open it, replace eula=false with eula=true, then run it again: the world is created and the plugins folder appears
• 4. Drop your .jar files into the plugins folder and restart the server
• 5. Open port 25565 on your router, or pick a host, and give your players the address: they join with the normal game

Where do the plugins come from? The classics can be downloaded ready made from Hangar, the download site run by the PaperMC team, and from SpigotMC. For what does not exist yet, Minax builds them to order: you describe the mechanic in plain English, the AI writes the Java code, compiles it into a .jar for your version, from 1.12.2 to 26.2, and you can try it in game on an online test server before you even have your own server. Minax does not host your server: it builds what makes it unique.

Why do so many "mod" ideas end up as plugins?

When someone says "I want a mod for my server", they usually want a mechanic, not a change to the game. An item with a name, a description, effects and a crafting recipe: a plugin does that, with the objects already in the game. A new command, a minigame with its arenas, an economy with a currency and a shop, ranks with their permissions, land protection: all of that is plugin territory. And your players install nothing.

The limit is clear: a plugin cannot create a creature that does not exist in the game, nor a new 3D model, nor a brand new dimension. For a completely new texture, players would also need a resource pack. If your idea stays within what the game already knows how to show, the plugin is almost always the simplest answer.

Here are three requests you can copy as they are on Minax. Change the names, the numbers and the rules: it is your server.

Which mistakes waste the most time?

Most of the hours lost come from a file in the wrong place or a version that does not match. Before digging any deeper, check these seven points.

• Dropping a plugin in the mods folder, or a mod in the plugins folder: the server will never load it
• Taking a mod written for Fabric on a NeoForge server, or the other way round: check the loader written on the mod page
• Installing a plugin compiled for 26.x on a 1.21 server: a 26.x plugin needs a 26.x server, pick the right version when you have it built
• Believing ViaVersion fixes everything: it lets players on another version connect, it never changes the version of the server
• Having players with different mod versions: on a modded server, the list must be identical everywhere
• Starting the server with the wrong Java version: Java 25 for 26.x, Java 21 for 1.21.x, and Paper warns you at startup
• Switching the server to offline mode to "make things simpler": online-mode=false opens the door to username spoofing, do not do it without knowing what it means

What does Minax do in all this?

Minax builds custom Java plugins for Paper servers, from a description in plain English. It does not build mods: if your project requires Fabric or NeoForge, the mod part will happen elsewhere. And Minax does not host servers: yours runs on your PC or with the host of your choice.

What it brings is the mechanic that makes your server unique, without coding. You describe, the AI writes the code, compiles it into a .jar for your version, then you try the plugin in game on an online test server, before you even have your own server. A robot player can also play through the scenario to check that the plugin does what you asked. To create, a credit pack paid once, with no subscription: 50 credits for €17.99. Every option is on the pricing page.

Frequently asked questions