Developer API

Maven details

Maven Repo:

<repository>
<id>CodeMC</id>
<url>https://repo.codemc.org/repository/maven-public/</url>
</repository>

Artifact Information:

<dependency>
<groupId>me.chancesd.pvpmanager</groupId>
<artifactId>pvpmanager</artifactId>
<version>4.0.4</version>
<scope>provided</scope>
</dependency>

Get a CombatPlayer

In most cases you will need a CombatPlayer instance. The static CombatPlayer.get() method should be preferred for compatibility with both the premium and free versions.

PvPManagerpvpmanager;
// Check if PvPManager is enabled if (Bukkit.getPluginManager().isPluginEnabled("PvPManager"))
pvpmanager = (PvPManager) Bukkit.getPluginManager().getPlugin("PvPManager");
if (pvpmanager == null)
return;
Playerplayer = Bukkit.getPlayerExact("ChanceSD");
// You can get a CombatPlayer either through the playerManager or directly with the static get methodCombatPlayercombatPlayer = CombatPlayer.get(player);
CombatPlayercombatPlayer = pvpmanager.getPlayerManager().get(player);
// Let's say we want to know if the player has newbie protection or is taggedif (combatPlayer.isNewbie())
combatPlayer.message("You are a newbie!");
if (combatPlayer.isInCombat())
combatPlayer.message("You are in combat!");

Check if two players can PvP

CombatPlayercombatPlayer = CombatPlayer.get(player);
// You can check each individual protection like thisif (combatPlayer.hasRespawnProtection())
combatPlayer.message("You can't be attacked");
// Or ideally, what you probably want is to check if there's any protections at all// This returns a boolean, true if the two players can attack each other, false otherwisebooleancanAttack = pvpmanager.getPlayerManager().canAttack(Playerattacker, Playerdefender);
// This returns a ProtectionResult with the reason why the attack was blockedProtectionResultresult = pvpmanager.getPlayerManager().checkProtection(Playerattacker, Playerdefender);
if (result.isProtected())
// One of the players is protected, attack should be cancelledif (result.type() == ProtectionType.NEWBIE)
// Specifically blocked due to newbie protection// You can also check if they can attack (opposite of isProtected)if (result.isVulnerable())
// Players can attack each other

Additionally, there are events you can listen to, see below for a list.

PvPManager Events

There are some PvPManager events you can listen to. You can find a current list here
At the time of writing these are the existing events:

• PlayerTagEvent
• PlayerUntagEvent
• PlayerCombatLogEvent
• PlayerTogglePvPEvent
• NewbieProtectionEvent

You can listen to them as you would any other Bukkit event.
Feel free to suggest more events or improvements to them.

Combat Log NPCs

The premium version of PvPManager spawns NPCs on combat log instead of killing on logout.
For the convenience of other plugins that need to check for this, they have a few metadata values.

Playerplayer;
if (player.hasMetadata("NPC"))
// Easy check if you need to ignore Player NPCs, Citizens also uses this afaikif (player.hasMetadata("combat_log_npc"))
// Specific check for PvPManager combat log NPCs// If the player is a combat log NPC, you can get the original player's UUID (the one that logged out) like thisUUIDplayerUUID = (UUID) player.getMetadata("combat_log_npc").get(0).value();

Pull Requests are always welcome if you have anything you would like added or fixed.
If you have questions, feel free to ask in discord or in the Spigot/Bukkit thread.