PvP here is opt-in, per player. Nobody has to fight anyone. You turn your own flag on when you want a fight, and a hit only lands if both players have their flag on. Everyone else is protected — no accidental hits, no getting ganked while you are just building.

That replaces the usual server-wide switch, where PvP is either on for everybody or off for everybody.

The rules in short

  • You opt in. /pvp toggles your own flag. /pvp on and /pvp off do the same thing explicitly.
  • Both sides must agree. A hit only lands when the attacker and the defender are both flagged. Swing at someone who has not opted in and the blow is cancelled, with a message telling you why.
  • A warmup runs first. After /pvp on there is a short countdown before your flag actually goes live — a grace period, so nobody can ambush you the instant you enable it. Use /pvp off to cancel it.
  • A combat cooldown locks you in. A valid hit starts a timer on both players. You cannot /pvp off and run away mid-fight — you are locked in until the timer expires.
  • Your state is always visible. The action bar above your hotbar shows the warmup countdown, a ⚔ PvP Active marker, and the remaining combat cooldown.
  • Nothing to install. It is server-side. Vanilla clients work, including Bedrock phones and consoles — no mod needed.

Turning it on

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 you are in a combat cooldown.
/pvp status Show your own flag state and any remaining combat cooldown.
/pvp list List every player currently flagged for PvP, and who is in combat.

The full command is /pvpoption; /pvp is the shorter alias and does the same thing.

How it behaves on this server

These are the actual settings running right now:

Setting Value What it means
Warmup 5 seconds Grace period before your flag goes live.
Combat cooldown 30 seconds How long a valid hit locks both players in.
Broadcast On The server announces when someone enters or leaves PvP mode.
Auto-unflag Off Flags do not expire on their own. Turn it off yourself.

Two practical consequences of the way this is set up:

Your flag does not wear off. With auto-unflag disabled, a flag you set stays set until you /pvp off — and it is stored per account, so it survives a disconnect and still applies when you come back. If you are done fighting, turn it off yourself rather than assuming it expired.

Logging out does end any combat cooldown and cancels a pending warmup, so you cannot dodge a fight by disconnecting and reconnecting — but your flag itself comes back with you.

You are announced. Because broadcasts are on, the whole server sees when you enter or leave PvP mode. There is no quietly toggling it on and surprising someone.

Combat and your claim

Land claims are PvP-safe zones. GriefPrevention is configured to protect players inside claims, and that protection runs in both directions:

  • You cannot be attacked while you are standing in your claim. The hit is cancelled even if the attacker has their PvP flag on and you do not.
  • You cannot attack from inside your claim. Standing in your own base does not let you reach out and hit someone standing outside it.

So a fight can be started against you out in the open and then carried up to your claim — but the claim itself is a safe space. You can build in peace with your flag off and still be hit the moment you step outside.

There is no trust exception here — granting PvP trust inside a claim is switched off server-wide, so nobody can be given permission to hit you on your own land.

If you want to know how claims and trust work, see Claims and land protection.

Staff controls

All admin commands sit under /pvp admin and need operator permission.

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. 0 means instant.
/pvp admin cooldown [seconds] Show or set the combat cooldown. 0 disables it.
/pvp admin autoUnflag [minutes] Show or set the idle auto-unflag time. 0 disables it.
/pvp admin broadcast on / off Toggle the server-wide enter/leave announcements.
/pvp admin reload Re-read the config from disk — no restart needed.
/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 the restriction and restore their PvP access.

/pvp admin lock is the tool for repeat offenders: it takes away the ability to opt in at all, and only staff can undo it.

Configuration

The plugin keeps its settings in plugins/PvpOption/config.json and its per-player flags in playerdata.json next to it. Every value can also be changed live with /pvp admin …, and /pvp admin reload re-reads the file without a restart.

Flags and locks are stored per UUID, so they survive restarts and reconnects.

A note on versions

The version running here is 1.5.3, which is the Paper/Bukkit build of the plugin. The same project also ships a Fabric and NeoForge build — those are the client-side versions for playing on your own world, and they are a separate download. The server-side jar is what runs here.

Source and releases: pvpOption on Modrinth · GitHub

If you want the general plugin list

This is one of the many things running under the hood. The Plugins page covers everything else — BlueMap, the claim system, voice chat and the rest.