
Modrinth · Minecraft mod
PvP Toggle
Combat flagging and persistent PvP preferences to pet protection and more!
Quick answer
Which PvP Toggle release should I use?
PvP Toggle 1.6.1+26.2 targets 26.2 with Fabric. Do not install it on the client. It must be installed on the dedicated server. All 1 required mods have matching files.
Where it goes
Is PvP Toggle required on the client, server, or both?
Do not install it on the client. It must be installed on the dedicated server.
This file is marked server-only.
What else does PvP Toggle 1.6.1+26.2 need?
1.6.1+26.2. Change the file and its required mods may change too.
Install Fabric API first. We found matching files for this game-version and loader setup.
We only count dependency files that match this setup. A file for another loader does not fill the gap.
Before you install it
Add PvP Toggle without breaking your instance.
Built for PvP Toggle 1.6.1+26.2. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use 1.6.1+26.2. It targets 26.2 with Fabric; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
Install Fabric API first. We found matching files for this game-version and loader setup.
- 03
Put it on the correct side
Do not install it on the client. It must be installed on the dedicated server.
- 04
Pick the file you checked
Use the “Get this file” button beside 1.6.1+26.2. It opens that exact file at the source.
About this project
What does PvP Toggle add?
A mod that lets players toggle PvP individually, while offering some neat extra features that I reckon you may find useful. I am also aware that quite a few mods do something similar, but I felt like I could make something beyond a simple toggle.
- PvP preferences: Players choose whether to disable or enable PvP for themselves
- Colored name tags: Uses vanilla's teams to show off players' PvP states
- Combat flagging: While flagged, toggling is disabled, and disconnecting for any reason while it's active will result in being immediately killed
- Global PvP: Force PvP on or off for all players server-wide; this takes priority over everything else
- Pet protect: Protect all tamed mobs from players whose PvP is off (the pet owner’s PvP state is not factored in).
- Forced PvP in other dimensions: You can force PvP in specific dimensions
- LuckPerms support: Allows you to customize accessibility to things
- Configurability: Some stuff can be configured; for info on what is configurable, go down to the configuration section
This mod ignores the
pvpsetting inserver.properties. Stick to the newest versions of the mod, as older versions may have bugs or lack features as my work is not perfect. Make sure to look at the dependencies section as well.
- Fabric API
- LuckPerms (Optional if you don't care about customizing permissions).
Spoiler
| Command | Description | Permission Node |
|---|---|---|
/pvp |
Toggles your PvP on or off. | pvptoggle.player.toggle |
/pvp <player> |
Change a player's PvP preference. | pvptoggle.op.other.toggle |
/pvp <player> timeout <duration> |
Prevent a player from toggling for a specified duration (in seconds). | pvptoggle.op.other.timeout |
/pvp status |
Displays your current PvP status. | pvptoggle.player.status |
/pvp status <player> |
View a detailed info list about a player's PvP state. | pvptoggle.op.other.status |
/pvp status flag |
Toggle displaying your PvP flag timer on or off. | pvptoggle.player.status |
/pvp global <state> <shouldBroadcast> |
Set the global PvP state to on, off, or neutral. The <shouldBroadcast> argument (true or false) is for whether to announce it or not. |
pvptoggle.op.global |
/pvp reload |
Reloads the configuration file. | pvptoggle.op.reload |
There's also the pvptoggle.op.exempt permission node that marks you as immune against penalties such as being flagged, being put on cooldown, etc.
Once again, as was said in the dependencies section, you can completely ignore permission nodes if you do not care for customizing them via another mod like LuckPerms.
All nodes labeled as "player" are available to everyone by default, while ones labeled as "op" are available to anyone with an operator permission level of 2 or higher.
Spoiler
Configuration file path: config/pvptoggle/pvp-toggle.json (Generated on launch).
{
// WARNING: DO NOT COPY THIS EXAMPLE JSON
// Cooldown for toggling
"toggle_cooldown": 120.0,
// How long one is flagged for after engaging in combat
"combat_flag_duration": 60.0,
// Default PvP preference for new players
"default_pvp_preference": true,
// Console feedback
"broadcast_to_other_ops": false,
// These should be self-explanatory
"punish_combat_log": true,
"protect_tameables": true,
"force_pvp_in_other_dimensions": false,
"team_colors": true,
"prevent_item_pickup_when_pvp_off": false,
"forced_pvp_in_other_dimensions": {
"minecraft:overworld": false,
"minecraft:the_nether": false,
"minecraft:the_end": false
},
/* For example, putting "tpa" in the list of commands to blacklist will blacklist any command with the word "tpa" in it.
You are also able to blacklist specific commands such as "tpaaccept" without outright blacklisting every related command */
"blacklisted_commands_when_flagged": [
"tpa",
"home"
]
}
Every setting is a boolean value (true/false) besides toggle_cooldown and combat_flag_duration, which are floats that start from 0.0 to a maximum of 9999.0 seconds.
Edit the values and restart the server or use /pvp reload to apply said changes. Delete the JSON file if it ever becomes malformed to let it regenerate.
Thank you for downloading. I would really appreciate it if you could report any potential issues you encounter in the comments section of the CurseForge mod page, as I currently have no other way to receive feedback.
You can also support me by sharing the mod around, as it really motivates me to work on it when there are people benefiting from its usage, no matter how small.
Project description from Modrinth.
Pick your setup
PvP Toggle by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
26.2
1 loader build26.1.2
1 loader build26.1.1
1 loader build26.1
1 loader build1.21.11
1 loader build1.21.10
1 loader build1.21.9
1 loader build1.21.8
1 loader build1.21.7
1 loader build1.21.6
1 loader build1.21.5
1 loader build1.21.2
1 loader buildShowing the newest 12 of 16 game versions. Older files are in the list below.
Check the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
PvP Toggle versions and loaders
1.6.1+26.2
pvptoggle-1.6.1+26.2.jar
5 Jul 2026
1.6.0+26.2
pvptoggle-1.6.0+26.2.jar
18 Jun 2026
1.6.0+26.1.2
pvptoggle-1.6.0+26.1.2.jar
16 Jun 2026
1.5.0+26.1
pvptoggle-1.5.0+26.1.jar
12 Apr 2026
1.4.0+1.21.11
pvptoggle-1.4.0+1.21.11.jar
10 Dec 2025
1.4.0+1.21.10
pvptoggle-1.4.0+1.21.10.jar
9 Oct 2025
1.4.0+1.21.9
pvptoggle-1.4.0+1.21.9.jar
1 Oct 2025
1.4.0+1.20.4
pvptoggle-1.4.0+1.20.4.jar
27 Aug 2025
1.4.0+1.21.1
pvptoggle-1.4.0+1.21.1.jar
18 Aug 2025
1.4.0+1.21.5
pvptoggle-1.4.0+1.21.5.jar
18 Aug 2025
1.4.0+1.21.6-21.8
pvptoggle-1.4.0+1.21.6-21.8.jar
16 Aug 2025
1.3.0+1.20.1
pvptoggle-1.3.0+1.20.1.jar
8 Aug 2025
Looking for an older file? The official Modrinth project page is in Resources.






