pvpOption

⚔️ pvpOption Consensual, opt-in PvP --- 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 on` \| `off` | Force a player's flag on or off. | | `/pvp admin status ` | Inspect another player's flag, cooldown, and lock state. | | `/pvp admin lock ` | Unflag a player and **restrict** them from opting into PvP. | | `/pvp admin unlock ` | 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](https://github.com/LunixiaLIVE/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.