> 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/configuration/languages.md).

# Languages and texts

Change any text, or translate rnCombatPvP to your language.

Every text is in `languages/en.yml` and `languages/es.yml`. Pick one with `language` in `config.yml`.

* Colors: MiniMessage (`<gold>`, `<#ff8800>`, `<gradient:red:gold>`) or `&` codes (`&6`, `&#ff8800`).
* A message can be one line or a list of lines; `''` or `[]` turns it off.
* `{prefix}` is the prefix at the top of the file, and `{@words.x}` inserts another text of the same file.
* PlaceholderAPI placeholders work in the texts.

## Your own language

1. Copy `en.yml` to `languages/fr.yml` (any name).
2. Translate it. Texts you have not translated yet show in English, and texts added by new versions are written into your file in English.
3. Set `language: fr`, or turn on `per-player-language` so each player sees the language of their client.

## Where each text is

| Section                       | Texts                                                                                                                    |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| `combat`                      | Entering and leaving combat, titles, **action bar**, **boss bar**, colors of the progress bar, `/ct`                     |
| `combat-log`                  | The broadcast, the **name over the NPC** (`npc-name`, `&` colors) and the messages when the body is killed or taken back |
| `restricted`, `cooldown`      | What players see when something is blocked or an item is cooling down                                                    |
| `protect`, `pvp`, `newbie`    | Protected players, `/pvp` and newbie protection (with its boss bar)                                                      |
| `kills`, `recap`, `indicator` | Kill messages, the death recap (with its hover) and the damage numbers                                                   |
| `bounty`                      | Every bounty message                                                                                                     |
| `discord`                     | Messages posted on Discord (no colors)                                                                                   |
| `command`, `input`, `update`  | Command replies, chat questions, update notices                                                                          |
| `editor`                      | Names and descriptions of every option in `/combat editor`                                                               |
| `menus`                       | Titles, names and lore of every menu                                                                                     |

## The action bar and the boss bar

```yaml
combat:
  # {bar} = progress bar, {time} = seconds left, {enemy} and {enemy_health} = last enemy
  action-bar: "<red>⚔ <gray>{bar} <white>{time}s <dark_gray>| <gray>{enemy} <red>{enemy_health}❤"
  action-bar-alone: "<red>⚔ <gray>{bar} <white>{time}s"
  boss-bar: "<red><bold>COMBAT</bold> <gray>- <white>{time}s <gray>- don't log out"
  bar-left: "<red>"
  bar-passed: "<dark_gray>"
```

`action-bar-alone` is used when there is no enemy (a player put in combat by a command). `bar-left` and `bar-passed` are the colors of the time left and the time passed.

## Titles

The titles of `combat.title-enter` and `combat.title-leave` only have a subtitle by default; write a text in `title` to get a big title too.