> For the complete documentation index, see [llms.txt](https://realisticnode.gitbook.io/rnsetups/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://realisticnode.gitbook.io/rnsetups/rncombatpvp.md).

# rnCombatPvP

Combat tag, combat log NPCs with the player's skin, PvP toggle, newbie protection, kill rewards, streaks, rating, bounties and safe zones for Spigot, Paper, Purpur and Folia.

rnCombatPvP takes care of **everything around a PvP fight**. Players who hit each other are put in combat, see the time left in the action bar and a boss bar, and can't run away with commands, teleports or a safe zone. Whoever logs out in the middle of a fight dies, or leaves **a copy of themselves with their own skin** that the others can still kill. Kills give rewards, streaks, rating and bounties, and every death comes with a recap of who did how much damage.

<figure><img src="https://i.imgur.com/V5DG3sC.png" alt="Two players fighting, with the combat timer in the action bar and the boss bar"><figcaption><p>Two players fighting, with the combat timer in the action bar and the boss bar</p></figcaption></figure>

Everything is built with the normal server API: no NMS, no packets, no Citizens and no resource pack. One jar works from 1.21.1 to 26.3.

{% hint style="info" %}
**Need help?** Join our [Discord](https://discord.gg/GzxW2FANPB) and open a ticket. See [Support](/rnsetups/support.md).
{% endhint %}

## Features

**Combat tag and what players see**

* Players are put in combat by hits, arrows and other projectiles, harmful potions, pets, and also by **TNT, end crystals, respawn anchors, beds, lava and fire** set off or placed by another player. Fighting mobs can count too.
* **Action bar** with a progress bar, the time left, the enemy and their health. A **boss bar** that turns yellow and then green as the end gets close, titles when combat starts and ends, and a **tick sound** in the last seconds.
* **Damage numbers that only the attacker sees**, red particles on hits, and **red screen edges** when a player in combat has little health.
* A **different combat time per rank** with the permission `rncombat.time.<seconds>`.
* **Commands blocked** in combat (whitelist or blacklist), and switches for ender pearls, chorus fruit, riptide, elytra, rocket boosts, totems, placing and breaking blocks, containers, teleports and any block you list.
* **Item cooldowns** (ender pearls, golden apples, wind charges...) shown on the hotbar like the vanilla cooldown, only in combat or everywhere.

**Combat log**

* Leaving in combat kills the player at once (default), or leaves an **NPC with the player's skin**, armor, items in hand and health (mannequins of 1.21.9+; older servers use a husk wearing the player's head).
* Kill it in time and it drops everything: the player is dead when they come back. If it survives, nothing happens. If the player comes back first, they **take over their body** where it stands and the fight goes on.
* Or only take money and run commands. Combat logs can also be posted on **Discord**.
* **Nobody is punished when the server stops** (`/stop`, `/restart`) or when staff kicks them.

**Protections**

* **`/pvp on|off`** with a wait between switches, and worlds where PvP is always on.
* **Newbie protection** counted in **play time**, with a boss bar and `/newbie disable` (asks to confirm).
* **Respawn protection**, **anti-clean** (after winning a fight, players who weren't in it can't hit you for a moment) and **duel lock** (nobody can join a 1v1).
* **Safe zones** (WorldGuard regions with PvP off): players in combat are pushed back, and see a **glass wall that only they can see** at the edge of the zone.

**Kills, rewards and stats**

* Money for the killer, money and experience **stolen** from the victim, and a death penalty.
* **Reward actions** with a chance: console and player commands, messages, broadcasts, titles, action bars, sounds and money.
* **Drops**: normal, kept, sent straight to the killer's inventory or removed. **Loot protection** for the killer and **heads** that drop.
* **Assists** for everyone who did enough damage, **kill streaks** with rewards, and an **ELO rating**.
* **Anti kill-farming**: the same victim again and again, or players on the same IP, give nothing.
* **Death recap** in the chat (hover a line for hits and weapon) and in a menu. Deaths in the void, in lava or by a fall right after a hit count as kills.
* Stats, K/D, best streak, rating and **top lists** in menus and placeholders.

**Bounties**

* Off by default: turn them on in `config.yml` or `/combat editor`.
* `/combatbounty <player> <amount>` (or `/bounty` when no other plugin has it), also **anonymous**. Several players can add to the same bounty.
* A **tax** for the server, announcements from an amount, and bounties that **expire and are paid back**.

**For admins**

* **In-game editor** for every option of `config.yml`, lists and item cooldowns included.
* Each player chooses in `/combat` whether they see damage numbers, the red screen, the death recap, the boss bar and the sounds.
* Stats in **SQLite or MySQL**, PlaceholderAPI placeholders, a Discord webhook and three events for developers.
* Every text in **English and Spanish**. Works on **Spigot, Paper, Purpur and Folia** from **1.21.1 to 26.3**.

## Where to start

* [Installation](/rnsetups/rncombatpvp/getting-started/installation.md)
* [First steps](/rnsetups/rncombatpvp/getting-started/first-steps.md)
* [Combat tag](/rnsetups/rncombatpvp/guides/combat-tag.md)
* [Commands and permissions](/rnsetups/rncombatpvp/reference/commands.md)