# TogglePVPCustom<\/p>\n
TogglePVPCustom is a simple Paper Minecraft plugin that lets players turn their PvP status on or off individually.<\/p>\n
PvP only works when both players have PvP enabled. If one player has PvP disabled, they cannot attack or be attacked by other players.<\/p>\n
The plugin also supports PlaceholderAPI, so PvP status can be displayed in scoreboards, TAB, nametags, or below-name displays.<\/p>\n
TogglePVPCustom can optionally hook into Frwostella’s CombatLog plugin. It also has its own local combat timer, so players cannot use `\/pvp off` to escape combat after a real successful PvP hit.<\/p>\n
—<\/p>\n
## Features<\/p>\n
– Players can toggle their own PvP status.
\n– Prevents attacking if the attacker has PvP disabled.
\n– Prevents attacking players who have PvP disabled.
\n– Saves player PvP status.
\n– Configurable messages.
\n– Reload command without restarting the server.
\n– PlaceholderAPI support.
\n– Optional native below-name scoreboard display.
\n– TAB belowname-objective compatible.
\n– Optional CombatLog support.
\n– Local combat tracking after successful PvP hits.
\n– Blocks `\/pvp`, `\/pvp on`, and `\/pvp off` while combat tagged.
\n– Prevents `\/pvp off` from clearing CombatLog tags.
\n– Configurable `\/pvp` command cooldown.
\n– Optional cooldown bypass permission.<\/p>\n
—<\/p>\n
## Commands<\/p>\n
| Command | Description |
\n|—|—|
\n| `\/pvp` | Toggle your PvP status |
\n| `\/pvp on` | Enable your PvP |
\n| `\/pvp off` | Disable your PvP |
\n| `\/pvp status` | Check your PvP status |
\n| `\/pvp reload` | Reload the plugin config |<\/p>\n
Alias:<\/p>\n
“`txt
\n\/togglepvp
\n“`<\/p>\n
—<\/p>\n
## Permissions<\/p>\n
| Permission | Description | Default |
\n|—|—|—|
\n| `togglepvp.use` | Allows players to use `\/pvp` | Everyone |
\n| `togglepvp.reload` | Allows players to reload the plugin config | OP |
\n| `togglepvp.cooldown.bypass` | Allows players to bypass the `\/pvp` command cooldown | False |<\/p>\n
—<\/p>\n
## Optional Dependencies<\/p>\n
These plugins are optional, but unlock extra features.<\/p>\n
| Plugin | Required? | Purpose |
\n|—|—|—|
\n| PlaceholderAPI | Optional | Enables PvP status placeholders |
\n| CombatLog | Optional | Lets TogglePVPCustom also check CombatLog combat status |<\/p>\n
In `plugin.yml`, the optional dependencies should be listed like this:<\/p>\n
“`yml
\nsoftdepend:
\n – PlaceholderAPI
\n – CombatLog
\n“`<\/p>\n
CombatLog is optional. TogglePVPCustom will still work without it because it also tracks successful PvP hits locally.<\/p>\n
—<\/p>\n
## Combat Protection<\/p>\n
TogglePVPCustom has two layers of combat protection:<\/p>\n
1. Local combat tracking after successful PvP hits.
\n2. Optional CombatLog hook if Frwostella’s CombatLog plugin is installed.<\/p>\n
When combat protection is enabled, players cannot run PvP-changing commands while combat tagged:<\/p>\n
“`txt
\n\/pvp
\n\/pvp on
\n\/pvp off
\n“`<\/p>\n
They can still use:<\/p>\n
“`txt
\n\/pvp status
\n“`<\/p>\n
This prevents players from using `\/pvp off` to escape combat.<\/p>\n
Example config:<\/p>\n
“`yml
\nsettings:
\n pvp-toggle-block-seconds: 15<\/p>\n
combatlog-hook:
\n enabled: true
\n plugin-name: “CombatLog”
\n block-toggle-while-in-combat: true
\n“`<\/p>\n
Message:<\/p>\n
“`yml
\nmessages:
\n cannot-toggle-in-combat: “%prefix%&cYou cannot change your PvP status while in combat.”
\n“`<\/p>\n
To disable combat-toggle blocking:<\/p>\n
“`yml
\ncombatlog-hook:
\n block-toggle-while-in-combat: false
\n“`<\/p>\n
To disable only the CombatLog hook:<\/p>\n
“`yml
\ncombatlog-hook:
\n enabled: false
\n“`<\/p>\n
—<\/p>\n
## PvP Command Cooldown<\/p>\n
You can add a cooldown to:<\/p>\n
“`txt
\n\/pvp
\n\/pvp on
\n\/pvp off
\n“`<\/p>\n
Example:<\/p>\n
“`yml
\nsettings:
\n pvp-command-cooldown-seconds: 5
\n“`<\/p>\n
Set it to `0` to disable the cooldown:<\/p>\n
“`yml
\nsettings:
\n pvp-command-cooldown-seconds: 0
\n“`<\/p>\n
Cooldown message:<\/p>\n
“`yml
\nmessages:
\n command-cooldown: “%prefix%&cPlease wait &e%time%s &cbefore using this command again.”
\n“`<\/p>\n
Players with this permission bypass the cooldown:<\/p>\n
“`txt
\ntogglepvp.cooldown.bypass
\n“`<\/p>\n
By default, this permission is set to `false` in `plugin.yml`, so OPs do not bypass the cooldown unless you give them the permission manually.<\/p>\n
—<\/p>\n
## PlaceholderAPI Placeholders<\/p>\n
For the player’s own status, use:<\/p>\n
“`txt
\n%togglepvp_status%
\n%togglepvp_status_colored%
\n%togglepvp_value%
\n%togglepvp_enabled%
\n“`<\/p>\n
Examples:<\/p>\n
“`txt
\n%togglepvp_status% = ON \/ OFF
\n%togglepvp_status_colored% = &aON \/ &cOFF
\n%togglepvp_value% = 1 \/ 0
\n%togglepvp_enabled% = true \/ false
\n“`<\/p>\n
For another player’s status in nametags, TAB layouts, or relational placeholders, use:<\/p>\n
“`txt
\n%rel_togglepvp_status%
\n%rel_togglepvp_status_colored%
\n%rel_togglepvp_value%
\n%rel_togglepvp_enabled%
\n“`<\/p>\n
—<\/p>\n
## TAB Belowname Setup<\/p>\n
If you are using TAB for below-name status, disable the plugin’s built-in belowname first in `plugins\/TogglePVPCustom\/config.yml`:<\/p>\n
“`yml
\nbelowname:
\n enabled: false
\n“`<\/p>\n
Then use this in TAB’s config:<\/p>\n
“`yml
\nbelowname-objective:
\n enabled: true
\n value: “%togglepvp_value%”
\n title: “”
\n fancy-value: “&cPVP: %togglepvp_status_colored%”
\n fancy-value-default: “NPC”
\n disable-condition: “”
\n“`<\/p>\n
After editing the configs, run:<\/p>\n
“`txt
\n\/pvp reload
\n\/papi reload
\n\/tab reload
\n“`<\/p>\n
Do not put `%togglepvp_status%` in TAB’s `title`, because that can show your own PvP status under other players. Use `fancy-value` instead.<\/p>\n
—<\/p>\n
## Native Belowname Setup<\/p>\n
The plugin also has its own native Minecraft below-name display.<\/p>\n
Native below-name objectives can only show numbers, so it will display something like:<\/p>\n
“`txt
\n1 PvP
\n0 PvP
\n“`<\/p>\n
Example config:<\/p>\n
“`yml
\nbelowname:
\n enabled: true
\n objective-name: “pvpstatus”
\n display-name: “&cPvP”
\n enabled-score: 1
\n disabled-score: 0
\n remove-on-disable: true
\n“`<\/p>\n
Use this only if you are not using TAB’s belowname-objective, because two plugins controlling belowname at the same time can conflict.<\/p>\n
—<\/p>\n
## Full Example Config<\/p>\n
“`yml
\nsettings:
\n # If true, new players have PvP enabled by default.
\n default-pvp: true<\/p>\n
# Saves player PvP status into data.yml.
\n save-player-status: true<\/p>\n
# Prevents spam when players keep trying to attack PvP-disabled players.
\n attack-message-cooldown-seconds: 2<\/p>\n
# Cooldown before a player can use \/pvp, \/pvp on, or \/pvp off again.
\n # Set to 0 to disable.
\n pvp-command-cooldown-seconds: 5<\/p>\n
# How long players cannot toggle PvP after a real successful PvP hit.
\n # Match this with your CombatLog combat-time.
\n pvp-toggle-block-seconds: 15<\/p>\n
combatlog-hook:
\n # Optional hook for Frwostella’s CombatLog plugin.
\n enabled: true<\/p>\n
# This must match the CombatLog plugin name in its plugin.yml.
\n plugin-name: “CombatLog”<\/p>\n
# If true, players cannot change PvP status while they are combat tagged.
\n block-toggle-while-in-combat: true<\/p>\n
belowname:
\n # This is the native Minecraft below-name objective.
\n # Native below-name objectives can only show numbers, not text placeholders.
\n enabled: true<\/p>\n
objective-name: “pvpstatus”<\/p>\n
# Shows like:
\n # 1 PvP
\n # 0 PvP
\n display-name: “&cPvP”<\/p>\n
enabled-score: 1
\n disabled-score: 0<\/p>\n
remove-on-disable: true<\/p>\n
placeholders:
\n status-on: “ON”
\n status-off: “OFF”<\/p>\n
status-colored-on: “&aON”
\n status-colored-off: “&cOFF”<\/p>\n
messages:
\n prefix: “&8[&cPvP&8] ”<\/p>\n
no-permission: “%prefix%&cYou do not have permission to use this command.”
\n players-only: “%prefix%&cOnly players can use this command.”
\n reload: “%prefix%&aConfiguration reloaded.”<\/p>\n
pvp-enabled: “%prefix%&aYour PvP is now ENABLED.”
\n pvp-disabled: “%prefix%&cYour PvP is now DISABLED.”
\n pvp-status-enabled: “%prefix%&aYour PvP is currently ENABLED.”
\n pvp-status-disabled: “%prefix%&cYour PvP is currently DISABLED.”<\/p>\n
your-pvp-disabled: “%prefix%&cYou cannot attack while your PvP is disabled.”
\n target-pvp-disabled: “%prefix%&cYou cannot attack &e%target% &cbecause their PvP is disabled.”<\/p>\n
cannot-toggle-in-combat: “%prefix%&cYou cannot change your PvP status while in combat.”
\n command-cooldown: “%prefix%&cPlease wait &e%time%s &cbefore using this command again.”<\/p>\n
usage: “%prefix%&cUsage: \/pvp [on|off|status|reload]”
\n“`<\/p>\n
—<\/p>\n
## Example `plugin.yml`<\/p>\n
“`yml
\nname: TogglePVPCustom
\nversion: 1.1.0
\nmain: jre.frwostella.togglePVPCustom.TogglePVPCustom
\napi-version: ‘1.21’
\nauthor: Frwostella
\ndescription: Allows players to individually toggle their PvP status.
\nsoftdepend:
\n – PlaceholderAPI
\n – CombatLog<\/p>\n
commands:
\n pvp:
\n description: Toggle your PvP status.
\n usage: \/pvp [on|off|status|reload]
\n aliases:
\n – togglepvp<\/p>\n
permissions:
\n togglepvp.use:
\n description: Allows players to use \/pvp.
\n default: true<\/p>\n
togglepvp.reload:
\n description: Allows reloading the plugin config.
\n default: op<\/p>\n
togglepvp.cooldown.bypass:
\n description: Allows players to bypass the \/pvp command cooldown.
\n default: false
\n“`<\/p>\n
—<\/p>\n
## Installation<\/p>\n
1. Download or build the plugin `.jar`.
\n2. Put the `.jar` file into your server’s `plugins` folder.
\n3. Install PlaceholderAPI if you want placeholder support.
\n4. Install CombatLog if you want the plugin to also check CombatLog combat tags.
\n5. Restart your server after replacing the `.jar`.
\n6. Delete or manually update the old `plugins\/TogglePVPCustom\/config.yml` if new settings are missing.
\n7. Run:<\/p>\n
“`txt
\n\/pvp reload
\n“`<\/p>\n
—<\/p>\n
## Important Notes<\/p>\n
After rebuilding the jar, you should restart the server.<\/p>\n
Do not only use `\/pvp reload` after changing the jar file.<\/p>\n
If new config options are missing, either manually add them or delete the old config so the plugin can generate a new one.<\/p>\n
The most important new config options are:<\/p>\n
“`yml
\nsettings:
\n pvp-command-cooldown-seconds: 5
\n pvp-toggle-block-seconds: 15<\/p>\n
combatlog-hook:
\n block-toggle-while-in-combat: true
\n“`<\/p>\n
—<\/p>\n
## Requirements<\/p>\n
– Paper 1.21+
\n– Java 21+<\/p>\n
Optional:<\/p>\n
– PlaceholderAPI
\n– CombatLog<\/p>\n
—<\/p>\n","protected":false},"excerpt":{"rendered":"
A simple Paper plugin that lets players individually toggle their PvP status on or off. It supports PlaceholderAPI, TAB below-name displays, and optional CombatLog integration to stop players from disabling PvP while in combat.<\/p>\n","protected":false},"featured_media":157393,"template":"","meta":{"_minecraft_slug":"togglepvpcustom","_minecraft_project_id":"ey5TRAF1","_minecraft_author":"Frwostella","_minecraft_license":"MIT","_minecraft_downloads":24,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"togglepvpcustom.zip","_minecraft_size_bytes":82952,"_minecraft_version_count":6,"_minecraft_updated_at":"2026-05-15T22:27:25.900748Z","_minecraft_date_created":"2026-05-07T21:16:26.932748Z","_minecraft_date_modified":"2026-05-01T04:04:33.682046Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/togglepvpcustom","_minecraft_icon_attachment_id":157393,"_minecraft_imported_at":"2026-06-09T13:02:21+00:00","_minecraft_import_hash":"9d1433075f95f495ed36c952b5bb996c","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,127,123,92],"mod_loader":[130,132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-157392","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-paper","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n