Commands
ConsentPVP's only command is /pvp. With no arguments it shows the player's current PvP status; subcommands let players toggle their consent and let admins manage cooldowns, death behaviour, and the configuration.
| Command | Description | Permission |
|---|---|---|
/pvp | Shows the player's current PvP status. | consentpvp.use |
/pvp status | Shows the player's current PvP status. | consentpvp.use |
/pvp enable | Enables PvP consent for the player. Subject to the configured cooldown. | consentpvp.use |
/pvp disable | Disables PvP consent for the player. Subject to the configured cooldown. | consentpvp.use |
/pvp bypass <player> | Admin. Clears the target player's PvP toggle cooldown. | consentpvp.admin |
/pvp death | Admin. Toggles whether PvP consent is disabled when a player dies, saving the setting to config.yml. | consentpvp.admin |
/pvp reload | Admin. Reloads the plugin configuration. | consentpvp.admin |
Command Notes
/pvp and /pvp status
Both display the player's current PvP consent status. Players start with consent disabled by default.
/pvp enable / /pvp disable
Turns the player's own PvP consent on or off. Both are subject to the configured cooldown (cooldown.duration), which prevents players from rapidly toggling PvP during combat. While on cooldown, the player receives the on_cooldown message showing how long they must wait.
/pvp bypass <player>
An admin command that clears the target player's PvP toggle cooldown, letting them toggle again immediately. The sender is notified with bypass_cooldown_sender, and the target with bypass_cooldown_target. Requires consentpvp.admin.
/pvp death
An admin command that toggles the pvp.disable-on-death behaviour on or off. The new value is saved to config.yml, and the result is reported with the pvp_death_toggle message. Requires consentpvp.admin.
/pvp reload
An admin command that reloads the plugin configuration. It reapplies default config values if any are missing, reloads settings, and updates player nametags. Requires consentpvp.admin.
Tab Completion
- The first argument suggests:
enable,disable,bypass,death,status,reload. /pvp bypasssuggests online player names — only for users withconsentpvp.admin.