All Mods Resource Packs Data Packs Shaders Modpacks Plugins
pvp-toggle

pvp-toggle

by LukeOnuke • Downloads: 0 • Followers: 0
Description
Gallery
Changelog
Versions

PVP Toggle

Available on Modrith Modrinth Downloads Let your players choose when they want to fight! When a player is protected, they can't get damaged by other players and also can't damage other players themselves.

Extensive configuration!

Commands

Command Use Permission Aliases
/pvp Toggle pvp pvptoggle.pvp N/A
/pvp <user> Toggle pvp for user pvptoggle.pvp.others N/A
/pvp reload Reload the plugin pvptoggle.reload N/A
/pvpstatus Get if you are protected from pvp pvptoggle.pvpstatus /pstatus, /ps
/pvpstatus <user> Get if someone else is protected from pvp pvptoggle.pvpstatus.others /pstatus, /ps

PlaceholderAPI Integration

This plugin supports PlaceholderAPI, and comes with the following placeholders.

  • %pvp-toggle_vulnerable% Is the player vulnerable, expressed in configurable human-readable language.
  • %pvp-toggle_boolvulnerable% Is the player vulnerable, expressed in true of false.

Default config

# What should messages be prefixed with?
# You can use the formatting codes listed at https://minecraft.wiki/w/Formatting_codes#Color_codes
prefix: "§4PvP »"

# Should pvp be on by default?
default-pvp: false

# Do any worlds have PVPToggle disabled?
disabled-worlds:
#  - world

# What is the message sent to players in the chat if they try to use the pvp command while on cooldown?
# %s is replaced by the time remaining, in the format of "1 minute and 32 seconds" or "32 seconds"
cooldown-message: "%s of cooldown remaining."

# After enabling pvp, how many seconds must a player wait before disabling it?
cooldown: 120

# Should players be prevented from disabling pvp during a fight?
anti-abuse: true

# Should players be able to hit themselves?
hit-self: true

# Should particles be spawned when a player is hit, but protected?
particles: true

# Should a message be sent to a player when they hit another player, but fail because that player is protected?
feedback: true

# Should a player's pvp status be reset when they die?
death-status-reset: true

# Should pvp be turned on after a player dies? Doesn't apply if death-status-reset is false.
death-status: false

# How many seconds should a player's cooldown be set to when they die? -1 to disable.
death-cooldown: -1

# After how many seconds should a player's pvp be automatically re-enabled? -1 to disable.
limited-time: -1

# Should a player be sent a chat message when their pvp is automatically re-enabled?
limited-message: "You are now %s"

# Should a player be sent a chat message when they die?
death-message: "You are now %s"

# Should players be able to attack pets of protected players?
protect-pets: true

# Should players ever be able to hit their own pets? (More "friendlies" coming soon)
friendly-fire: false

# What should the message be when a player tries to attack someone but fails because they're protected?
# %s is replaced with the name of the attacked.
pvp-off-message: "You can't fight %s!"
# %r is replaced with the name of the pet, for example "Wolf" or "King George II."
pet-pvp-message: "You can't fight %s's %r!"

# What should the message be when you try to attack your own team, but fail because friendly-fire is false?
ff-message: "Friendly fire!"

# What should the message be when toggle pvp?
# %s is replaced with the new state, "Vulnerable" or "Protected" by default.
toggle-message: "You are now %s"

# What should the message be when the console tries to do something that only players can do?
console-message: "§cYou can't use this command from the console."

# What should the message be when someone tries to do something, but can't because they don't have permission to?
permission-message: "You don't have permission to use this command."

# What should the message be after reloading this plugin?
reload-message: "Reloaded!"

# What should the message be when the targeted player can't be found?
# %s is replaced with the name of the targeted player.
not-found-message: "%s isn't online."

# What should the message be after toggling another player's pvp?
# %s is replaced with the name of the targeted player.
# %r is replaced with the new state, "Vulnerable" or "Protected" by default.
remote-toggle-message: "%s is now %r"

# What should the message be for checking pvp status?
# %s is the name of the player
# %r is the state; "Vulnerable" or "Protected" by default. (See: `disabled` and `enabled`)
pvp-status-message: "Status of %s is now %r"

# What should the words for the two states of pvp be?
disabled: "§aProtected"
enabled: "§cVulnerable"

pvp-toggle IS NOT AFFILIATED WITH Microsoft Corporation, Minecraft IS A REGISTERED TRADEMARK OF Microsoft Corporation

pvp-toggle IS NOT AFFILIATED WITH Rinth Inc, "Modrinth" IS A REGISTERED TRADEMARK OF Rinth Inc

All Versions

