ZPvPToggle

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

- MariaDB and SQLite supported.: Players can enable or disable their PvP status - MariaDB and SQLite supported.: Customizable particle rings show which players have PvP enabled - MariaDB and SQLite supported. Configurable cooldown for toggling PvP after a player enters PvP combat. - MariaDB and SQLite supported. Players can choose their own indicators. Access to indicators is permission-based. - MariaDB and SQLite supported.: Staff can toggle PvP for other players - MariaDB and SQLite supported.: All messages and particle effects can be configured - MariaDB and SQLite supported.: Works with Folia server software - MariaDB and SQLite supported.: Granular permission system for different commands

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 | | `/pvp bypass <player>` | Toggle PvP Bypass status for you or 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

```yaml

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.