# PVP Toggle<\/p>\n
A Paper 1.21 PVP toggle plugin: players choose whether to participate in PVP; admins can manage others\u2019 state. Supports Folia, LuckPerms, PlaceholderAPI, and per-world PVP state.<\/p>\n
—<\/p>\n
## Features<\/p>\n
– **Players**: `\/pvp` or `\/pvp on` \/ `off` \/ `toggle` to change your own PVP —<\/p>\n ## Commands<\/p>\n | Command | Description | Permission | —<\/p>\n ## Permissions<\/p>\n | Permission | Description | Default | —<\/p>\n ## config.yml<\/p>\n – **default-pvp**: Default PVP state for new or unknown players (true\/false) —<\/p>\n ## PlaceholderAPI<\/p>\n With PlaceholderAPI installed, these placeholders are registered (return values are configurable):<\/p>\n | Placeholder | Description | Default return values are `on` \/ `off`; change them with **placeholder-on** and **placeholder-off** in config.<\/p>\n —<\/p>\n ## Compatibility<\/p>\n – **Server**: Paper 1.21+ (or compatible forks) —<\/p>\n","protected":false},"excerpt":{"rendered":" A PVP toggle plugin: players choose whether to participate in PVP; admins can manage others\u2019 state. Supports Folia, LuckPerms, PlaceholderAPI, and per-world PVP state.<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"toggle-pvp","_minecraft_project_id":"CjxUOw85","_minecraft_author":"Dr_ach","_minecraft_license":"Apache-2.0","_minecraft_downloads":139,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"toggle-pvp.zip","_minecraft_size_bytes":35285,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T18:47:30.023698Z","_minecraft_date_created":"2026-02-11T01:04:23.163094Z","_minecraft_date_modified":"2026-02-11T09:36:16.988422Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/toggle-pvp","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-09T13:01:04+00:00","_minecraft_import_hash":"38c3a928cf56dad364140dde57449532","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[125,89,126,127,128,92],"mod_loader":[131,132,133],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-157357","mod","type-mod","status-publish","hentry","mod_category-folia","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-utility","mod_loader-folia","mod_loader-paper","mod_loader-purpur","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– **Admins**: `\/pvp on|off|toggle
\n– **Status**: `\/pvp status` for yourself, `\/pvp status
\n– **Reload**: `\/pvp reload` to reload config (with permission)
\n– **Per-world**: Optional separate PVP state per world
\n– **Debounced save**: Fewer disk writes
\n– **Cooldown**: Configurable cooldown after toggling your own PVP
\n– **Feedback**: Configurable sound, ActionBar, and Title on toggle
\n– **PlaceholderAPI**: Placeholders like `%pvptoggle_status%`
\n– **Folia**: Region-aware scheduling; async save so it doesn\u2019t block
\n– **LuckPerms**: Permissions handled by LuckPerms when installed<\/p>\n
\n|———|————–|————|
\n| `\/pvp` | Same as `\/pvp toggle`; toggles your PVP | pvptoggle.use |
\n| `\/pvp on` | Enable PVP for yourself | pvptoggle.use |
\n| `\/pvp off` | Disable PVP for yourself | pvptoggle.use |
\n| `\/pvp toggle` | Toggle your PVP | pvptoggle.use |
\n| `\/pvp status` | View your own PVP status | pvptoggle.use |
\n| `\/pvp status
\n| `\/pvp on|off|toggle
\n| `\/pvp reload` | Reload config.yml | pvptoggle.reload |<\/p>\n
\n|————|————–|———|
\n| `pvptoggle.use` | Use \/pvp, on\/off\/toggle, and \/pvp status (self) | true |
\n| `pvptoggle.admin` | Use \/pvp on|off|toggle
\n| `pvptoggle.reload` | Use \/pvp reload | op |
\n| `pvptoggle.status.other` | Use \/pvp status
\n– **persist-on-rejoin**: Whether to keep each player\u2019s choice when they rejoin
\n– **per-world**: Whether to store PVP state per world (separate per world)
\n– **save-debounce-seconds**: Debounce time in seconds before writing to disk; 0 = save every time
\n– **command-cooldown-seconds**: Cooldown in seconds after toggling your own PVP; 0 = no cooldown
\n– **toggle-feedback**: Feedback when toggling
\n – **play-sound**: Play a sound
\n – **sound**: Sound name (e.g. ENTITY_EXPERIENCE_ORB_PICKUP)
\n – **sound-volume** \/ **sound-pitch**: Volume and pitch
\n – **use-actionbar**: Show message in ActionBar
\n – **actionbar-message**: ActionBar text; `%status%` = on\/off
\n – **use-title**: Show title
\n – **title** \/ **subtitle**: Title and subtitle; `%status%` = on\/off
\n– **placeholder-on** \/ **placeholder-off**: Values returned by PlaceholderAPI placeholders
\n– **messages.***: All messages; supports `&` color codes and `%player%`, `%seconds%`, `%status%`<\/p>\n
\n|————-|————-|
\n| `%pvptoggle_status%` | Current player\u2019s PVP status (in that player\u2019s context) |
\n| `%pvptoggle_status_
\n– **Folia**: Supported (`folia-supported: true`); uses AsyncScheduler for saves
\n– **LuckPerms**: Soft dependency; permissions are managed by LuckPerms when present
\n– **PlaceholderAPI**: Soft dependency; placeholders are registered when present<\/p>\n