> 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/reference/commands.md).

# Commands and permissions

Every command and permission of rnCombatPvP.

The main command is `/combat`, also `/rncombat`, `/rncombatpvp` and `/cpvp`. Other commands: `/pvp` (`/togglepvp`, `/pvptoggle`), `/combattag` (`/ct`, `/combatlog`), `/newbie` (`/grace`) and `/combatbounty`. `/bounty` is added as a short name of `/combatbounty` when bounties are on and no other plugin (NotBounties, for example) already has `/bounty`.

## Players

| Command                                             | What it does                                                            | Permission                                                   |
| --------------------------------------------------- | ----------------------------------------------------------------------- | ------------------------------------------------------------ |
| `/combat`                                           | The player menu                                                         | `rncombat.menu`                                              |
| `/combat help`                                      | The list of commands                                                    | everyone                                                     |
| `/combat stats [player]`                            | PvP stats                                                               | `rncombat.stats` (another player's: `rncombat.stats.others`) |
| `/combat top [kills\|kdr\|streak\|rating\|assists]` | Top players                                                             | `rncombat.top`                                               |
| `/combat bounties`                                  | The bounties menu                                                       | everyone                                                     |
| `/combat recap [chat]`                              | Your last death, in a menu or in the chat                               | `rncombat.menu`                                              |
| `/combat prefs`                                     | Your own settings (damage numbers, red screen, recap, boss bar, sounds) | `rncombat.menu`                                              |
| `/pvp [on\|off]`                                    | Switches your PvP (without a value: the other way)                      | `rncombat.pvp`                                               |
| `/pvp status`                                       | Tells you if your PvP is on                                             | `rncombat.pvp`                                               |
| `/ct`                                               | How long you stay in combat                                             | everyone                                                     |
| `/newbie`                                           | Time left of your newbie protection                                     | everyone                                                     |
| `/newbie disable`                                   | Ends your newbie protection (asks to confirm)                           | `rncombat.newbie.disable`                                    |
| `/combatbounty` or `/combatbounty list`             | The bounties menu                                                       | everyone                                                     |
| `/combatbounty <player>`                            | The bounty on a player                                                  | everyone                                                     |
| `/combatbounty <player> <amount> [anon]`            | Puts a bounty                                                           | `rncombat.bounty`                                            |

All player permissions are in `rncombat.player`, given to everyone by default.

## Admins

| Command                                                            | What it does                                                                                                              | Permission               |
| ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------- | ------------------------ |
| `/combat editor`                                                   | Editor of `config.yml`                                                                                                    | `rncombat.editor`        |
| `/combat reload`                                                   | Reads every file again                                                                                                    | `rncombat.reload`        |
| `/combat tag <player> [seconds]`                                   | Puts a player in combat                                                                                                   | `rncombat.tag`           |
| `/combat untag <player\|all>`                                      | Takes a player (or everyone) out of combat                                                                                | `rncombat.tag`           |
| `/combat status [player]`                                          | One line with everything about a player: combat, enemies, PvP, newbie, stats, pending punishment, bounty... (for support) | `rncombat.tag`           |
| `/combattag <player>`                                              | How long a player stays in combat                                                                                         | `rncombat.tag`           |
| `/combat resetstats <player>`                                      | Sets a player's stats to zero and their rating to the start value                                                         | `rncombat.stats.reset`   |
| `/combat open <main\|stats\|top\|bounties\|recap\|prefs> <player>` | Opens a menu for a player (NPCs, menu plugins, console)                                                                   | `rncombat.open`          |
| `/combat version`                                                  | Installed and newest version                                                                                              | `rncombat.update`        |
| `/pvp <on\|off> <player>`                                          | Sets someone's PvP (also skips the wait of your own `/pvp`)                                                               | `rncombat.pvp.others`    |
| `/newbie give <player> [minutes]`                                  | Gives newbie protection again                                                                                             | `rncombat.newbie.manage` |
| `/newbie remove <player>`                                          | Ends someone's newbie protection                                                                                          | `rncombat.newbie.manage` |
| `/newbie <player>` or `/newbie check <player>`                     | Someone's newbie time left                                                                                                | `rncombat.newbie.manage` |
| `/combatbounty remove <player>`                                    | Removes a bounty and pays everyone back                                                                                   | `rncombat.bounty.remove` |

## Permissions

| Permission                                 | Default  | What it gives                                                                               |
| ------------------------------------------ | -------- | ------------------------------------------------------------------------------------------- |
| `rncombat.player`                          | everyone | Every player permission below                                                               |
| `rncombat.menu`                            | everyone | `/combat`, recap and settings                                                               |
| `rncombat.pvp`                             | everyone | `/pvp on\|off` for yourself                                                                 |
| `rncombat.newbie.disable`                  | everyone | `/newbie disable`                                                                           |
| `rncombat.bounty`                          | everyone | Put money on another player's head                                                          |
| `rncombat.stats` / `rncombat.stats.others` | everyone | `/combat stats` / `/combat stats <player>`                                                  |
| `rncombat.top`                             | everyone | `/combat top`                                                                               |
| `rncombat.admin`                           | op       | Every permission of rnCombatPvP, **except the bypasses**                                    |
| `rncombat.editor`                          | op       | `/combat editor`                                                                            |
| `rncombat.reload`                          | op       | `/combat reload`                                                                            |
| `rncombat.tag`                             | op       | `/combat tag`, `untag`, `status`, `/combattag <player>`                                     |
| `rncombat.pvp.others`                      | op       | `/pvp <on\|off> <player>`, no wait between switches                                         |
| `rncombat.newbie.manage`                   | op       | `/newbie give\|remove <player>`                                                             |
| `rncombat.bounty.remove`                   | op       | `/combatbounty remove <player>`                                                             |
| `rncombat.stats.reset`                     | op       | `/combat resetstats <player>`                                                               |
| `rncombat.open`                            | op       | `/combat open <menu> <player>`                                                              |
| `rncombat.update`                          | op       | Update notices and `/combat version`                                                        |
| `rncombat.time.<seconds>`                  | -        | A different combat time, for example `rncombat.time.10`. The lowest one a player has counts |

## Bypass permissions

Bypasses are **not given to operators** and are not part of `rncombat.admin`. Give them one by one, or all with `rncombat.bypass.*`, to staff that must never be stopped by the plugin.

| Permission                     | What it does                                                     |
| ------------------------------ | ---------------------------------------------------------------- |
| `rncombat.bypass.*`            | Every bypass below                                               |
| `rncombat.bypass.tag`          | Never put in combat                                              |
| `rncombat.bypass.commands`     | Any command while in combat                                      |
| `rncombat.bypass.restrictions` | Pearls, elytra, blocks, containers, teleports... while in combat |
| `rncombat.bypass.cooldowns`    | No item cooldowns                                                |
| `rncombat.bypass.combatlog`    | Leaving in combat is not punished                                |
| `rncombat.bypass.disable`      | Fly and game mode are not changed when combat starts             |
| `rncombat.bypass.safezone`     | Can enter safe zones while in combat                             |
| `rncombat.bypass.farm`         | Kill farming limits do not apply                                 |

## For NPCs and menu plugins

`/combat open <menu> <player>` opens a menu for a player, from the console or another plugin. For example, a Citizens NPC that opens the top list (`<p>` is the player who clicks it in Citizens):

```
/npc command add combat open top <p>
```