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

Player Permissions

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)