pvpOption-multi

Quick rating

Community listing page, reviews here may not be monitored by the author.

How listings work Are you the author?

pvpOption-multi

By LunixiaLIVE

No reviews yet

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.

Mod Loaders
Minecraft
Hosting Partner

Want to reach Minecraft players?

We're looking for a server hosting partner to feature here and other parts of the site. Interested? Send us a message!

Get in touch

About

Description

⚔️ 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.