Skip to main content

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.