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, broadcast messages, and full admin controls. Optional expRepair compatibility.
About this Mod
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
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+
Available Versions
How to Install pvpOption on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set bukkit Loader
In the panel under "Egg", select the bukkit loader and matching Minecraft version (1.21.11).
Install Mod
Open the mod browser in the dashboard and search for "pvpOption". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.11, 1.21.10, 1.21.9 (+9 more)
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
pvpOption server crashes on startup – what to do?
Most common cause: wrong bukkit version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.11). You can switch loaders with one click in the panel.
Is pvpOption compatible with bukkit and fabric and neoforge and paper and purpur and spigot?
pvpOption officially supports bukkit, fabric, neoforge, paper, purpur, spigot for Minecraft 1.21.11, 1.21.10, 1.21.9. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with pvpOption – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if pvpOption consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Rent Modded Server
Install pvpOption with just one click on your server.