pvpOption

Quick rating

pvpOption

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
NeoForge
Fabric
Paper
Spigot
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

Community voices

Reviews

Versions
Loading versions…
Match includes

Click once to include, again to exclude, again to clear

Rating Any
Any 0.5 1.0 1.5 2.0 2.5 3.0 3.5 4.0 4.5 5.0
Min
Max
Play Status
Reviews
Time Played
hrs+
Verified developers only
Has developer response
List view
Grid view
Compact view
Sort by
Date
Rating
Helpful
Unhelpful
Edited
Sort ascending
Delete this review?

This removes your review from the project. You can write a new review after.
Review submitted for moderation

Your review has been sent to moderators, who will check that it meets our guidelines before it appears publicly.

No reviews yet. Be the first to review this project!

Get it on

Available Platforms

Modrinth logo Modrinth

Compatibility

Supported Environments

Dev Environment
Client Unsupported
Server Required

About

Project Details

Type
Mod
License
MIT License
Latest Version
1.5.3
Authors

For authors

Embed Badge

If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.

Custom banner text
ModDex rating badge preview

Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.

Identifiers

Platform IDs

Modrinth ID

Resources

External Links

Source Issues Wiki Discord

About

Description

pvpOption

A Minecraft mod/plugin that adds opt-in PvP flagging. Players must explicitly enable PvP before they can deal or receive damage from other players. Unflagged players are fully protected.

Branches

Branch Platform MC Version
multi_1.21.11 Fabric + NeoForge (Architectury) 1.21.11
plugin_1.21.11 Spigot, Paper, Purpur, Pufferfish 1.21.11
multi_26.x (upcoming) Fabric + NeoForge (Architectury) 26.x
plugin_26.x (upcoming) Spigot, Paper, Purpur, Pufferfish 26.x

Features

  • Opt-in PvP flagging — players choose when to engage
  • Configurable warmup period before PvP activates
  • Combat cooldown — prevents toggling off mid-fight
  • Action bar HUD showing PvP and combat status
  • Auto-unflag after configurable idle time
  • Broadcast toggle announcements to the server
  • Admin commands to force-set, lock, and unlock player flags
  • Config hot-reload without restarting the server

Note: The mod syncs the pvp= value in server.properties to match its own pvpEnabled setting on startup. The mod's config is the source of truth — editing server.properties directly has no effect.

Commands

All commands use /pvpoption (alias /pvp).

Command Description
/pvp Toggle your PvP flag
/pvp on Enable your PvP flag
/pvp off Disable your PvP flag
/pvp status Show your current PvP status
/pvp list List all flagged players

Admin (pvpoption.admin permission)

Command Description
/pvp admin Show current config values
/pvp admin enable|disable Enable or disable PvP system-wide
/pvp admin warmup <seconds> Set warmup duration (0 to disable)
/pvp admin cooldown <seconds> Set combat cooldown duration (0 to disable)
/pvp admin autounflag <minutes> Set idle auto-unflag time (0 to disable)
/pvp admin broadcast on|off Toggle flag change broadcasts
/pvp admin set <player> on|off Force-set a player's flag
/pvp admin status <player> View a player's PvP status
/pvp admin lock <player> Unflag and block a player from enabling PvP
/pvp admin unlock <player> Restore a player's ability to use PvP
/pvp admin reload [silent] Reload config from disk

Configuration

Config is written on first launch. All values can also be changed live via admin commands.

Multi-loader — config/pvpoption.json Paper plugin — plugins/pvpOption/config.json

{
  "pvpEnabled": true,
  "cooldownSeconds": 30,
  "warmupSeconds": 5,
  "broadcastToggle": true,
  "autoUnflagMinutes": 0
}
Field Default Description
pvpEnabled true Master switch for the PvP system
cooldownSeconds 30 Seconds after combat before PvP can be disabled
warmupSeconds 5 Seconds before PvP activates after opting in
broadcastToggle true Announce flag changes to all players
autoUnflagMinutes 0 Minutes of idle time before auto-disabling PvP (0 = off)

Requirements

Multi-loader: Architectury API
Paper: Paper 1.21.11+

Screenshots

Gallery

This project has no gallery images yet.

Versions

Files

Relations

Project Relations

More like this

Similar Mods

Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.

On ModDex

Community snapshot

0
Ratings
0
Followers
0
In stacks

By the numbers

Statistics

<1,000
Downloads
Last Updated
CurseForge
Modrinth
Created
Last synced
When ModDex last fetched this project from CurseForge or Modrinth. Every project is re-checked on a schedule, and any project that ships a new file is synced automatically within hours of the release.
New file updates sync automatically
How syncing works