Advanced PvP Toggle
No reviews yet
A simple mod that lets players toggle PvP protection with commands and status icons, made for public servers.
Neoforge is a fork of the Minecraft Forge available for versions 1.20.1+ of Minecraft. Many Forge mods are compatible with Neoforge and vice versa.
Community voices
Reviews
Click once to include, again to exclude, again to clear
No reviews yet. Be the first to review this project!
Get it on
Available Platforms
Modrinth
Compatibility
Supported Environments
About
Project Details
For authors
Embed Badge
If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.
Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.
Identifiers
Platform IDs
About
Description
PvP Toggle
Controlled player-versus-player combat for NeoForge servers.
PvP Toggle is a lightweight Minecraft mod that gives players control over their PvP status without adding unnecessary complexity. Players can enable or disable PvP, manage exceptions for individual players, and immediately see who can be attacked through compact nametag icons.
The mod is designed for Minecraft 1.21.1 with NeoForge. All core functionality is server-controlled and remains available through commands. The graphical BrassUI management menu is entirely optional.
Features
- Enable or disable PvP with simple commands.
- Configurable delay before PvP protection becomes active.
- Block or allow PvP with individual players.
- Small nametag icons showing whether another player can be attacked.
- Optional protection against knockback-only attacks and player pushing.
- Administrative commands for forcing player PvP states.
- Configurable feedback when a protected interaction is blocked.
- Persistent PvP data stored separately for each world or server.
- Simple Voice Chat integration that prevents nametag icons from overlapping.
- Optional BrassUI management menu with no required server-side UI dependency.
- Compatibility with legacy PvP Toggle clients using the original icon protocol.
Optional PvP Management Menu
Run /pvp menu to open the optional BrassUI management screen.
The menu:
For the UI a compatible KotlinForForge installation are required only on clients that want to use this menu. If they are missing, /pvp menu displays an availability message while every regular PvP command continues to work.
Icons
PvP Toggle renders small icons beside player nametags:
PvP On — The player can be attacked.
PvP Off — PvP against the player is blocked.
Player Commands
| Command | Description |
|---|---|
/pvp on |
Enables PvP immediately. |
/pvp off |
Disables PvP after the configured delay. |
/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 menu |
Opens the optional BrassUI management menu. |
/pvp help |
Lists the available PvP commands. |
Admin Commands
Administrative commands require permission level 2.
| Command | Description |
|---|---|
/pvpadmin forceon <player> |
Forces PvP on for a player. |
/pvpadmin forceoff <player> |
Forces PvP off for a player. |
/pvpadmin reload |
Reloads the stored PvP data. |
Configuration
PvP Toggle creates a server-side configuration for controlling protection behavior.
| Option | Description | Default |
|---|---|---|
one-sided-toggle |
Only protects the player from incoming PvP when /pvp off is active. |
false |
take-effect-time |
Delay in minutes before /pvp off becomes active. |
10 |
cancel-pending-off-on-attack |
Cancels pending protection when the player attacks another player. | true |
send-action-messages |
Sends feedback when PvP damage, knockback, or pushing is blocked. | false |
block-knockback |
Blocks knockback-only weapons and effects during protected interactions. | true |
block-player-pushing |
Prevents protected players from being physically pushed by other players. | true |
Installation
Server
- Install NeoForge for Minecraft 1.21.1.
- Place PvP Toggle in the server's
modsdirectory. - Start the server once to generate the configuration.
KotlinForForge is not required on the server.
Client
Install PvP Toggle on the client to display nametag icons.
To use the graphical management menu, additionally install:
- BrassUI (Automatically included in the Mod)
- A compatible KotlinForForge version
Clients without PvP Toggle or without the optional UI dependencies may still connect because the network channels are optional. Legacy clients using protocol version 1 retain icon support.
Simple Voice Chat Support
When Simple Voice Chat nametag icons are visible, PvP Toggle automatically moves its icons to prevent overlap. The PvP icons return to their normal position when voice chat icons are hidden. Simple Voice Chat remains optional.
License
PvP Toggle is licensed under the MIT License. You may use, modify, and redistribute the software under the terms of that license.
Credits
- Development and design by DerErneuerer
- Created for Brassworks SMP
Links
Screenshots
Gallery
Versions
Files
Relations
Project Relations
More like this
Similar Mods
Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.
On ModDex
Community snapshot
By the numbers
Statistics
Want to reach Minecraft players?
We're looking for a server hosting partner to feature here and other parts of the site. Interested? Send us a message!
Get in touchGet it on
Available Platforms
On ModDex
Community snapshot
By the numbers