+ Add Version
Name Game version Platforms Published Downloads Actions
1.21.x 1.20.x
Paper Purpur Spigot
7h ago 1
1.21.x
Paper Purpur Spigot
7h ago 1
1.21.x
Bukkit Paper Purpur Spigot
7h ago 1
1.21.x
Bukkit Paper Purpur Spigot
7h ago 1
1.21.x
Bukkit Paper Purpur Spigot
7h ago 1
1.21.x
Paper Purpur Spigot
7h ago 1
1.21.x
Bukkit Paper Purpur Spigot
7h ago 1
1.21.x
Paper Purpur Spigot
7h ago 1
1.21.x
Paper Purpur Spigot
7h ago 1
1.21.x
Bukkit Paper Purpur Spigot
7h ago 1
1.21
Paper Purpur Spigot
7h ago 1
1.21
Paper Purpur Spigot
7h ago 1
1.20.x
Bukkit Paper Purpur Spigot
7h ago 1
1.20.x
Paper Purpur Spigot
7h ago 1
1.20.x
Paper Purpur Spigot
7h ago 1
[3.1.3] pvp-toggle 3.1.3 by LukeOnuke on Oct 15, 2026
Download
# Additions
  • Add nocooldown permission

Thank you @MiningTcup
[3.1.2] pvp-toggle 3.1.2 by LukeOnuke on Oct 15, 2026
Download
# Changes
  • Add pvp cooldown override permission
  • Fix warnings
  • Bump version
[3.1.1] pvp-toggle 3.1.1 by LukeOnuke on Oct 15, 2026
Download
# Changes
  • Properly display toggled state when toggling another player.
[3.1.0] pvp-toggle 3.1.0 by LukeOnuke on Oct 15, 2026
Download
# Changes
  • Properly implement pvpstatus
# Fixes
Properly implement the pvpstatus command.
[3.0.0] pvp-toggle 3.0.0 by LukeOnuke on Oct 15, 2026
Download
# Additions
  • Implement #16 - Disable PVPToggle in certin worlds

# Fixes
  • Fix broken PvP vulnerable placeholder by @JerichoTorrent in https://github.com/LukeOnuke/pvp-toggle/pull/14
  • Fix #15, /pvp now displays the apropriate state.
  • Fix #13, placeholder is now functioning.
  • Fix #17 - Do not display space before messages if prefix is empty

# Refractorings and code
  • Changed the way configuration is read, now with a single service ConfigurationService.
  • Added documentation to all of the service classes and their methods inside com.lukeonuke.pvptoggle.service.
  • Clarified code
# Fixes

# Refractorings and code
  • Changed the way configuration is read, now with a single service ConfigurationService.
  • Added documentation to all of the service classes and their methods inside com.lukeonuke.pvptoggle.service.

[2.0.1] pvp-toggle 2.0.1 by LukeOnuke on Oct 15, 2026
Download
# Fixes
  • Fixed issue #10 **(Pvp cant be used again)** with pull request #11.
[2.0.0] pvp-toggle 2.0.0 by LukeOnuke on Oct 15, 2026
Download
# Changes
As always thanks to the wonderful people who contribute to this project.
## Fixes
  • Greatly improved proxy damage detection to prevent pvp protection circumvention exploits.
## Additions
  • Pets are now also protected. (configurable)
  • Configurable time for players to become vulnerable after enabling pvp protection.
  • PAPI *(PlaceholderAPI)* integration (#5)


> **git c**: https://github.com/LukeOnuke/pvp-toggle/compare/v1.3.0...v2.0.0
[1.3.0] pvp-toggle 1.3.0 by LukeOnuke on Oct 15, 2026
Download
# Additions
  • More configuration options
  • Option to prevent players abusing /pvp to escape a battle. This is achieved by resetting the cooldown when they are hit. *(The cooldown only applies when going from being protected to vulnerable, not the other way around.)*
  • Better formatters
  • More readable language
  • Time formatter can now do minutes
  • The /pvp reload command that reloads the config.
  • Improved documentation

> Thank you [@MiningTcup](https://github.com/MiningTcup) for contributing to this release.
[1.2.0] pvp-toggle 1.2.0 by LukeOnuke on Oct 15, 2026
Download
# Changes
  • Ported to 1.21. #2
  • Added configs for: (thanks @BlurOne-GIT)
  • The default pvp state if not toggled.
  • The "can't pvp" message.

# Changes
  • Ported to **1.21**

# Why is it alpha
The plugin has gained some numbers and id like to get it tested before it gets marked as release ready.

The plugin is stable, some combat testing will get done and if all goes to plan the release is comming soon.
[1.1.0] pvp-toggle 1.1.0 by LukeOnuke on Oct 15, 2026
Download
# Fixes
  • You can now damage yourself! Enderpearls will no longer display message that you cant pvp with yourself.
[1.0.0] pvp-toggle 1.0.0 by LukeOnuke on Oct 15, 2026
Download
# Additions
  • When you cant pvp with someone it shows up in the actionbar and spawns particles

# Fixes
  • Now projectiles are also tracked as pvp.
  • /pvp command response is properly colored
[0.0.3-alpha] 0.0.3 Alpha by LukeOnuke on Oct 15, 2026
Download
#Additions
  • Players can no longer circumvent pvp toggle with projectiles
pvp-toggle Icon
Download pvp-toggle
Select game version
Select platform