PvP Toggle is a lightweight Minecraft mod that lets players enable or disable their PvP status using simple commands. It is designed for servers that want controlled PvP, player protection, and clear visual feedback without adding unnecessary complexity.

Players can toggle PvP, block PvP with specific players, check their current status, and see whether other players are attackable through small nametag icons.

Designed for Minecraft 1.21.1 using the NeoForge mod loader.

Features

• Toggle PvP on or off with simple player commands.
• Configurable delay before PvP protection becomes active.
• Block or unblock PvP with specific players.
• Visual nametag icons showing whether a player can be attacked.
• Optional protection against knockback and player pushing.
• Admin commands for forcing PvP on or off for players.
• Configurable action messages for blocked PvP interactions.
• Simple Voice Chat support: PvP icons automatically move to avoid overlapping voice chat icons.
• Persistent PvP data stored per world/server.

Icons

PvP Toggle includes small nametag icons to show the PvP state of nearby players:

• PvP On – The player can be attacked.
• PvP Off – PvP against this player is blocked.

Commands

• /pvp off – Disables PvP after the configured delay.
• /pvp on – Enables PvP again.
• /pvp block <player> – Blocks PvP between you and another player.
• /pvp unblock <player> – Allows PvP with a previously blocked player again.
• /pvp status – Shows your current PvP status.
• /pvp help – Shows available PvP commands.

Admin Commands

• /pvpadmin forceoff <player> – Forces PvP off for a player.
• /pvpadmin forceon <player> – Forces PvP on for a player.
• /pvpadmin reload – Reloads stored PvP data.

Configuration

PvP Toggle includes server-side configuration options for controlling how PvP protection behaves:

• one-sided-toggle – If enabled, /pvp off only protects the player from incoming PvP.
• take-effect-time – Delay in minutes before /pvp off becomes active.
• cancel-pending-off-on-attack – Cancels pending PvP protection if the player attacks another player.
• send-action-messages – Sends chat messages when PvP actions are blocked.
• block-knockback – Also blocks knockback from PvP interactions.
• block-player-pushing – Prevents protected players from being pushed by other players.

Simple Voice Chat Support

PvP Toggle is compatible with Simple Voice Chat. When Simple Voice Chat nametag icons are visible, PvP Toggle automatically shifts its icons to the side to prevent overlap. If voice chat icons are hidden, the PvP icons move back to their normal position.

License

Licensed under the MIT License.
You may freely use, modify, and redistribute this software under the terms of the MIT License.

Credits

• Development and design by DerErneuerer
• Created for the Brassworks SMP

Links

• Project Repository: PvP Toggle on GitHub
• Brassworks SMP: brassworks.opnsoc.org
• Simple Voice Chat: Simple Voice Chat on Modrinth