# pvpOption<\/p>\n
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.<\/p>\n
—<\/p>\n
## Branches<\/p>\n
| Branch | Platform | MC Version |
\n|—|—|—|
\n| `multi_1.21.11` | Fabric + NeoForge (Architectury) | 1.21.11 |
\n| `plugin_1.21.11` | Spigot, Paper, Purpur, Pufferfish | 1.21.11 |
\n| `multi_26.x` *(upcoming)* | Fabric + NeoForge (Architectury) | 26.x |
\n| `plugin_26.x` *(upcoming)* | Spigot, Paper, Purpur, Pufferfish | 26.x |<\/p>\n
—<\/p>\n
## Features<\/p>\n
– Opt-in PvP flagging \u2014 players choose when to engage
\n– Configurable warmup period before PvP activates
\n– Combat cooldown \u2014 prevents toggling off mid-fight
\n– Action bar HUD showing PvP and combat status
\n– Auto-unflag after configurable idle time
\n– Broadcast toggle announcements to the server
\n– Admin commands to force-set, lock, and unlock player flags
\n– Config hot-reload without restarting the server<\/p>\n
> **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 \u2014 editing `server.properties` directly has no effect.<\/p>\n
—<\/p>\n
## Commands<\/p>\n
All commands use `\/pvpoption` (alias `\/pvp`).<\/p>\n
| Command | Description |
\n|—|—|
\n| `\/pvp` | Toggle your PvP flag |
\n| `\/pvp on` | Enable your PvP flag |
\n| `\/pvp off` | Disable your PvP flag |
\n| `\/pvp status` | Show your current PvP status |
\n| `\/pvp list` | List all flagged players |<\/p>\n
### Admin (`pvpoption.admin` permission)<\/p>\n
| Command | Description | —<\/p>\n ## Configuration<\/p>\n Config is written on first launch. All values can also be changed live via admin commands.<\/p>\n **Multi-loader** \u2014 `config\/pvpoption.json` “`json | Field | Default | Description | —<\/p>\n ## Requirements<\/p>\n **Multi-loader:** Architectury API Opt-in PvP for servers. Only flagged players can fight each other. Includes warmup timer, combat cooldown, action bar HUD, auto-unflag on inactivity, broadcast messages, and full admin controls. Optional expRepair compatibility.<\/p>\n","protected":false},"featured_media":127056,"template":"","meta":{"_minecraft_slug":"pvpoption","_minecraft_project_id":"rRMUYruU","_minecraft_author":"lunixialive","_minecraft_license":"MIT","_minecraft_downloads":407,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"pvpoption.zip","_minecraft_size_bytes":42999,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-16T10:58:14.834536Z","_minecraft_date_created":"2026-03-26T05:32:26.540617Z","_minecraft_date_modified":"2026-04-24T15:47:21.965561Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/pvpoption","_minecraft_icon_attachment_id":127056,"_minecraft_imported_at":"2026-06-07T11:22:41+00:00","_minecraft_import_hash":"7c1d2dde863dd3a0a9e4ca54d7555c3e","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,97,158,127,128,129],"mod_loader":[99,160],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-127055","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-fabric","mod_category-neoforge","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-fabric","mod_loader-neoforge","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|—|—|
\n| `\/pvp admin` | Show current config values |
\n| `\/pvp admin enable|disable` | Enable or disable PvP system-wide |
\n| `\/pvp admin warmup
\n| `\/pvp admin cooldown
\n| `\/pvp admin autounflag
\n| `\/pvp admin broadcast on|off` | Toggle flag change broadcasts |
\n| `\/pvp admin set
\n| `\/pvp admin status
\n| `\/pvp admin lock
\n| `\/pvp admin unlock
\n| `\/pvp admin reload [silent]` | Reload config from disk |<\/p>\n
\n**Paper plugin** \u2014 `plugins\/pvpOption\/config.json`<\/p>\n
\n{
\n “pvpEnabled”: true,
\n “cooldownSeconds”: 30,
\n “warmupSeconds”: 5,
\n “broadcastToggle”: true,
\n “autoUnflagMinutes”: 0
\n}
\n“`<\/p>\n
\n|—|—|—|
\n| `pvpEnabled` | `true` | Master switch for the PvP system |
\n| `cooldownSeconds` | `30` | Seconds after combat before PvP can be disabled |
\n| `warmupSeconds` | `5` | Seconds before PvP activates after opting in |
\n| `broadcastToggle` | `true` | Announce flag changes to all players |
\n| `autoUnflagMinutes` | `0` | Minutes of idle time before auto-disabling PvP (0 = off) |<\/p>\n
\n**Paper:** Paper 1.21.11+<\/p>\n","protected":false},"excerpt":{"rendered":"