FoPvPToggle

FoPvPToggle gives players a clear /pvp switch while keeping server owners in control of where combat must stay enabled. Player choices are saved, blocked combat is handled across common direct and indirect damage paths, and admins can manage the important settings from an in-game editor.

Features

• Let players use /pvp, /pvptoggle, or /fopvptoggle to turn personal PvP on, off, or check status.
• Block PvP both ways when either player has PvP disabled, including traced projectiles, TNT, end crystals, beds, and respawn-anchor explosions.
• Save each player's PvP state in userdata.db, so toggles survive restarts.
• Force PvP on during events with a global override that prevents players from disabling combat.
• Keep selected worlds outside the toggle system, where /pvp is unavailable and PvP stays enabled.
• Use the admin editor to manage default PvP, event override, PvE protection, FoBoss protection, disabled worlds, and forced WorldGuard regions.

Optional Integrations

• WorldGuard - browse regions in the editor and force PvP on inside selected regions.
• FoBoss - FoBoss can protect PvP-disabled players from boss targeting and damage when the FoBoss protection setting is enabled.

Commands

• /pvp [on|off|status] - Toggle or view your PvP state.
• /fopvptoggle [on|off|status] - Main command alias for the same player toggle.
• /fopvptoggleadmin version - Show plugin and update status.
• /fopvptoggleadmin reload - Reload config, messages, and GUI files.
• /fopvptoggleadmin editor - Open the in-game admin editor.

Permissions

• fopvptoggle.pvptoggle - Use the player PvP toggle command.
• fopvptoggle.admin - Use admin version, reload, and editor tools.

Placeholders

• %fopvptoggle_status% - Shows the status for that player if pvp is enabled or disabled.

<dependency>
  <groupId>me.foesio</groupId>
  <artifactId>FoPvPToggle</artifactId>
  <version>1.9</version>
  <scope>provided</scope>
</dependency>

import me.foesio.foPvPToggle.api.PvpToggleApi;
import me.foesio.foPvPToggle.api.event.PlayerPvpChangeRequestEvent;

PvpToggleApi api = Bukkit.getServicesManager().load(PvpToggleApi.class);
if (api != null) api.isPvpEnabled(player);

@EventHandler
public void onPlayerPvpChangeRequestEvent(PlayerPvpChangeRequestEvent event) {
    Bukkit.getLogger().info(event.getClass().getSimpleName());
}