PaperMC Logo

Installing Plugins

Customizing your server experience with additional features and custom logic.

1. Understanding the Plugin Ecosystem

In 2026, plugins are no longer just "add-ons", they are complex software modules that interact with the Minecraft internal NMS (Native Minecraft Server) code. To utilize plugins, you must run a compatible engine like Paper, Purpur, or Folia. Plugins allow you to change everything from core game mechanics to custom GUI interfaces without requiring players to install any client-side mods.

2. Trusted Sources: Where to find Safe Software

Running a third-party .jar file gives that code full access to your server's data. In 2026, the community has consolidated around three primary, secure repositories:

  • Modrinth: The modern standard. It features a high-speed API, verified authors, and a clean interface.
  • Hangar (PaperMC): The official repository for Paper-specific plugins, ensuring high performance and API stability.
  • SpigotMC: The legacy giant. While it has the largest collection, be cautious of older, unmaintained plugins that may cause lag on modern Java 25 environments.

3. The "Library" Dependency Model

Many advanced plugins (like Shops or Land Claims) don't work in isolation. They require high-level "Library" plugins to act as bridges.

Critical Dependencies:

  • Vault: The universal bridge for Economy and Permissions. Most plugins speak "Vault" rather than talking to each other directly.
  • PlaceholderAPI (PAPI): Allows plugins to share data (e.g., displaying a player's rank in the chat).
  • ProtocolLib: Provides low-level access to packet data for advanced visual effects and anti-cheats.

4. Deduck Security: Automated Scanning

At Deduck, your security is paramount. Every .jar uploaded to the /plugins directory is automatically scanned by our Heuristic Analysis Engine (HAE). This system looks for "Signature Behaviors" common in malicious plugins, such as unauthorized file deletions, background crypto-mining, or hidden "Op-backdoors." If a threat is detected, the server boot is halted, and you are notified immediately.

5. Debugging Conflicts: The "Half-Split" Method

If your server crashes or lags after adding plugins, you may have a conflict. Use this technical diagnostic workflow:

  1. Isolation: Remove half of your plugins and restart.
  2. Observation: If the error persists, the culprit is in the remaining half. If it's gone, it was in the half you removed.
  3. Iterate: Repeat this "binary search" until you identify the specific pair of plugins that are incompatible.
  4. Check Logs: Look for NoSuchMethodError in the latest.log, this usually means a plugin is built for an older version of Minecraft.

6. Performance Monitoring with Spark

Never guess which plugin is causing lag. Install Spark and run /spark profiler. It provides a detailed breakdown of exactly how many milliseconds each plugin is taking to process each tick. Aim for a "Tick Duration" below 50ms for a lag-free 20 TPS experience.

Sources & Technical References