Skip to content
Back to the knowledge base

Installing plugins on a Minecraft server

Install a plugin with the panel's installer or upload it by hand, and check that it's made for the server's game version.

Plugins add new features to your server, such as land claims, an economy or ranks. They run only on the server, so players don't have to install anything.

Before you start

The client panel is available in Polish only, so its labels are given in Polish with a translation.

  • The server must run on an engine that supports plugins, such as Paper or Purpur. Vanilla, Fabric, Forge and NeoForge don't support them. Read more in Choosing a Minecraft server engine.
  • Check the server's game version. In the Konsola (Console) tab, type /version, and the server replies with it, such as 1.21.4.

Installing from the panel

The panel has a built-in installer that downloads plugins straight from Modrinth, SpigotMC and Hangar.

  1. Open the installer

    In the client panel, go to the Pluginy (Plugins) tab.

  2. Set the filters

    In Wersja (Version), choose the server's game version, and in Silnik serwera (Server engine), the engine the server runs on. In Platforma (Platform), choose the source, such as Modrinth.

  3. Find the plugin

    Type its name in the Szukaj pluginów (Search plugins) field.

  4. Check the plugin version

    Click Wersje (Versions) and make sure the list has a version of the plugin for the server's game version. The arrow icon opens the plugin's page, where you'll find its description and requirements.

  5. Install

    Click Zainstaluj (Install), then restart the server. The server loads new plugins only when it starts.

Uploading a plugin by hand

Use this method when the plugin isn't in the installer, such as a paid plugin bought on the author's website.

  1. Download the plugin

    Download the .jar file from a trusted source: Modrinth (opens in a new tab), Hangar (opens in a new tab) or SpigotMC (opens in a new tab). On the plugin's page, check that it supports the server's game version.

  2. Open the plugins folder

    In the client panel, go to the Pliki (Files) tab and open the plugins folder.

  3. Upload the file

    Click Wgraj plik (Upload file) and choose the downloaded .jar file.

  4. Restart the server

    The server loads new plugins only when it starts.

If you're uploading many plugins at once, it's faster over SFTP.

Checking the plugin

In the Konsola (Console) tab, type /plugins. Plugins listed in green are working, and those in red didn't load properly.

On its first start, a plugin creates its own folder in plugins with a config.yml file. That's where you change its settings. Restart the server after every change.

Don't use the /reload command to load plugins or their settings. It often breaks running plugins and causes errors.

Common problems

The plugin is red or isn't on the list

Check the console when the server starts and look for lines with the plugin's name. The most common causes are a plugin for a different game version or a missing plugin it depends on. The UnknownDependencyException error names the missing plugin. Install it the same way as the first.

“Unsupported API version” error

The plugin is made for a newer game version than the server's. Install an older version of the plugin (in the installer, through Wersje) or update the server.

The server has no plugins folder

The server runs on an engine without plugin support. Switch it to Paper or Purpur, as described in Choosing a Minecraft server engine.