Skip to main content

Admin & Maintenance

ConsentPVP ships with a focused set of admin tools, all gated behind the consentpvp.admin permission.

Clearing a Cooldown​

/pvp bypass <player>

Clears the target player's PvP toggle cooldown so they can toggle again immediately. The admin sees bypass_cooldown_sender; the target sees bypass_cooldown_target. Requires consentpvp.admin.

Toggling Disable-on-Death​

/pvp death

Toggles the pvp.disable-on-death behaviour on or off and saves the new value to config.yml. The result is reported with pvp_death_toggle. Requires consentpvp.admin.

Reloading Configuration​

/pvp reload

Reloads the plugin configuration without restarting the server. It reapplies default config values if any are missing, reloads settings, and updates player nametags. Requires consentpvp.admin.

Operational Notes​

  • Admin access — consentpvp.admin is required for /pvp bypass, /pvp death, and /pvp reload.
  • Why the cooldown exists — the toggle cooldown (cooldown.duration) prevents players from rapidly flipping PvP on and off during combat. Use /pvp bypass only when you genuinely need to override it.
  • Nametag conflicts — indicators may clash with scoreboard, team, tab, or other nametag plugins. Use indicators.force deliberately, or disable indicators entirely. See Nametag Indicators.
  • Noisy denials — if PvP denial messages are too noisy, switch pvp_attempt_delivery to action_bar and keep notify-defender-on-denial: false.
  • Unexpected blocks — if players report PvP being blocked unexpectedly, confirm that both players have PvP enabled. Protection is mutual by design.

Maintenance Checklist​

TaskHow
Apply config changes/pvp reload
Clear a stuck cooldown/pvp bypass <player>
Flip disable-on-death/pvp death
Back up consent dataCopy plugins/ConsentPVP/playerdata.yml (server stopped)