Installation

Get ConsentPVP running on your server in a few minutes.

Requirements

Requirement	Detail
Server software	Paper
API version	1.20
Built against	Paper API 1.21.5-R0.1-SNAPSHOT
Java	21

---

Install Steps

1. Build or download the ConsentPVP jar.
2. Place the jar in your server's plugins/ directory.
3. Restart the server. ConsentPVP generates its data folder, default config.yml, and playerdata.yml on first run.
4. (Optional) Edit plugins/ConsentPVP/config.yml to taste.
5. Run /pvp reload — or restart the server — to apply your changes.

After first start you should see:

plugins/
└── ConsentPVP/
    ├── config.yml
    └── playerdata.yml

---

Quick Start

For most servers the defaults are sensible. A typical first pass:

1. Open plugins/ConsentPVP/config.yml.
2. Decide how long the toggle cooldown should be with cooldown.duration (default 5 minutes).
3. Choose whether consent should reset on death with pvp.disable-on-death (default false).
4. Decide whether to show nametag indicators with indicators.enabled (default true).
5. Run /pvp reload to apply changes without restarting.

Test it: have two players each run /pvp enable, then try to fight. With either player disabled, the attack is blocked.

---

Building from Source

ConsentPVP is a Maven project.

Setting	Value
Artifact ID	consentpvp
Main class	org.modularsoft.consentpvp.ConsentPVP
Java source/target	21
Paper API	1.21.5-R0.1-SNAPSHOT

Build the jar:

mvn clean package

The compiled jar is produced in the target/ directory. Drop that jar into your server's plugins/ directory.