[{"data":1,"prerenderedAt":32},["ShallowReactive",2],{"doc-en-install-plugin-minecraft-paper-spigot":3},{"path":4,"slug":5,"title":6,"description":7,"category":8,"subcategory":9,"icon":10,"date":11,"author":12,"order":13,"image":14,"tags":15,"keywords":21,"docGroup":29,"docGroupIcon":29,"link_fr":30,"bodyHtml":31},"\u002Fdocs\u002Fen\u002Fgaming\u002Fminecraft-java\u002Finstall-plugin-minecraft-paper-spigot","install-plugin-minecraft-paper-spigot","How to Install a Plugin on Your Minecraft Server (Paper \u002F Spigot)","Install a plugin on your Winheberg Paper or Spigot Minecraft server with the panel's Plugins installer, or by hand through the plugins folder.","jeux","minecraft-java","tabler:file-text","2026-11-01","Winheberg",108,"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fminecraft-java\u002Finstall-plugin-minecraft-paper-spigot.webp",[16,17,18,19,20],"minecraft","plugin","paper","spigot","gaming panel",[22,23,24,25,26,27,28],"install minecraft plugin","paper plugin","spigot plugin","plugins folder","minecraft java server","panel plugin installer","minecraft plugin not loading","","\u002Fdocs\u002Fminecraft-java\u002Finstaller-plugin-minecraft-paper-spigot","\u003Ch2>Context\u003C\u002Fh2>\n\u003Cp>Plugins are the easiest way to extend a Minecraft Java server without touching your players&#39; game client. Permissions, teleportation, economy, land protection or mini-games, it all comes down to a \u003Ccode>.jar\u003C\u002Fcode> file placed in the server&#39;s \u003Ccode>plugins\u003C\u002Fcode> folder. Since Paper is based on Spigot, the vast majority of Bukkit and Spigot plugins work on both.\u003C\u002Fp>\n\u003Cp>On a Winheberg Minecraft server, the panel includes a plugin installer that searches the main providers directly and drops the file in the right place. This guide shows you how to use it, then how to add a plugin by hand when it isn&#39;t listed.\u003C\u002Fp>\n\u003Ch2>Prerequisites\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>A \u003Ca href=\"https:\u002F\u002Fwinheberg.com\u002Fen\u002Fgaming\u002Fminecraft\">Winheberg Minecraft Java server\u003C\u002Fa> running Paper or Spigot\u003C\u002Fli>\n\u003Cli>Access to the \u003Ca href=\"https:\u002F\u002Fpanel.winheberg.com\u002F\">Winheberg panel\u003C\u002Fa>\u003C\u002Fli>\n\u003Cli>Your server&#39;s Minecraft version, so you can pick a compatible plugin\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"markdown-alert markdown-alert-note\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"10\"\u002F>\u003Cline x1=\"12\" y1=\"16\" x2=\"12\" y2=\"12\"\u002F>\u003Cline x1=\"12\" y1=\"8\" x2=\"12.01\" y2=\"8\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>If your server still runs Vanilla, the \u003Cstrong>Versions\u003C\u002Fstrong> tab in the CONFIGURATION section lets you install Paper or Spigot. Leave the \u003Cstrong>Wipe Server Files\u003C\u002Fstrong> option turned off, otherwise every file on the server is deleted before the install.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Cdiv class=\"markdown-alert markdown-alert-warning\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Cpath d=\"M10.29 3.86L1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0z\"\u002F>\u003Cline x1=\"12\" y1=\"9\" x2=\"12\" y2=\"13\"\u002F>\u003Cline x1=\"12\" y1=\"17\" x2=\"12.01\" y2=\"17\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>A plugin runs with full access to your server. Only install well-known plugins, published by recognized providers or on their author&#39;s official page.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>1. Open the plugin installer\u003C\u002Fh2>\n\u003Cp>Log in to the Winheberg panel and select your server. In the side menu, under CONFIGURATION, click \u003Cstrong>Plugins\u003C\u002Fstrong>.\u003C\u002Fp>\n\u003Cp>The page shows a list of plugins with several filters at the top.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fminecraft-java\u002Finstall-plugin-minecraft-paper-spigot-1793566382172-95b3ab7f2999fadd4acef073.webp\" alt=\"Plugins page in the Winheberg panel with the Provider, Page size, Plugin loader and Minecraft version filters\" width=\"630\" \u002F>\n\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Filter\u003C\u002Fth>\n\u003Cth>Purpose\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Cstrong>Provider\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>Where to search, among CurseForge, Hangar, Modrinth, Polymart and SpigotMC (Modrinth by default)\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>Page size\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>Number of results shown (10, 25 or 50)\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>Plugin loader\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>Target software, for example Paper, Spigot, Bukkit or Purpur\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>Minecraft version\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>Your server&#39;s game version\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>Search query\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>Name of the plugin you&#39;re looking for\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch2>2. Search for the plugin\u003C\u002Fh2>\n\u003Cp>Set \u003Cstrong>Plugin loader\u003C\u002Fstrong> to your server&#39;s software, for example \u003Ccode>Paper\u003C\u002Fcode>, pick your version in \u003Cstrong>Minecraft version\u003C\u002Fstrong>, then type the plugin name in \u003Cstrong>Search query\u003C\u002Fstrong>. In the example below, we search for LuckPerms for a Paper 26.3 server.\u003C\u002Fp>\n\u003Cp>Then click the download icon on the plugin&#39;s card.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fminecraft-java\u002Finstall-plugin-minecraft-paper-spigot-1793566307151-f0bcf231f1b6a808fafb1284.webp\" alt=\"LuckPerms search filtered on Paper and 26.3, download icon highlighted\" width=\"630\" \u002F>\n\n\u003Cdiv class=\"markdown-alert markdown-alert-tip\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"10\"\u002F>\u003Cpath d=\"M12 16v-4\"\u002F>\u003Cpath d=\"M12 8h.01\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>If a plugin doesn&#39;t show up, switch to another provider in \u003Cstrong>Provider\u003C\u002Fstrong>. A plugin isn&#39;t necessarily published everywhere.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>3. Pick the version and install\u003C\u002Fh2>\n\u003Cp>The \u003Cstrong>Install plugin\u003C\u002Fstrong> window opens. Select the version you want in the \u003Cstrong>Plugin version\u003C\u002Fstrong> list, usually the latest one, then click \u003Cstrong>Install plugin\u003C\u002Fstrong>.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fminecraft-java\u002Finstall-plugin-minecraft-paper-spigot-1793566195145-f5b5d57f3d7f348891d101ed.webp\" alt=\"Install plugin window with the Plugin version list and the Install plugin button\" width=\"372\" \u002F>\n\n\u003Cp>A notification confirms the file was placed in the server&#39;s \u003Ccode>plugins\u003C\u002Fcode> folder.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Plugin &quot;LuckPerms&quot; successfully installed in \u002Fhome\u002Fcontainer\u002Fplugins.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"markdown-alert markdown-alert-note\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"10\"\u002F>\u003Cline x1=\"12\" y1=\"16\" x2=\"12\" y2=\"12\"\u002F>\u003Cline x1=\"12\" y1=\"8\" x2=\"12.01\" y2=\"8\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>The list may offer a version tagged \u003Ccode>(Bukkit)\u003C\u002Fcode>. Bukkit plugins also load on Paper and Spigot.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>4. Restart the server and check\u003C\u002Fh2>\n\u003Cp>The plugin is only loaded at startup. In \u003Cstrong>Console\u003C\u002Fstrong>, restart the server with the \u003Cstrong>Restart\u003C\u002Fstrong> button and watch the logs, a line confirms it was enabled.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">[LuckPerms] Successfully enabled. (took 2167ms)\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Once the server is up, type the following command in the panel console, without a \u003Ccode>\u002F\u003C\u002Fcode> in front.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-bash\">plugins\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>It lists the loaded plugins. In game, the equivalent is \u003Ccode>\u002Fplugins\u003C\u002Fcode>, where a plugin shown in green is enabled and a plugin shown in red could not be enabled.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fminecraft-java\u002Finstall-plugin-minecraft-paper-spigot-1793566195630-fb54fd0cdbd2f2a3fcb09215.webp\" alt=\"Output of the plugins command in the console, LuckPerms listed under Bukkit Plugins\" width=\"605\" \u002F>\n\n\u003Cdiv class=\"markdown-alert markdown-alert-important\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Cpath d=\"M12 22c5.523 0 10-4.477 10-10S17.523 2 12 2 2 6.477 2 12s4.477 10 10 10z\"\u002F>\u003Cpath d=\"M12 8v4\"\u002F>\u003Cpath d=\"M12 16h.01\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>After adding or removing a plugin, fully restart the server instead of using \u003Ccode>\u002Freload\u003C\u002Fcode>. Paper itself displays a warning about this command, which can cause bugs and memory leaks.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>Alternative method, upload the .jar file by hand\u003C\u002Fh2>\n\u003Cp>If the plugin isn&#39;t offered by any of the installer&#39;s providers, or if you have a file supplied by its author, you can add it yourself.\u003C\u002Fp>\n\u003Col>\n\u003Cli>Download the \u003Ccode>.jar\u003C\u002Fcode> file from a trustworthy source, for example \u003Ca href=\"https:\u002F\u002Fhangar.papermc.io\u002F\">Hangar\u003C\u002Fa>, \u003Ca href=\"https:\u002F\u002Fmodrinth.com\u002Fdiscover\u002Fplugins\">Modrinth\u003C\u002Fa> or \u003Ca href=\"https:\u002F\u002Fwww.spigotmc.org\u002Fresources\u002F\">SpigotMC\u003C\u002Fa>, and check that it matches your Minecraft version\u003C\u002Fli>\n\u003Cli>In the panel, open \u003Cstrong>Files\u003C\u002Fstrong> then the \u003Ccode>plugins\u003C\u002Fcode> folder\u003C\u002Fli>\n\u003Cli>Click \u003Cstrong>Upload\u003C\u002Fstrong> and select the \u003Ccode>.jar\u003C\u002Fcode> file\u003C\u002Fli>\n\u003Cli>Restart the server and check with the \u003Ccode>plugins\u003C\u002Fcode> command\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>The file must sit directly in \u003Ccode>plugins\u003C\u002Fcode>, a \u003Ccode>.jar\u003C\u002Fcode> placed in a subfolder is not read. If the plugin ships as a \u003Ccode>.zip\u003C\u002Fcode> archive, extract it on your computer and upload only the \u003Ccode>.jar\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cdiv class=\"markdown-alert markdown-alert-note\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"10\"\u002F>\u003Cline x1=\"12\" y1=\"16\" x2=\"12\" y2=\"12\"\u002F>\u003Cline x1=\"12\" y1=\"8\" x2=\"12.01\" y2=\"8\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>Uploads through the panel file manager are limited to 100 MB per file. Beyond that, use SFTP with FileZilla or WinSCP by following our guide \u003Cstrong>\u003Ca href=\"https:\u002F\u002Fwinheberg.com\u002Fen\u002Fdocs\u002Fpanel-gaming\u002Fsftp-gaming-server\">How to Connect to Your Gaming Server via SFTP\u003C\u002Fa>\u003C\u002Fstrong>. Your credentials are in \u003Cstrong>Settings\u003C\u002Fstrong>, and the password is the one for your panel account.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>If you run into trouble\u003C\u002Fh2>\n\u003Cp>Your first step is to open the \u003Ccode>logs\u002Flatest.log\u003C\u002Fcode> file from \u003Cstrong>Files\u003C\u002Fstrong>. Plugin loading messages appear near the beginning of the file.\u003C\u002Fp>\n\u003Ch3>❌ The plugin doesn&#39;t show up in the list after installing it\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>Check that the server was restarted after the install\u003C\u002Fli>\n\u003Cli>For a manual upload, check that the file sits directly in \u003Ccode>plugins\u003C\u002Fcode> and that its name ends in \u003Ccode>.jar\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>Search for the plugin name in \u003Ccode>logs\u002Flatest.log\u003C\u002Fcode> to spot any error\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ A dependency is missing\u003C\u002Fh3>\n\u003Cp>The plugin needs another plugin to work. The console shows a line like this one.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Unknown\u002Fmissing dependency plugins: [Vault]\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cul>\n\u003Cli>Install the plugin named in brackets with the \u003Cstrong>Plugins\u003C\u002Fstrong> installer or from its official page\u003C\u002Fli>\n\u003Cli>Restart the server\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ The plugin isn&#39;t compatible with the server version\u003C\u002Fh3>\n\u003Cp>An \u003Ccode>Unsupported API version\u003C\u002Fcode> message means the plugin was built for a newer Minecraft version than the one your server runs.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Reinstall the plugin with the \u003Cstrong>Minecraft version\u003C\u002Fstrong> filter set to your server&#39;s version\u003C\u002Fli>\n\u003Cli>Check the plugin page for the list of supported versions\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ The plugin.yml file is invalid\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>The file may be a Forge or Fabric mod, which doesn&#39;t run on Paper or Spigot\u003C\u002Fli>\n\u003Cli>The download may be corrupted, reinstall the plugin\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ Two versions of the same plugin are installed\u003C\u002Fh3>\n\u003Cp>An \u003Ccode>Ambiguous plugin name\u003C\u002Fcode> warning means two files contain the same plugin, often after an update.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Delete the old \u003Ccode>.jar\u003C\u002Fcode> in \u003Ccode>plugins\u003C\u002Fcode> from \u003Cstrong>Files\u003C\u002Fstrong> and keep only the newest one\u003C\u002Fli>\n\u003Cli>Restart the server\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Best practices\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>\u003Cstrong>Create a backup\u003C\u002Fstrong> from the \u003Cstrong>Backups\u003C\u002Fstrong> tab before installing or updating a plugin, as explained in our guide \u003Cstrong>How to Create and Restore a Backup of Your Gaming Server\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Add plugins one at a time\u003C\u002Fstrong> and restart between each one, which makes it much easier to spot the one causing trouble\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Keep a list of your plugins\u003C\u002Fstrong> with their version and provider, handy when updating Minecraft\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Remove unused plugins\u003C\u002Fstrong>, since every loaded plugin uses resources at startup and in game\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Test your permissions\u003C\u002Fstrong> with a non-operator account, as shown in our guide \u003Cstrong>\u003Ca href=\"https:\u002F\u002Fwinheberg.com\u002Fen\u002Fdocs\u002Fminecraft-java\u002Finstall-use-essentialsx-minecraft\">How to install and configure EssentialsX on a Minecraft server\u003C\u002Fa>\u003C\u002Fstrong>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Need help?\u003C\u002Fh2>\n\u003Cp>If a plugin still refuses to load after these checks, our team can help you read the logs. Open a ticket in the \u003Cstrong>Technical\u003C\u002Fstrong> department from your client area, fill in the \u003Cstrong>Related Product\u003C\u002Fstrong> field with the server in question, and include the plugin name, its version and the error shown in \u003Ccode>logs\u002Flatest.log\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cp>Your Minecraft server is ready for its first plugins 📦\u003C\u002Fp>\n",1794526353482]