PvPToggle

PvPToggle

Simple and lightweight global PvP management for Paper servers.

PvPToggle allows server administrators to easily enable or disable PvP for all players in configured worlds using simple commands.

The plugin provides configurable world support, customizable title notifications and persistent PvP status storage.

✨ Features

• Global PvP Control – Enable or disable PvP for all players.
• World-Based Configuration – Choose exactly which worlds are managed by the plugin.
• Persistent Status – PvP status is saved and restored after server restarts.
• Title Notifications – Players receive a title notification whenever PvP is toggled.
• Projectile Protection – Blocks player-to-player damage from arrows, tridents and other projectiles.
• Melee Protection – Prevents players from attacking each other while PvP is disabled.
• No Admin Bypass – PvP restrictions apply to everyone, including operators.
• Customizable Messages – Change titles, subtitles and display durations in the configuration.

📋 Commands

Command · Description
/pvp · Displays the current PvP status.
/pvp on · Enables PvP in all configured worlds.
/pvp off · Disables PvP in all configured worlds.
/pvp status · Displays the current PvP status and managed worlds.

🔑 Permissions

Permission · Description · Default
pvtoggle.admin · Allows access to all PvPToggle commands. · OP

There is no bypass permission. PvP restrictions apply to all players, including server administrators and operators.

⚙️ Configuration

Example config.yml:

settings:
default-pvp: true
save-status: true

worlds:

• HeartSMP
• PvP_event

messages:
prefix: "&8[&dPvPToggle&8]"

enabled:
title: "&a&lPvP ENABLED"
subtitle: "&7PvP is now enabled for everyone!"

disabled:
title: "&c&lPvP DISABLED"
subtitle: "&7PvP is now disabled for everyone!"

title-settings:
fade-in: 10
stay: 40
fade-out: 10

💾 Data Storage

The current PvP status is stored in:

plugins/PvPToggle/data.yml

When save-status is enabled, the last active PvP status is automatically restored after a server restart.

📦 Installation

1. Download the latest PvPToggle release.
2. Place the .jar file into your server's plugins folder.
3. Restart your server.
4. Configure plugins/PvPToggle/config.yml.
5. Restart your server to apply configuration changes.

🖥️ Compatibility

• Minecraft: 1.21.11
• Server Software: Paper
• Java: 21
• Plugin Version: 1.0.0

ℹ️ Important Notes

• PvPToggle only manages worlds listed in the configuration.
• Worlds not listed in the configuration retain their normal Minecraft PvP behavior.
• Environmental damage, mob damage and other non-player damage sources are unaffected.
• Configuration changes currently require a server restart.

Lightweight. Simple. Full control over your server's PvP.