pvpOption

A Minecraft mod/plugin that adds opt-in PvP flagging. Players must explicitly enable PvP before they can deal or receive damage from other players. Unflagged players are fully protected.

Branches

Features

• Opt-in PvP flagging — players choose when to engage
• Configurable warmup period before PvP activates
• Combat cooldown — prevents toggling off mid-fight
• Action bar HUD showing PvP and combat status
• Auto-unflag after configurable idle time
• Broadcast toggle announcements to the server
• Admin commands to force-set, lock, and unlock player flags
• Config hot-reload without restarting the server

Note: The mod syncs the pvp= value in server.properties to match its own pvpEnabled setting on startup. The mod's config is the source of truth — editing server.properties directly has no effect.

Commands

All commands use /pvpoption (alias /pvp).

Admin (pvpoption.admin permission)

Configuration

Config is written on first launch. All values can also be changed live via admin commands.

Multi-loader — config/pvpoption.json Paper plugin — plugins/pvpOption/config.json

{
  "pvpEnabled": true,
  "cooldownSeconds": 30,
  "warmupSeconds": 5,
  "broadcastToggle": true,
  "autoUnflagMinutes": 0
}

Requirements

Multi-loader: Architectury API
Paper: Paper 1.21.11+