Configuration
ConsentPVP is configured through plugins/ConsentPVP/config.yml. After editing, apply changes with /pvp reload — no restart required. The reload reapplies any missing default values, reloads settings, and updates player nametags.
All player-facing messages use MiniMessage formatting.
Default config.yml
pvp:
# If true, players will have their PVP consent disabled upon death.
disable-on-death: false
cooldown:
# Duration in minutes before a player can toggle PVP consent again
duration: 5
messages:
prefix: "<bold><gray>[<red>ConsentPVP<gray>]</bold> <white>"
# Where PvP denial messages should appear. Valid options: chat, action_bar
pvp_attempt_delivery: chat
# If true, both players are notified when a PvP attempt is denied.
notify-defender-on-denial: false
pvp_enabled: "<green>PVP consent enabled."
pvp_disabled: "<red>PVP consent disabled."
on_cooldown: "<red>You must wait %time% before toggling PVP again."
pvp_not_consented_attacker: "<red>You tried to hit %player% but PVP is not consented."
pvp_not_consented_attacker_anonymous: "<red>You tried to hit an anonymous player but PVP is not consented."
pvp_not_consented_defender: "<red>%player% tried to hit you but PVP is not consented."
pvp_not_consented_defender_anonymous: "<red>Anonymous tried attacking you but pvp is not consented."
pvp_not_consented_attacker_multiple: "<red>You tried to hit %players% but PVP is not consented."
no_permission: "<red>You don't have permission to use this command."
pvp_death_toggle: "<green>PVP disable on death is now %status%."
config_reloaded: "<green>ConsentPVP configuration reloaded."
pvp_disabled_on_death: "<red>Your PVP has been disabled due to your death."
pvp_status: "<white>Your PVP status is currently <green>%status%<white>."
bypass_cooldown_sender: "<green>Cleared PVP cooldown for %player%."
bypass_cooldown_target: "<green>Your PVP cooldown has been cleared by a staff member."
indicators:
# If true, a visual indicator will be shown above player's heads indicating their PVP status.
enabled: true
# If true, the plugin will force its own indicators even if it overwrites name tags from other plugins.
force: false
# The prefix shown for players with PVP enabled.
pvp-enabled-prefix: "<green>⚔ </green>"
# The prefix shown for players with PVP disabled.
pvp-disabled-prefix: "<red>⚔ </red>"
PvP
| Key | Default | Description |
|---|---|---|
pvp.disable-on-death | false | If true, a player's PvP consent is automatically disabled when they die. Can also be toggled live with /pvp death. |
Cooldown
| Key | Default | Description |
|---|---|---|
cooldown.duration | 5 | Number of minutes a player must wait before toggling PvP consent again. Prevents rapid toggling during combat. |
Indicators
Controls the optional visual nametag indicator shown above players to reflect PvP status. See Nametag Indicators for details.
| Key | Default | Description |
|---|---|---|
indicators.enabled | true | Turns PvP nametag indicators on or off. |
indicators.force | false | If true, ConsentPVP forces its own indicators even if doing so overwrites nametags set by other plugins. |
indicators.pvp-enabled-prefix | <green>⚔ </green> | The prefix shown for players with PvP enabled. |
indicators.pvp-disabled-prefix | <red>⚔ </red> | The prefix shown for players with PvP disabled. |
Messages
All player-facing messages live under messages and use MiniMessage formatting. The prefix is prepended to plugin messages.
| Key | Default | Purpose |
|---|---|---|
prefix | <bold><gray>[<red>ConsentPVP<gray>]</bold> <white> | Prepended to plugin messages. |
pvp_attempt_delivery | chat | Where PvP denial messages appear. Valid options: chat, action_bar. |
notify-defender-on-denial | false | If true, the defender is also notified when a blocked PvP attempt occurs. |
pvp_enabled | <green>PVP consent enabled. | Shown when a player enables consent. |
pvp_disabled | <red>PVP consent disabled. | Shown when a player disables consent. |
on_cooldown | <red>You must wait %time% before toggling PVP again. | Shown when a player toggles while on cooldown. |
pvp_not_consented_attacker | <red>You tried to hit %player% but PVP is not consented. | Shown to the attacker on a blocked single-target attack. |
pvp_not_consented_attacker_anonymous | <red>You tried to hit an anonymous player but PVP is not consented. | Attacker message when the target is anonymous/unknown. |
pvp_not_consented_defender | <red>%player% tried to hit you but PVP is not consented. | Shown to the defender when notify-defender-on-denial is enabled. |
pvp_not_consented_defender_anonymous | <red>Anonymous tried attacking you but pvp is not consented. | Defender message when the attacker is anonymous/unknown. |
pvp_not_consented_attacker_multiple | <red>You tried to hit %players% but PVP is not consented. | Attacker message for a multi-target (AoE) denial. |
no_permission | <red>You don't have permission to use this command. | Shown when a player lacks permission for a command. |
pvp_death_toggle | <green>PVP disable on death is now %status%. | Result of /pvp death. |
config_reloaded | <green>ConsentPVP configuration reloaded. | Result of /pvp reload. |
pvp_disabled_on_death | <red>Your PVP has been disabled due to your death. | Shown when disable-on-death resets a player's consent. |
pvp_status | <white>Your PVP status is currently <green>%status%<white>. | Result of /pvp / /pvp status. |
bypass_cooldown_sender | <green>Cleared PVP cooldown for %player%. | Shown to the admin who runs /pvp bypass. |
bypass_cooldown_target | <green>Your PVP cooldown has been cleared by a staff member. | Shown to the player whose cooldown was cleared. |
Message placeholders
| Placeholder | Used in | Meaning |
|---|---|---|
%time% | on_cooldown | Remaining cooldown before the player can toggle again. |
%player% | Single-target denial and bypass messages | The name of the other player involved. |
%players% | pvp_not_consented_attacker_multiple | The list of targets in a multi-target denial. |
%status% | pvp_death_toggle, pvp_status | The relevant status/toggle value. |
tip
If denial messages feel too noisy, set pvp_attempt_delivery: action_bar to move them out of chat, and keep notify-defender-on-denial: false so defenders aren't pinged on every blocked hit.
Example Configurations
Hardcore-ish: short cooldown, reset on death
pvp:
disable-on-death: true
cooldown:
duration: 1
Quiet denials via the action bar
messages:
pvp_attempt_delivery: action_bar
notify-defender-on-denial: false
Indicators off (avoiding nametag conflicts)
indicators:
enabled: false