ZPvPToggle

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.

Features

• Toggle PvP: Players can enable or disable their PvP status
• Visual Indicators: Customizable particle rings show which players have PvP enabled
• Cooldowns: Configurable cooldown for toggling PvP after a player enters PvP combat.
• Custom Indicators: Players can choose their own indicators. Access to indicators is permission-based.
• Admin Controls: Staff can toggle PvP for other players
• Fully Customizable: All messages and particle effects can be configured
• Folia Support: Works with Folia server software
• Permissions-Based: Granular permission system for different commands

Commands

Permissions

Configuration

config.yml

# Whether to disable PvP when a player dies
disable-pvp-on-death: true
# Whether to show a warning message when a player first toggles PvP
warning-message-enabled: true
# Whether to apply pvp-toggle protections to pets of players too
protect-pets: true
# Duration of the cooldown for players toggling pvp or since their last pvp interaction
pvp-cooldown: 10.0

particle-indicator:
  # Interval in ticks to show the ring of particles. 20 ticks = 1 second.
  interval-ticks: 60
  # Maximum distance (in blocks) at which players can see PvP indicators.
  max-view-distance: 32
  # The default indicator to use (must match one of the keys in the indicators section)
  default-indicator: default
  # Define multiple particle ring indicators
  indicators:
    # Default ring - red circle around feet
    default: 
      type: REDSTONE
      points: 32
      random-particle-positions: false
      radius: 0.8
      y-offset: 0.1
      interval: 5
      random-offset-vertical: 0.0
      random-offset-horizontal: 0.0
      speed: 0.01
      color: RED
      dust-size: 1.0

Compatibility

• Paper 1.21+
• Folia-compatible
• Java 21+

Dependencies

• MCKotlin

Installation

1. Download the latest version of ZPvPToggle from Modrinth.
2. Download MCKotlin from Modrinth
3. Place the downloaded .jar files into your server's plugins/ folder.
4. Restart your server.
5. Configure the plugin to your liking by editing the .yml files in the plugins/ZPvPtoggle/ folder.