PVP Toggle

Minecraft 版本： 1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11 26.1 26.1.1 26.1.2 26.2

平台： folia paper purpur spigot

标签： game-mechanics management utility

PVP Toggle

A 1.20+ PVP toggle plugin: players choose whether to participate in PVP; admins can manage others’ state. Supports Folia, LuckPerms, PlaceholderAPI, and per-world PVP state.

Features

• Players: /pvp or /pvp on / off / toggle to change your own PVP
• Admins: /pvp on|off|toggle <player> to manage someone else’s PVP
• Status: /pvp status for yourself, /pvp status <player> for others (with permission)
• Reload: /pvp reload to reload config (with permission)
• Per-world: Optional separate PVP state per world
• Debounced save: Fewer disk writes
• Cooldown: Configurable cooldown after toggling your own PVP
• Feedback: Configurable sound, ActionBar, and Title on toggle
• PlaceholderAPI: Placeholders like %pvptoggle_status%
• Folia: Region-aware scheduling; async save so it doesn’t block
• LuckPerms: Permissions handled by LuckPerms when installed

Commands

Permissions

config.yml

• default-pvp: Default PVP state for new or unknown players (true/false)
• persist-on-rejoin: Whether to keep each player’s choice when they rejoin
• per-world: Whether to store PVP state per world (separate per world)
• save-debounce-seconds: Debounce time in seconds before writing to disk; 0 = save every time
• command-cooldown-seconds: Cooldown in seconds after toggling your own PVP; 0 = no cooldown
• toggle-feedback: Feedback when toggling
  • play-sound: Play a sound
  • sound: Sound name (e.g. ENTITY_EXPERIENCE_ORB_PICKUP)
  • sound-volume / sound-pitch: Volume and pitch
  • use-actionbar: Show message in ActionBar
  • actionbar-message: ActionBar text; %status% = on/off
  • use-title: Show title
  • title / subtitle: Title and subtitle; %status% = on/off
• placeholder-on / placeholder-off: Values returned by PlaceholderAPI placeholders
• **messages.***: All messages; supports & color codes and %player%, %seconds%, %status%

PlaceholderAPI

With PlaceholderAPI installed, these placeholders are registered (return values are configurable):

Default return values are on / off; change them with placeholder-on and placeholder-off in config.

Compatibility

• Server: Paper 1.21+ (or compatible forks)
• Folia: Supported (folia-supported: true); uses AsyncScheduler for saves
• LuckPerms: Soft dependency; permissions are managed by LuckPerms when present
• PlaceholderAPI: Soft dependency; placeholders are registered when present