> 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/es/rnchatgames/configuration/messages.md).

# Mensajes e idiomas

Todos los textos que ven los jugadores están en `languages/<idioma>.yml`: mensajes del chat, anuncios de los juegos, títulos, boss bar, action bars, toasts, menús y el editor. Incluye inglés (`en.yml`) y español (`es.yml`). Elige uno con `language` en `config.yml`.

## Formato

* MiniMessage: `<green>`, `<#ff8800>`, `<gradient:#ff5f6d:#ffc371>`, `<bold>`, `<click:run_command:'/spawn'>`, `<hover:show_text:'Hola'>`, `<newline>`
* Clásico: `&a`, `&l`, `&#ff8800`
* `<center>` al inicio de una línea la centra en el chat (ver `chat-width` en `config.yml`).
* `{prefix}` y `{header}` vienen de `config.yml`.
* Los placeholders de PlaceholderAPI funcionan en los textos si PlaceholderAPI está instalado.

Un texto puede ser una línea o una lista de líneas:

```yaml
game-stopped: '{prefix}<gray>El juego fue detenido.'
help:
  - ''
  - '<center><gold>rnChatGames'
```

Una lista vacía (`[]`) o `''` no envía nada.

## Anuncios de los juegos

Dentro de `games:` hay un bloque `default:` y un bloque por juego. Una clave que falta en un juego usa la de `default`, así que un juego solo necesita los textos que son distintos.

| Clave                                                      | Cuándo                                                                                                                     |
| ---------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| `start`                                                    | Empieza el juego                                                                                                           |
| `correct`                                                  | Alguien gana (juegos con 1 ganador)                                                                                        |
| `correct-place`                                            | Cada puesto de un juego con varios ganadores (corto; la respuesta sale al final)                                           |
| `ended`                                                    | Fin de un juego con varios ganadores. `{podium}` en su propia línea escribe una línea por ganador (formato: `podium-line`) |
| `timeout`                                                  | Se acabó el tiempo y nadie ganó                                                                                            |
| `stopped`                                                  | Un admin usó `/rncg stop`                                                                                                  |
| `hint`                                                     | Sale la pista                                                                                                              |
| `title`, `subtitle`                                        | Título al empezar (los dos `''` = sin título)                                                                              |
| `bossbar`, `actionbar`                                     | Textos de la cuenta atrás                                                                                                  |
| `win-title`, `win-subtitle`                                | Título del ganador                                                                                                         |
| `win-others-title`, `win-others-subtitle`, `win-actionbar` | Para los demás cuando alguien gana                                                                                         |
| `toast`                                                    | Texto del aviso del ganador (`''` = sin toast en ese juego)                                                                |
| `end-title`, `end-subtitle`, `end-actionbar`               | Cuando un juego termina con ganadores                                                                                      |
| `timeout-title`, `timeout-subtitle`, `timeout-actionbar`   | Cuando se acaba el tiempo y nadie ganó                                                                                     |
| `bedrock-title`, `bedrock-content`                         | Ventana de los jugadores de Bedrock                                                                                        |

Lo que se muestra (títulos, action bars, toast) se activa y desactiva en `config.yml` → `display`.

### Placeholders de los textos de los juegos

| Placeholder                                                                     | Dónde                               |
| ------------------------------------------------------------------------------- | ----------------------------------- |
| `{game}`, `{question}`, `{answer}`, `{time_limit}`, `{max_winners}`, `{points}` | Todos los textos de los juegos      |
| `{player}`, `{display_name}`, `{time}`, `{place}`, `{place_name}`               | `correct`, `correct-place`, `win-*` |
| `{winners}`, `{podium}`                                                         | `ended`, `end-*`                    |
| `{hint}`                                                                        | `hint`                              |
| `{time_left}`                                                                   | `bossbar`, `actionbar`              |

Cada juego añade los suyos, explicados encima de su bloque: `{word}` (juegos de palabras), `{equation}` y `{difficulty}` (Matemáticas), `{equations}` (Variable), `{options}` y `{answer_letter}` (Opción Múltiple), `{target}` y `{buttons}` (Clic), `{min}` y `{max}` (Adivina el Número), `{phrase}` (Completa la Frase).

## Otras claves útiles

| Clave                                                                      | Texto                                                                                                                                                                 |
| -------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `game-names.<juego>`                                                       | Nombre de cada juego (`{game}`)                                                                                                                                       |
| `place-names`                                                              | `1.º`, `2.º`, `3.º`... (`{place_name}`)                                                                                                                               |
| `wrong-answer`, `wrong-answer-last`, `wrong-click-last`, `out-of-attempts` | Avisos sobre tus intentos                                                                                                                                             |
| `wrong-case`                                                               | "¡Casi! Revisa las mayúsculas."                                                                                                                                       |
| `guess-higher`, `guess-lower`                                              | Pistas de Adivina el Número                                                                                                                                           |
| `new-record`, `first-record`, `streak`, `streak-ended`                     | Anuncios                                                                                                                                                              |
| `pending-rewards`                                                          | Premios recibidos al entrar                                                                                                                                           |
| `next-game.*`                                                              | `/rncg next` y su placeholder                                                                                                                                         |
| `top-*`, `stats`, `logs-*`, `list-*`                                       | Versiones en texto de los comandos                                                                                                                                    |
| `menus.*`                                                                  | Todos los textos de los menús (ver [Menús](/rnsetups/es/rnchatgames/configuration/menus.md) y [Editor en el juego](/rnsetups/es/rnchatgames/configuration/editor.md)) |

## Añadir un idioma

1. Copia `languages/en.yml` como `languages/fr.yml` y tradúcelo.
2. Pon `language: fr`.
3. Si quieres, copia también `content/en.yml` como `content/fr.yml` (ver [Palabras y preguntas](/rnsetups/es/rnchatgames/configuration/content.md)).

Un idioma hecho por ti recibe los mensajes nuevos de futuras actualizaciones en inglés, así nunca falta ninguno.

## Idioma de cada jugador

Con `per-player-language: true` en `config.yml` (o `/rncg editor` → General) cada jugador recibe los mensajes, títulos, barra de jefe, action bar y menús en el idioma de su Minecraft, cuando el plugin tiene ese archivo:

* Se usa el archivo exacto (`pt_br.yml`) o la parte del idioma (`es_mx` → `es.yml`).
* Los jugadores cuyo idioma no tiene archivo ven `language`.
* La consola siempre usa `language`.
* Iguales para todos: las palabras y preguntas de los juegos (`content/`), el aviso emergente (toast) y los textos de `rewards.yml`.

{% hint style="warning" %}
Viene desactivado. Si personalizas tus textos, hazlo en todos tus archivos de idioma, o los jugadores con otro idioma en su juego verán los textos por defecto.
{% endhint %}