Troubleshooting & FAQ

Troubleshooting

PvP doesn't work

PvP is consensual and mutual. Both players must run /pvp enable — if either has it disabled, the attack is blocked. By default, every player starts with PvP disabled.

I can't toggle PvP

You may be on cooldown. After enabling or disabling PvP you must wait cooldown.duration minutes (default 5) before toggling again. The on_cooldown message shows the remaining time. An admin can clear it with /pvp bypass <player>.

Messages aren't showing correctly

All messages use MiniMessage formatting. Check your config.yml for invalid MiniMessage syntax (mismatched or malformed tags) in the message you're editing.

Nametags conflict with another plugin

Indicators can clash with scoreboard, team, tab, or nametag plugins. Either set indicators.enabled: false, or avoid indicators.force: true so ConsentPVP yields to the other plugin. See Nametag Indicators.

Config changes didn't apply

Run /pvp reload after editing config.yml, or restart the server. The reload also reapplies any missing default values.

A player's PvP reset after death

This is expected when pvp.disable-on-death is enabled — a player's consent is automatically disabled when they die, and they're notified with pvp_disabled_on_death. Check pvp.disable-on-death (or toggle it with /pvp death).

FAQ

Do players have PvP on by default?

No. By default, players do not have PvP consent enabled. The server is peaceful until both players opt in with /pvp enable.

Does ConsentPVP block more than melee?

Yes. It blocks a wide range of direct and indirect PvP — projectiles, TNT, end crystals, splash and lingering potions, explosions, player-placed lava and fire, respawn-anchor misuse, knockback/push effects, sweep and mace AoE, and more. See PvP Protections.

In plugins/ConsentPVP/playerdata.yml, keyed by player UUID. It's loaded on join, saved on quit, and saved immediately whenever a player toggles. See Player Data.

Can staff in vanish still hurt players?

No. Attacks from vanished players are silently blocked using Bukkit's hidePlayer checks and common vanished metadata.

How do I make denial messages less noisy?

Set pvp_attempt_delivery: action_bar to move denials out of chat, and leave notify-defender-on-denial: false so defenders aren't pinged on every blocked hit.

How do I reset a player's cooldown?

An admin can run /pvp bypass <player> (requires consentpvp.admin) to clear that player's toggle cooldown immediately.