# ZPvPToggle<\/p>\n
A lightweight Minecraft plugin that allows players to toggle their PvP status on and off. Players can only engage in PvP when both parties have PvP enabled.<\/p>\n
\n
\n<\/p>\n
## Features<\/p>\n
– **Toggle PvP**: Players can enable or disable their PvP status
\n– **Visual Indicators**: Customizable particle rings show which players have PvP enabled
\n– **Cooldowns:** Configurable cooldown for toggling PvP after a player enters PvP combat.
\n– **Custom Indicators:** Players can choose their own indicators. Access to indicators is permission-based.
\n– **Admin Controls**: Staff can toggle PvP for other players
\n– **Fully Customizable**: All messages and particle effects can be configured
\n– **Folia Support**: Works with Folia server software
\n– **Permissions-Based**: Granular permission system for different commands
\n<\/p>\n
## Commands<\/p>\n
| Command | Description | Permission | ## Permissions<\/p>\n | Permission | Description | Default | ## Configuration<\/p>\n ### config.yml particle-indicator: ## Compatibility<\/p>\n – Paper 1.21+ ## Dependencies<\/p>\n – MCKotlin<\/p>\n ## Installation<\/p>\n 1. Download the latest version of ZPvPToggle from Modrinth. Zepsi’s PvPToggle. A simple PvP Toggle plugin. Let players choose if they want to be vulnerable to PvP.<\/p>\n","protected":false},"featured_media":174373,"template":"","meta":{"_minecraft_slug":"zpvptoggle","_minecraft_project_id":"cJxh7HS1","_minecraft_author":"ZepsiZola","_minecraft_license":"MIT","_minecraft_downloads":450,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"zpvptoggle.zip","_minecraft_size_bytes":1490180,"_minecraft_version_count":8,"_minecraft_updated_at":"2026-05-16T10:45:01.196337Z","_minecraft_date_created":"2025-04-18T02:22:29.783175Z","_minecraft_date_modified":"2025-09-30T11:57:47.445836Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/zpvptoggle","_minecraft_icon_attachment_id":174373,"_minecraft_imported_at":"2026-06-09T23:21:28+00:00","_minecraft_import_hash":"96929dc6907f0c1a5980809fdbaa8274","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,88,125,89,122,866,127,128,867,92],"mod_loader":[131,132,133],"minecraft_version":[59,36,60,93,94,101,102,62,37,73,74,38,78,79,80,81],"class_list":["post-174372","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-equipment","mod_category-folia","mod_category-game-mechanics","mod_category-magic","mod_category-minigame","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-utility","mod_loader-folia","mod_loader-paper","mod_loader-purpur","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","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"],"yoast_head":"\n
\n|———|————-|————|
\n| `\/pvp` | Toggle your PvP status | zpvptoggle.user |
\n| `\/pvp toggle` | Toggle your PvP status | zpvptoggle.user |
\n| `\/pvp on` | Enable your PvP status | zpvptoggle.user |
\n| `\/pvp off` | Disable your PvP status | zpvptoggle.user |
\n| `\/pvp hide` | Hide PvP particle indicators | zpvptoggle.user |
\n| `\/pvp show` | Show PvP particle indicators | zpvptoggle.user |
\n| `\/pvp indicator
\n| `\/pvp help` | Display the help message | zpvptoggle.user |
\n| `\/pvp reload` | Reload plugin configuration | zpvptoggle.admin |
\n| `\/pvp
\n| `\/pvp bypass
\n|————|————-|———|
\n| `zpvptoggle.user` | Allows players to toggle their own PvP status | true |
\n| `zpvptoggle.indicator.
\n| `zpvptoggle.admin` | Allows staff to toggle PvP status for other players | op |<\/p>\n
\n“`yaml
\n# Whether to disable PvP when a player dies
\ndisable-pvp-on-death: true
\n# Whether to show a warning message when a player first toggles PvP
\nwarning-message-enabled: true
\n# Whether to apply pvp-toggle protections to pets of players too
\nprotect-pets: true
\n# Duration of the cooldown for players toggling pvp or since their last pvp interaction
\npvp-cooldown: 10.0<\/p>\n
\n # Interval in ticks to show the ring of particles. 20 ticks = 1 second.
\n interval-ticks: 60
\n # Maximum distance (in blocks) at which players can see PvP indicators.
\n max-view-distance: 32
\n # The default indicator to use (must match one of the keys in the indicators section)
\n default-indicator: default
\n # Define multiple particle ring indicators
\n indicators:
\n # Default ring – red circle around feet
\n default:
\n type: REDSTONE
\n points: 32
\n random-particle-positions: false
\n radius: 0.8
\n y-offset: 0.1
\n interval: 5
\n random-offset-vertical: 0.0
\n random-offset-horizontal: 0.0
\n speed: 0.01
\n color: RED
\n dust-size: 1.0
\n“`<\/p>\n
\n– Folia-compatible
\n– Java 21+<\/p>\n
\n2. Download MCKotlin from Modrinth
\n3. Place the downloaded `.jar` files into your server’s `plugins\/` folder.
\n4. Restart your server.
\n5. Configure the plugin to your liking by editing the `.yml` files in the `plugins\/ZPvPtoggle\/` folder.<\/p>\n","protected":false},"excerpt":{"rendered":"