?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacks
Settings
ZPvPToggle

ZPvPToggle

Zepsi's PvPToggle. A simple PvP Toggle plugin. Let players choose if they want to be vulnerable to PvP.

13
0

Compatibility

Minecraft: Java Edition

1.21.x
1.20.x

Platforms

75% of ad revenue goes to creators

Support creators and Modrinth ad-free with Modrinth+

Links

View source

Creators

ZepsiZola
ZepsiZola Member

Details

Licensed MIT
Published last week
Updated yesterday

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.

ZPvPToggle API Version Folia Support

Features

  • Toggle PvP: Players can enable or disable their PvP status
  • Visual Indicators: Customizable particle rings show which players have PvP enabled
  • 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
  • MariaDB and SQLite supported.

Commands

Command Description Permission
/pvp Toggle your PvP status zpvptoggle.user
/pvp toggle Toggle your PvP status zpvptoggle.user
/pvp on Enable your PvP status zpvptoggle.user
/pvp off Disable your PvP status zpvptoggle.user
/pvp hide Hide PvP particle indicators zpvptoggle.user
/pvp show Show PvP particle indicators zpvptoggle.user
/pvp indicator <indicator> Change your PvP indicator zpvptoggle.indicator.<indicator>
/pvp help Display the help message zpvptoggle.user
/pvp reload Reload plugin configuration zpvptoggle.admin
/pvp <player> Toggle PvP for another player zpvptoggle.admin

Permissions

Permission Description Default
zpvptoggle.user Allows players to toggle their own PvP status true
zpvptoggle.indicator.<indicator> Give access to specific indicators. multiple
zpvptoggle.admin Allows staff to toggle PvP status for other players op

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

# Database configuration
database:
  # Whether to use MariaDB/MySQL instead of SQLite
  use-mariadb: false
  # MariaDB/MySQL connection settings (only used if use-mariadb is true)
  mariadb:
    host: localhost
    port: 3306
    database: minecraft
    username: root
    password: ""

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

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.