Back to mods
pvpOption-multi project artwork

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.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which pvpOption-multi release should I use?

Updated last month
Latest stable file pvpoption-1.5.5_MC-26.1-3-multi.jar
Game version 26.1, 26.1.1, 26.1.2
Loader Fabric, NeoForge

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.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release Fabric, NeoForge
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

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.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

Fabric API Optional for pvpOption-multi pvpoption-1.5.5_MC-26.1-3-multi.jar
optional
Matching file found Matched file: [26.3] Fabric API 0.166.2+26.3

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.

  1. 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.

  2. 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.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 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.

Fabric NeoForge

Download on Modrinth Join the Discord Source on GitHub

Minecraft 26.x & 1.21.x Single Player & Server Fabric API required on Fabric License MIT


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. /pvp flips 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 off don'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.

11 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

pvpOption-multi versions and loaders

4 of 4 releases match

Looking for an older file? The official CurseForge project page is in Resources.