Server Mods vs Plugins vs Data Packs: What Goes Where

Defining the Three Mechanisms

A mod changes how Minecraft itself behaves — new blocks, machines, dimensions — by hooking into the game code through a mod loader such as Forge, NeoForge, or Fabric. A plugin is server-side logic written against the Bukkit API that Paper and Spigot expose; players see its effects without installing a single file. A data pack is the vanilla mechanism: JSON files in world/datapacks/ that replace recipes, loot tables, and structures without any loader. Think of plugins as server policies and mods as a different game.

Mechanism   Runs under              Client install   Loads from
Plugin      Paper / Spigot          none             plugins/
Mod         Forge / NeoForge /      required,        mods/
            Fabric                  matching set
Data pack   Vanilla server          none             world/datapacks/

Installing Plugins

Plugins attach to the Bukkit API, so they run only on Paper, Spigot, or a compatible fork — never on vanilla or on a mod loader. Download the .jar, upload it into plugins/, restart the server, and the plugin usually creates its own config.yml in a folder of the same name. Keep the original filename for most plugins; many updaters and install wizards rely on it when replacing builds.

plugins/
  EssentialsX.jar        <- raw plugin jar
  LuckPerms/LuckPerms.jar
  Essentials/config.yml  <- generated config, edit here
  LuckPerms/config.yml
Restart the server after every upload; reload commands do not pick up new jars.

• Only Paper-fork servers can host plugins; a plugin placed on a modded server simply never loads.
• Check the plugin targets your Minecraft version's API; a build for an older API may break on a newer server.
• Back up each plugin's config folder before updates — your settings live there, not inside the jar.

Installing Mods

A mod must sit in the mods/ folder on the server and in the mods/ folder on every player's client, with the identical loader and Minecraft version everywhere. Forge and NeoForge servers of the same version share the folder layout; Fabric servers use Fabric API and their own mod format. When the sets drift, clients hit registry mismatches or disconnect silently. Install a whole modpack as one unit and resist mixing individual mods from different packs.

server/mods/   spark-1.10.109.jar
               jei-1.20.1-fabric.jar      <- Fabric flavour
client/mods/   identical: same filenames, same versions
loader:        fabric-loader-0.15.11 or forge-47.x, matching on both sides
Kick message if they drift: 'registry mismatch' or instant disconnect.

Data Packs and Client-Only Mods

Data packs give vanilla servers extra behaviour — new recipes, custom loot, dimensions — through JSON placed in world/datapacks/. Run /reload and then /datapack list to activate and verify them; no client install is needed, although some packs reference resource packs players load voluntarily. Client-only mods such as Sodium, minimaps, or Iris run strictly on the player's machine, so the server never hosts them, does not need them, and never kicks over a difference between them.

• Data packs: drop the .zip into world/datapacks/, run /reload, then verify with /datapack list.
• Client-only mods: install locally and the server ignores them completely — no registry mismatch risk.
• Server mods that add content must be copied to every client, or the client is kicked on join.
• Resource packs are advertised via server.properties and accepted or refused by the client.

The Decision Summary

Match your goal to the mechanism before downloading. Want ranks, economy, and claims without touching clients? That is a plugin on Paper. Want new machines and dimensions shared by a whole community? That is a Forge or Fabric mod, or an entire modpack, matched on every client. Want a lightweight vanilla tweak with zero friction? That is a data pack. Mixing the types on one server is unusual because the API families overlap only in experimental forks, so pick the loader that matches your goal.

Goal                    Mechanism   Server file        Clients need
Ranks, economy, claims  Plugin      plugins/           nothing
Tech / magic content    Mod         mods/              same mod set
Recipe / loot tweaks    Data pack   world/datapacks/   nothing
Better FPS (visual)     Client mod  n/a                install on client