pvpOption
Opt-in PvP for servers. Only flagged players can fight each other. Includes warmup timer, combat cooldown, action bar HUD, auto-unflag on inactivity…
I don't know my version or loader
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
| Branch | Platform | MC Version |
|---|---|---|
multi_1.21.11 |
Fabric + NeoForge (Architectury) | 1.21.11 |
plugin_1.21.11 |
Spigot, Paper, Purpur, Pufferfish | 1.21.11 |
multi_26.x (upcoming) |
Fabric + NeoForge (Architectury) | 26.x |
plugin_26.x (upcoming) |
Spigot, Paper, Purpur, Pufferfish | 26.x |
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 inserver.propertiesto match its ownpvpEnabledsetting on startup. The mod's config is the source of truth — editingserver.propertiesdirectly has no effect.
Commands
All commands use /pvpoption (alias /pvp).
| Command | Description |
|---|---|
/pvp |
Toggle your PvP flag |
/pvp on |
Enable your PvP flag |
/pvp off |
Disable your PvP flag |
/pvp status |
Show your current PvP status |
/pvp list |
List all flagged players |
Admin (pvpoption.admin permission)
| Command | Description |
|---|---|
/pvp admin |
Show current config values |
/pvp admin enable|disable |
Enable or disable PvP system-wide |
/pvp admin warmup <seconds> |
Set warmup duration (0 to disable) |
/pvp admin cooldown <seconds> |
Set combat cooldown duration (0 to disable) |
/pvp admin autounflag <minutes> |
Set idle auto-unflag time (0 to disable) |
/pvp admin broadcast on|off |
Toggle flag change broadcasts |
/pvp admin set <player> on|off |
Force-set a player's flag |
/pvp admin status <player> |
View a player's PvP status |
/pvp admin lock <player> |
Unflag and block a player from enabling PvP |
/pvp admin unlock <player> |
Restore a player's ability to use PvP |
/pvp admin reload [silent] |
Reload config from disk |
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
}
| Field | Default | Description |
|---|---|---|
pvpEnabled |
true |
Master switch for the PvP system |
cooldownSeconds |
30 |
Seconds after combat before PvP can be disabled |
warmupSeconds |
5 |
Seconds before PvP activates after opting in |
broadcastToggle |
true |
Announce flag changes to all players |
autoUnflagMinutes |
0 |
Minutes of idle time before auto-disabling PvP (0 = off) |
Requirements
Multi-loader: Architectury API
Paper: Paper 1.21.11+
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.21, 1.21.1, 1.21.2
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
- Ships as pvpoption-1.5.3_MC-1.21.11-paper.jar — drop this file into the mods folder
- Download size: 20 KB
- Download link checked 1 Sept 2026 — working
These come from our own check of the pack file, not from the source page.