Minecraft

How to Install and Configure PvPManager on a Minecraft Server

Minecraft·May 20, 2026·18 min read

PvPManager Overview

Running a Minecraft server with player combat sounds simple until someone logs out mid-fight, new players get deleted five seconds after joining, or protected areas start behaving differently than expected. PvPManager is a Spigot and Paper plugin built to give server owners better control over those situations.

It is especially useful for survival-based modes such as factions, prison, towny, or economy servers where player loot matters. Vanilla Minecraft does not give many tools for combat tagging, PvP toggles, or spawn protection, so a plugin fills the gap before your chat turns into a courtroom.

With PvPManager, you can add temporary protection for newcomers, prevent combat logging, display fight timers, customize death and warning messages, and tune how PvP works across the server. The setup is straightforward once your server is already running a plugin-compatible version such as Spigot or Paper.

Downloading PvPManager

Start by downloading the plugin file from its official CurseForge page.

  • Open the PvPManager page on CurseForge.
  • Select the Files tab near the top of the page.
  • Find a file that matches the Minecraft version used by your server.
  • Click the three-dot menu beside that file, then choose Download File.
  • Save the `.jar` file somewhere easy to find, such as your downloads folder or desktop.

Using the correct version matters. If the plugin was built for a much newer or older server version, it may fail to load or create errors during startup.

Installing PvPManager on the Server

PvPManager requires a server type that supports Bukkit-style plugins. Install Spigot, Paper, or another compatible fork before uploading the plugin. If the server is still using vanilla Minecraft, the `plugins` folder will not work for this setup.

Once the server software is ready, install the plugin with these steps:

  • Open your server panel.
  • Go to FTP or the file manager area.
  • Enter your panel password if prompted, then log in.
  • Open the `plugins` directory.
  • Click Upload.
  • Drag the PvPManager `.jar` file into the upload area.
  • Wait until the upload reaches 100 percent.
  • Return to the main server controls and restart the server.

After the restart, PvPManager should create its own folder inside `plugins`. That folder contains the configuration files used to adjust combat behavior.

First Steps In Game

When players join after installation, PvPManager begins using its default settings immediately. These defaults are usually enough to confirm the plugin is working, but most servers will want to customize them before opening PvP to everyone.

Server operators can manage the plugin with commands. If you prefer rank-based access, use a permissions plugin such as LuckPerms and assign the relevant PvPManager permissions to staff, moderators, or regular players.

Typical features include new player protection, combat tagging, boss bars or timers during fights, custom messages, blood effects, PvP toggles, and admin bypass options. The defaults are practical, but the configuration file is where the plugin becomes useful for your specific game mode.

Default Combat Behavior

By default, new players receive a welcome message and temporary PvP protection when they first enter the server. The standard protection window is five minutes, giving them time to read chat, move around, and avoid being instantly farmed for starter items.

That protection can usually be removed by the player with a command, depending on your configuration. Server owners can also disable or change the feature in the config if their game mode does not need newcomer protection.

During combat, PvPManager marks players as tagged. A visible timer appears, and the tag is refreshed whenever another hit lands. The default combat timer is short, commonly around 10 seconds, but it is enough to stop most quick logout attempts. If a tagged player leaves, PvPManager can punish the logout based on your settings.

The plugin may also show blood effects or warning messages when hits connect. These small details help players understand when they are considered in combat. If the effects are too noisy for your server, they can be disabled in the configuration.

Useful Commands and Permissions

PvPManager includes many commands, so the official wiki is the best place for a full reference. For most servers, the important part is understanding the main permission groups.

  • `pvpmanager.admin` gives access to administrative controls and management commands.
  • `pvpmanager.exempt` allows a player to bypass selected plugin features, useful for staff or special roles.
  • `pvpmanager.user` covers normal player features such as basic PvP controls, depending on your setup.

These permissions are commonly assigned through LuckPerms or another permissions manager. Keep admin and exempt permissions limited to trusted ranks, since they can change how combat rules apply.

Editing the PvPManager Configuration

To customize PvPManager, open your server files and go to:

`/plugins/PvPManager`

Inside that folder, you will find files such as `config.yml` for core settings and `messages.properties` for plugin text. The exact files can vary by plugin version, but the main configuration file controls the combat timer, protections, toggles, effects, and logging behavior.

Open the file in your panel editor, adjust the values you need, then save your changes. After saving, either restart the server or run:

`/pvpmanager reload`

A restart is usually the cleanest option after larger changes. Reloading is faster for message edits or small setting adjustments, but always check the console afterward for errors caused by spacing or invalid YAML values.

Common PvPManager Issues

If PvPManager does not appear to load, first confirm the server is running Spigot, Paper, or a compatible plugin server type. Then check that the `.jar` file was uploaded directly into the `plugins` folder, not into a subfolder or the main server directory.

If protected players can still be attacked, check for admin override commands such as `/pvpoverride` or `/pvpo`. Staff using override mode may ignore normal PvP status checks.

WorldGuard can also affect combat behavior. PvPManager has compatibility with region protection plugins, but some settings allow tagged players to keep fighting even in protected areas. Look for the `Vulnerable` option in the PvPManager configuration. Setting it to `False` can stop tagged players from fighting through protections created by other plugins.

Helpful Resources

  • PvPManager on CurseForge
  • Official PvPManager wiki
  • How to add plugins to a Minecraft server
  • How to use your server FTP file manager

Still have questions?

Come chat with us and we will get back to you as soon as possible!

Contact Support