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.
| 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 |
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.
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 |
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 |
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) |
Multi-loader: Architectury API
Paper: Paper 1.21.11+
