PvPManager Plugin — Guide

Combat Mechanics

Combat Tagging

When a player attacks another player (or is attacked), they enter a 'Tagged' state. While tagged, players are restricted from performing certain actions to ensure the fight reaches a conclusion.

• Duration: Configurable timer (default is usually 10-20 seconds).
• Restrictions: Players cannot use prohibited commands (e.g., /tp, /home, /spawn) or fly while tagged.
• Visual Indicators: The plugin can display the remaining tag time via the Action Bar, Boss Bar, or chat messages.

Combat Logging

If a player leaves the server while tagged, they are considered to have 'Combat Logged.' The plugin can be configured to apply several punishments: * Instant Kill: The player is killed immediately upon logout. * Inventory Drop: The player's items are dropped at their logout location. * NPC Spawning (Premium): An NPC is spawned in the player's place. If the NPC is killed, the player dies and loses their items when they next log in. * Money Penalty: Deducts a percentage or fixed amount of currency via Vault integration.

Kill Abuse Prevention

To prevent players from farming kills, PvPManager tracks how many times a player kills the same victim. If a threshold is reached: * The killer may be kicked or banned. * The killer may stop receiving rewards/stats for kills on that specific player. * A command can be executed to punish the abuser.

Protection Systems

Newbie Protection

New players are automatically protected from PvP for a set amount of time (e.g., 60 minutes) upon their first join. This allows them to gather basic resources without being targeted by veteran players. * Automatic Expiration: The protection expires after the time limit is reached. * Manual Removal: Players can use /newbie disable to end their protection early if they wish to engage in PvP.

Respawn Protection

Prevents 'spawn killing' by granting a few seconds of invulnerability to players after they respawn. This protection is instantly cancelled if the player attacks someone else.

PvP Toggle

Players can control their own PvP status using the /pvp command. * Cooldowns: Prevents players from toggling PvP on and off rapidly during a chase. * Force PvP: Admins can force PvP to be enabled in specific worlds or for specific players.