PvPToggle

Like this plugin? Use code jack in the Hytale Store

PvP Toggle gives players control over their PvP status. Players can choose to opt-in or opt-out of player combat, with configurable combat timers and cooldowns to prevent abuse.

Features

Per-player PvP toggle - Each player can independently enable or disable their PvP status

Combat protection - Players cannot toggle PvP while actively in combat

Toggle cooldown - Configurable cooldown between PvP state changes

Item protection - Disable item drop/durability loss

Persistent state - Optionally save PvP status across server restarts

Admin controls - Server administrators can view and modify all plugin settings in-game

Knockback prevention - Prevent players from being pushed by others while their PvP is disabled.

Requirements

This plugin requires PvP to be enabled in the world configuration. If the world has PvP disabled, this plugin will have no effect as all player damage is already blocked at the world level.

Commands

Player Commands:

/pvp on - Enable PvP for yourself

/pvp off - Disable PvP for yourself

/pvp status - Check your current PvP status, combat timer, and cooldown

/pvp toggle - Toggle your PvP status off/on

Admin Commands:

/pvp admin config - Display current plugin configuration

/pvp admin set <key> <value> - Modify a configuration value

Configuration

All settings can be modified in-game using /pvp admin set:

combattimer - How long (in seconds) after taking/dealing PvP damage before you can toggle (0 to disable)

cooldown - How long (in seconds) between PvP toggles (0 to disable)

default - Default PvP state for new players (true/false)

persist - Whether PvP state persists across restarts (true/false, requires restart)

itemprotection - Keep items and durability on PvP death (true/false)

knockback - Whether players with PvP disabled still receive knockback from other players (true/false)

How It Works

When a player has PvP disabled, they cannot damage other players and cannot be damaged by other players. If either the attacker or the target has PvP disabled, no damage is dealt.

The combat timer prevents players from disabling PvP mid-fight to escape. After engaging in PvP combat, players must wait for the combat timer to expire before they can change their PvP status.

Permissions

All players can use /pvp on, /pvp off, /pvp toggle and /pvp status

Admin commands require Creative mode permissions

Permissions for LuckPerms users

User permissions:

jack.pvptoggle.command.pvp

jack.pvptoggle.command.pvp.on

jack.pvptoggle.command.pvp.off

jack.pvptoggle.command.pvp.status

jack.pvptoggle.command.pvp.toggle

Admin permissions:

jack.pvptoggle.command.pvp.admin

jack.pvptoggle.command.pvp.admin.config

jack.pvptoggle.command.pvp.admin.set

Compatibility issues

The item protection feature might conflict with some gravestone mods (Can be turned off)