CurseForge · Minecraft mod
pvpOption-multi
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.
Quick answer
Which pvpOption-multi release should I use?
pvpOption-multi pvpoption-1.5.5_MC-26.1-3-multi.jar targets 26.1, 26.1.1, 26.1.2 with Fabric, NeoForge. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.
Where it goes
Is pvpOption-multi required on the client, server, or both?
The project page does not say whether this file belongs on the client, dedicated server, or both.
The source does not explicitly classify this release as client-only or server-only.
What else does pvpOption-multi pvpoption-1.5.5_MC-26.1-3-multi.jar need?
pvpoption-1.5.5_MC-26.1-3-multi.jar. Change the file and its required mods may change too.
This file does not list any required mods. Do not add a library just because a different file uses it.
We only count dependency files that match this setup. A file for another loader does not fill the gap.
Before you install it
Add pvpOption-multi without breaking your instance.
Built for pvpOption-multi pvpoption-1.5.5_MC-26.1-3-multi.jar. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use pvpoption-1.5.5_MC-26.1-3-multi.jar. It targets 26.1, 26.1.1, 26.1.2 with Fabric, NeoForge; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
This file does not list any required mods. Do not add a library just because a different file uses it.
- 03
Put it on the correct side
The project page does not say whether this file belongs on the client, dedicated server, or both.
- 04
Pick the file you checked
Use the “Get this file” button beside pvpoption-1.5.5_MC-26.1-3-multi.jar. It opens that exact file at the source.
About this project
What does pvpOption-multi add?
⚔️ pvpOption
Consensual, opt-in PvP — you only fight the players who signed up for it.
On most servers PvP is a single switch: on for everyone, or off for everyone. pvpOption replaces it with a per-player, opt-in flag. You deal and take player-versus-player damage only when you've chosen to — and only against other players who've chosen to as well. Everyone else stays fully protected. No more accidental hits, no more "I didn't mean to swing at them," no more getting ganked when you just wanted to build.
🆕 New in 1.5.5: one jar now runs on every Minecraft 26.x release — 26.1, 26.1.1, 26.1.2, 26.2 and 26.3.
✨ Features
- ⚔️ Opt in with one command.
/pvpflips your flag on. A short warmup counts down first — a grace period so nobody instantly ambushes you — then your flag goes live. - 🤝 Both sides must agree. A hit only lands when attacker and defender are both flagged. Swing at an unflagged player and the blow is cancelled, with a message telling you why.
- ⏱️ A combat cooldown keeps fights honest. Every valid hit starts a combat timer on both players. You can't unflag and run to safety mid-fight — you're locked in until it expires.
- 😴 Optional auto-unflag. Admins can quietly drop a player's flag after a stretch of inactivity, so people who forget to
/pvp offdon't wander around flagged forever. - 📊 Live action-bar HUD. Your current state at a glance — warmup countdown, ⚔ PvP Active, and the remaining combat cooldown.
- 📢 Optional broadcasts. Announce server-wide when a player enters or leaves PvP mode, so everyone knows who's fair game.
- 🛠️ Full admin controls. Toggle the whole system, tune warmup / cooldown / auto-unflag live, force a player's flag on or off, and lock troublemakers out of PvP entirely.
- 💾 Persistent per-UUID state. Flags and admin locks survive restarts. No new blocks, no items, no client mod required.
⌨️ Commands
The root command is /pvpoption, with /pvp as a shorter alias. Running it bare toggles your own flag.
Player commands
| Command | What it does |
|---|---|
/pvp |
Toggle your own PvP flag on or off. |
/pvp on |
Opt in — starts the warmup, then flags you. |
/pvp off |
Opt out — cancels a pending warmup, or unflags you (blocked while in combat cooldown). |
/pvp status |
Show your own flag state, plus any remaining combat cooldown. |
/pvp list |
List every player currently flagged for PvP (and who's in combat). |
Admin commands
All admin subcommands live under /pvp admin … and require operator / game-master permission (level 2+).
| Command | What it does |
|---|---|
/pvp admin |
Show the current admin settings. |
/pvp admin enable | disable |
Turn the whole PvP system on or off server-wide. |
/pvp admin warmup [seconds] |
Show or set the opt-in warmup, in seconds (0 = instant). |
/pvp admin cooldown [seconds] |
Show or set the combat cooldown, in seconds (0 = disabled). |
/pvp admin autoUnflag [minutes] |
Show or set the idle auto-unflag time, in minutes (0 = disabled). |
/pvp admin broadcast on | off |
Toggle the "entered/left PvP mode" announcements. |
/pvp admin disableRepair on | off |
Toggle expRepair repair suppression for flagged players. |
/pvp admin reload [silent] |
Reload the config from disk (silent announces only to you). |
/pvp admin set <player> on | off |
Force a player's flag on or off. |
/pvp admin status <player> |
Inspect another player's flag, cooldown, and lock state. |
/pvp admin lock <player> |
Unflag a player and restrict them from opting into PvP. |
/pvp admin unlock <player> |
Lift a restriction and restore a player's PvP access. |
⚙️ Configuration
Config lives at config/pvpoption.json and is created with defaults on first launch. Every value is also settable live through /pvp admin …, and /pvp admin reload re-reads the file without a restart. Per-player flags and locks are stored separately in config/pvpoption/playerdata.json.
| Key | Default | What it does |
|---|---|---|
pvpEnabled |
true |
Master switch for the whole system (also syncs pvp= in server.properties). |
disableRepairInPvP |
false |
Suppress expRepair XP repair while a player is flagged (needs expRepair 1.7+). |
cooldownSeconds |
30 |
Combat cooldown after a valid hit; you can't unflag until it expires (0 = disabled). |
warmupSeconds |
5 |
Grace-period countdown before /pvp on actually flags you (0 = instant). |
broadcastToggle |
true |
Announce when a player enters or leaves PvP mode. |
autoUnflagMinutes |
0 |
Auto-drop a flag after this many idle minutes (0 = never). |
🔧 Plays nice with expRepair
If expRepair (1.7+) is installed, pvpOption registers a repair-suppression hook with it. With disableRepairInPvP on, any player currently flagged for PvP has their XP repair suppressed — so you can't top off gear durability in the middle of a duel. The hook only wires up when expRepair is actually present; without it, the disableRepair admin command simply reports that expRepair isn't installed.
🧩 Compatibility
| Loaders | Fabric and NeoForge — one jar |
| Minecraft | 26.1 – 26.3 — one jar, v1.5.5 · 1.21.11 and 1.21.1 – 1.21.10 — v1.5.3 |
| Fabric API | Required on Fabric · not needed on NeoForge |
| Side | Server-side — vanilla clients supported, single-player too |
| Extra libraries | None |
Enjoying it? Hop in the Discord · ⭐ the repo · explore the rest of Lunixia's Minecraft QOL Mods
⛏️ Small, focused mods that cut out the boring stuff.
Project description from CurseForge.
Pick your setup
pvpOption-multi by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
26.3
2 loader builds26.2
2 loader builds26.1.2
2 loader builds26.1.1
2 loader builds26.1
2 loader builds1.21.11
1 loader buildCheck the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
pvpOption-multi versions and loaders
pvpoption-1.5.5_MC-26.1-3-multi.jar
24 Sept 2026
pvpoption-1.5.2_MC-26.1.jar
5 Apr 2026
pvpoption-1.5.2_MC-1.21.11.jar
5 Apr 2026
pvpoption-1.5.jar
25 Mar 2026
Looking for an older file? The official CurseForge project page is in Resources.