> 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/rnkoth/guides/display.md).

# Lo que ven los jugadores

Quién ve qué (servidor, mundo, distancia, varios mundos o región de WorldGuard), boss bar, action bar, localizador, barra lateral, holograma, partículas, brillo, títulos, sonidos y nombres de mundos.

Algunas opciones son para todos los KOTHs (`config.yml` → `display`) y otras se ponen en cada KOTH (la sección `display:` de su archivo, o `/koth editor <nombre>` → **Lo que ven los jugadores**). Todos los textos están en el [archivo de idioma](/rnsetups/es/rnkoth/configuration/languages.md).

## Quién ve qué

Cada KOTH decide, parte por parte, quién la recibe: los anuncios del chat, los mensajes de captura, los títulos, los sonidos, la boss bar, la barra lateral y el localizador. Se pone en su archivo (`display.audience`) o en el juego: `/koth editor <nombre>` → **Quién lo ve** (también dentro de **Lo que ven los jugadores**).

```yaml
display:
  audience:
    announcements: server     # cuenta atrás, "empieza en", abierto, se movió, prórroga, detenido, resultados
    capture-messages: world   # está capturando, lo tomó, perdió el control, en disputa
    titles: world             # título de inicio y "X ganó" (los ganadores siempre reciben su propio título)
    sounds: world
    boss-bar: 150
    sidebar: 60               # la barra lateral de rnKoth (y %rnkoth_near%)
    locator: world            # flecha y distancia para quien está fuera
    action-bar: on            # progreso mientras estás en la zona: on / off
    discord: on               # publicar este KOTH en Discord: on / off
```

Estos son los valores de un KOTH nuevo. Cada parte acepta:

| Valor                 | Quién lo recibe                                                                                                                                                                        |
| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `server`              | Todos los jugadores conectados, en todos los mundos.                                                                                                                                   |
| `world`               | Los jugadores del mundo del KOTH.                                                                                                                                                      |
| Un número, como `150` | Los jugadores del mundo del KOTH que están hasta esa cantidad de bloques de la zona.                                                                                                   |
| `worlds:pvp,arena`    | Los jugadores de esos mundos (los que quieras, separados por comas).                                                                                                                   |
| `region:spawn`        | Los jugadores dentro de esa región de [WorldGuard](https://modrinth.com/plugin/worldguard), en el mundo del KOTH. Sin WorldGuard funciona como `world`, y la consola lo avisa una vez. |
| `off`                 | Nadie.                                                                                                                                                                                 |

* Antes de un evento (avisos, cuenta atrás, "no hay suficientes jugadores") las distancias se miden hasta la zona donde empezará el evento.
* La consola siempre recibe los anuncios, incluso con `off`.
* Los ganadores siempre ven su propio título `¡VICTORIA!`. `titles` es para el título de inicio y el de "X ganó" que ven los demás.
* El localizador solo apunta dentro de un mundo: quien está en otro mundo nunca recibe flecha, ni siquiera con `server`.
* `config.yml` puede seguir desactivando la barra lateral, el localizador, la action bar y los títulos en todos los KOTHs (`display.sidebar: false`...).
* Un valor que no se entiende se avisa en la consola, y esa parte funciona como antes (ver abajo).

### En el editor

`/koth editor <nombre>` → **Quién lo ve** tiene un botón por parte. El botón dice qué es esa parte y quién la recibe ahora ("Todo el servidor", "Este mundo", "A 150 bloques", "Mundos: pvp, arena", "Región: spawn", "Desactivado").

| Clic                     | Hace                                                                                                                                                                            |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Clic izquierdo           | Siguiente: todo el servidor → este mundo → una distancia → desactivado                                                                                                          |
| Clic derecho             | Al revés                                                                                                                                                                        |
| Shift + clic izq. / der. | Distancia +50 / -50 bloques                                                                                                                                                     |
| `Q` (tecla de soltar)    | Escribe cualquier valor en el chat: `250`, `worlds:pvp,arena`, `region:spawn`... Un mundo o una región que no existen, o una región sin WorldGuard, se rechazan con un mensaje. |

La action bar y Discord son on/off: clic para cambiar.

### Ejemplos

**Anunciarlo a todo el servidor, pero mostrar el marcador solo cerca del KOTH.** Todos se enteran de que abrió y de quién ganó; solo los que están cerca de la pelea reciben la barra lateral y la boss bar, y los que están lejos siguen con su propio marcador:

```yaml
display:
  audience:
    announcements: server
    capture-messages: 150
    titles: world
    sounds: 150
    boss-bar: 150
    sidebar: 60
    locator: world
```

**Solo un mundo.** Un KOTH en un mundo de PvP del que el resto del servidor no se entera:

```yaml
display:
  audience:
    announcements: world
    capture-messages: world
    titles: world
    sounds: world
    boss-bar: world
    sidebar: 100
    locator: world
```

Para incluir otros mundos, como el spawn donde esperan los jugadores: `announcements: worlds:world_pvp,spawn`.

**Solo una región de WorldGuard.** Todo se queda dentro de la región arena (quien está fuera no ve ni oye nada), y el inicio se sigue anunciando a todos:

```yaml
display:
  audience:
    announcements: server
    capture-messages: region:arena
    titles: region:arena
    sounds: region:arena
    boss-bar: region:arena
    sidebar: region:arena
    locator: 'off'
```

### Con TAB u otro plugin de scoreboard

La barra lateral de rnKoth solo reemplaza el marcador de los jugadores que están en `audience.sidebar`. En cuanto un jugador sale (se aleja, cambia de mundo, se teletransporta, termina el evento), recupera su propio marcador.

`%rnkoth_near%` vale `yes` justo para esos jugadores, así que tu plugin de scoreboard puede apartarse mientras sale el nuestro. En TAB (`config.yml` → `scoreboard` → `scoreboards`):

```yaml
scoreboard:
  scoreboards:
    koth:
      # Tu propio marcador del KOTH mientras el jugador está cerca de un KOTH en curso
      # (con la barra lateral de rnKoth desactivada: display.sidebar: false en el config.yml de rnKoth)
      display-condition: "%rnkoth_near%=yes"
      title: "<gold>KOTH"
      lines:
        - "&7KOTH: &f%rnkoth_current_name%"
        - "&7Domina: &e%rnkoth_current_holder%"
        - "&7Progreso: &a%rnkoth_current_progress%"
        - "&7Tiempo: &f%rnkoth_current_time_left%"
    normal:
      # Tu marcador de siempre: se oculta mientras sale la barra lateral de rnKoth
      display-condition: "%rnkoth_near%=no"
      title: "Mi servidor"
      lines: [...]
```

Usa solo `normal` para quedarte con la barra lateral de rnKoth, o los dos con la de rnKoth desactivada para mostrar el KOTH con el estilo de TAB.

### Archivos de KOTH antiguos

Los archivos creados antes de la 1.0.1 no tienen `display.audience`; siguen funcionando como antes:

| Ajuste antiguo                                       | Funciona como                                                                         |
| ---------------------------------------------------- | ------------------------------------------------------------------------------------- |
| `display.radius: 0`                                  | Anuncios, mensajes de captura, títulos y sonidos: `server`. Boss bar: `world`.        |
| `display.radius: 300`                                | Todos: `300`.                                                                         |
| `display.boss-bar: false` / `display.locator: false` | `boss-bar: off` / `locator: off`                                                      |
| Barra lateral y localizador                          | `sidebar-radius` / `locator-radius` de `config.yml` (y `display.radius` si es menor). |

Al cambiar cualquier parte en el editor se añade `display.audience` con esa parte al archivo; las partes que aún no están siguen funcionando como antes.

## Boss bar

```yaml
display:
  audience:
    boss-bar: 150
  boss-bar-color: YELLOW
```

Una barra arriba de la pantalla mientras el KOTH está en curso (para los jugadores de `audience.boss-bar`), con quien domina, el progreso y el tiempo restante. La barra se llena con el progreso de quien domina (o del mejor bando cuando nadie lo domina).

Colores: `PINK`, `BLUE`, `RED`, `GREEN`, `YELLOW`, `PURPLE`, `WHITE`. Se pone **roja** mientras el KOTH está en disputa (no con `contested: holder`, donde el que lo domina sigue avanzando).

Textos (`bossbar` en el archivo de idioma): `waiting` (nadie lo domina), `capturing`, `score`, `contested`, `draining`, `defending` y `defending-score` (`contested: holder`: "Castillo » Alex 45% (se defiende de 2)") y `overtime`. Con `per-player-language: true`, cada jugador la ve en su propio idioma.

`draining` es el tira y afloja de `capture.on-leave: pause` o `drain`: un bando que entra primero baja el progreso que dejó otro, y la barra lo dice (`Castillo » Rex le quita progreso a Steve 30% | 8:12`) en lugar de mostrar al recién llegado con 0%.

## Action bar dentro de la zona

`config.yml` → `display.action-bar: true`

Mientras un jugador está en un KOTH en curso, el texto encima de la barra rápida muestra:

| Situación                                       | Texto (`hud` en el archivo de idioma)                                     |
| ----------------------------------------------- | ------------------------------------------------------------------------- |
| Tu bando está capturando                        | `⚑ Capturando ■■■■□□ 45% • faltan 66s • 8:12` (`you-capture`)             |
| Tu bando lo domina en modo puntos               | `⚑ +1 punto/s ...` (`you-score`)                                          |
| Otro bando lo domina                            | `⚔ Steve domina el KOTH ... ¡sácalos!` (`enemy`)                          |
| En disputa                                      | `⚔ EN DISPUTA ⚔ • nadie avanza` (`contested`)                             |
| Tu bando está bajando el progreso de otro bando | `⬇ Bajando el progreso de Alex 30%...` (`draining`)                       |
| No cuentas                                      | La razón: AFK, modo de juego, invisible, acabas de morir (`not-counting`) |

<figure><img src="https://1485480385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQaixEy8lxLssO2tL4Sxc%2Fuploads%2FTtZNnmItX4Nai1LY9E1U%2Frnkoth-es-holding.png?alt=media" alt="Dentro de la zona: el progreso en la action bar y en la boss bar, y la barra lateral a la derecha"><figcaption><p>Dentro de la zona: el progreso en la action bar y en la boss bar, y la barra lateral a la derecha</p></figcaption></figure>

### Estilo de progreso

Cómo se ve el progreso en cualquier texto que use el placeholder `{meter}`. Por defecto, eso es la action bar dentro de la zona y el holograma:

```yaml
display:
  progress-style: both    # bar, percent o both
  progress-bar:
    length: 10            # de 1 a 40 símbolos
    symbol: '■'
    filled: '<green>'
    empty: '<dark_gray>'
```

| Estilo               | Modo captura     | Modo puntos          |
| -------------------- | ---------------- | -------------------- |
| `bar`                | `■■■■□□□□□□`     | `■■■■□□□□□□`         |
| `percent`            | `45%`            | `120/300`            |
| `both` (por defecto) | `■■■■□□□□□□ 45%` | `■■■■□□□□□□ 120/300` |

`{bar}` siempre es solo la barra, y `{percent}` solo el porcentaje, sea cual sea el estilo.

## Localizador

```yaml
# config.yml
display:
  locator: true
  locator-radius: 0
```

Los jugadores **fuera** de un KOTH en curso ven en la action bar su nombre, una flecha que apunta hacia él, la distancia y quién lo domina:

```
Spawn ⬈ 85m | Steve 45% | 8:12
```

Igual que la barra de jefe, dice cuando nadie lo domina (`Spawn ⬈ 85m | KOTH libre | 8:12`, `hud.locator-free`), cuando está en disputa (`EN DISPUTA`, `hud.locator-contested`), durante un tira y afloja (`Rex le quita progreso a Steve 30%`, `hud.locator-draining`) y mientras el que lo domina lo defiende (`(se defiende de 2)`, `hud.locator-defending`).

* La flecha gira cuando el jugador gira.
* Muestra el KOTH en curso más cercano cuyo `display.audience.locator` incluye al jugador, en el mismo mundo.
* `display.locator: false` en `config.yml` lo desactiva en todos los KOTHs.
* `locator-radius` solo lo usan los archivos de KOTH sin `audience.locator` (archivos antiguos): solo lo ven los jugadores que están así de cerca (`0` = todos en el mismo mundo).
* Los jugadores pueden desactivarlo para ellos con `/koth hud`.

Dentro de la zona, la action bar muestra el progreso en su lugar.

## Barra lateral

```yaml
# config.yml
display:
  sidebar: true
  sidebar-radius: 120
```

Un scoreboard a la derecha para los jugadores del `display.audience.sidebar` del KOTH (60 bloques en un KOTH nuevo). `sidebar-radius` solo lo usan los archivos de KOTH que no lo tienen (archivos antiguos; `0` = todos en el mundo), y `sidebar: false` la desactiva en todos los KOTHs. Los KOTHs de captura muestran quién domina, el progreso, el tiempo restante y los jugadores dentro; los KOTHs de puntos muestran el top 3. Los dos muestran el tiempo y las bajas del propio jugador. Hasta 15 líneas (`sidebar` en el archivo de idioma).

Cada jugador recibe su propio scoreboard mientras está en la audiencia de la barra lateral, y recupera al instante su scoreboard anterior cuando sale de ella (se aleja, cambia de mundo, se teletransporta) o termina el evento. Los jugadores pueden desactivarla con `/koth hud`.

{% hint style="warning" %}
**¿Usas otro plugin de scoreboard** (TAB, AnimatedScoreboard, FeatherBoard...)? Si dos plugins pelean por la barra lateral, parpadea o desaparece. Oculta el tuyo mientras `%rnkoth_near%` vale `yes` (ver [Con TAB u otro plugin de scoreboard](#con-tab-u-otro-plugin-de-scoreboard)), o pon `display.sidebar: false` y muestra el KOTH en tu propio scoreboard con los [placeholders](/rnsetups/es/rnkoth/reference/placeholders.md), por ejemplo `%rnkoth_current_name%`, `%rnkoth_current_holder%`, `%rnkoth_current_progress%` y `%rnkoth_current_time_left%`.
{% endhint %}

{% hint style="info" %}
En **Folia** no hay barra lateral (Folia todavía no soporta scoreboards). Usa los placeholders en un plugin de scoreboard que funcione en Folia.
{% endhint %}

## Holograma

```yaml
display:
  hologram: true
  hologram-height: 3.5
```

Un texto flotante sobre el centro de la zona, a `hologram-height` bloques del suelo. No hace falta ningún otro plugin. Muestra:

* **En espera**: el nombre y cuándo empieza el próximo evento (`hologram.idle`).
* **Cuenta atrás**: `Abre en 8s` (`hologram.starting`).
* **En curso**: quién domina, el progreso y el tiempo restante (`hologram.running`).
* **Tira y afloja** (`on-leave: pause` / `drain`): quién baja el progreso de quién (`hologram.draining`).
* **Defendiendo** (`contested: holder`): quién lo domina y cuántos jugadores de otros bandos hay dentro (`hologram.defending`).

El holograma no se guarda con el mundo, así que un crash nunca deja copias. Aparece cuando se carga el chunk. Un KOTH desactivado no tiene holograma mientras no está en curso. Con varias zonas, el holograma está en la zona donde empieza el próximo evento mientras espera, y sigue al KOTH mientras está en curso.

<figure><img src="https://1485480385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQaixEy8lxLssO2tL4Sxc%2Fuploads%2FlZG0rucO6bKPeeHbPMwt%2Frnkoth-es-idle.png?alt=media" alt="Un KOTH en espera: el holograma muestra cuándo empieza el próximo evento"><figcaption><p>Un KOTH en espera: el holograma muestra cuándo empieza el próximo evento</p></figcaption></figure>

## Partículas del borde

`display.border-particles: true` dibuja el borde de la zona en el suelo mientras el KOTH está en curso, para los jugadores que están hasta a 48 bloques. Cada jugador ve el color que le importa:

| Color   | Significado                                                                                       |
| ------- | ------------------------------------------------------------------------------------------------- |
| Blanco  | Nadie lo domina                                                                                   |
| Verde   | Tu bando lo domina                                                                                |
| Naranja | Otro bando lo domina                                                                              |
| Rojo    | En disputa (con `contested: holder` se mantienen los colores de quien lo domina: verde y naranja) |

## Brillo de quien domina

`display.glow-holder: true`: los jugadores del bando que domina el KOTH brillan, así todos ven a quién sacar. El brillo se quita cuando dejan de dominarlo, y también al entrar si el servidor se cayó mientras brillaban.

## Títulos

`config.yml` → `display.titles: true` (desactivado = ningún KOTH muestra títulos). Quién los ve: `display.audience.titles` de cada KOTH.

* Cuando se abre un KOTH: `REY DE LA COLINA` y la ubicación (`event.started-title`, `event.started-subtitle`).
* Cuando alguien gana: los ganadores ven `¡VICTORIA!` (`event.you-won-title`) y todos los demás ven quién lo conquistó (`event.won-title`).

Los premios por defecto del ganador no tienen una línea `[title]`, así que los ganadores ven un solo título. Si añades tu propio premio `[title]`, pon `display.titles: false` o verán dos.

`events.winner-fireworks: true` lanza un espectáculo de fuegos artificiales sobre el KOTH cuando alguien gana. Los fuegos artificiales nunca hacen daño a nadie.

<figure><img src="https://1485480385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQaixEy8lxLssO2tL4Sxc%2Fuploads%2FpLFohrPRtrHzd8Cm4xr1%2Frnkoth-es-victory.png?alt=media" alt="El título ¡VICTORIA! y los fuegos artificiales sobre el KOTH"><figcaption><p>El título ¡VICTORIA! y los fuegos artificiales sobre el KOTH</p></figcaption></figure>

## Sonidos

```yaml
# config.yml
display:
  sounds:
    start: 'block.bell.use'
    countdown: 'block.note_block.hat'
    capture-start: 'block.beacon.activate'
    capture-lost: 'block.beacon.deactivate'
    contested: 'block.note_block.bass'
    win: 'ui.toast.challenge_complete'
    moved: 'entity.enderman.teleport'
```

| Sonido          | Cuándo                                     |
| --------------- | ------------------------------------------ |
| `start`         | Se abre el KOTH                            |
| `countdown`     | Cada anuncio de la cuenta atrás            |
| `capture-start` | Un bando empieza a capturar o toma el KOTH |
| `capture-lost`  | Quien domina sale y no queda nadie dentro  |
| `contested`     | El KOTH queda en disputa                   |
| `win`           | Alguien gana                               |
| `moved`         | Un KOTH itinerante se mueve a otra zona    |

Usa cualquier clave de sonido de Minecraft. `''` desactiva un sonido. Quién los oye: `display.audience.sounds` de cada KOTH.

## Nombres de los mundos

Los mensajes muestran el mundo con `{world}`. Para mostrar un nombre más bonito:

```yaml
# config.yml
world-names:
  world: Spawn
  world_pvp: '/warp pvp'
```

O solo para un KOTH, en su archivo (o editor → Lo que ven los jugadores → **Nombre del mundo**):

```yaml
display:
  world-name: 'La Arena'
```

El nombre propio del KOTH tiene prioridad sobre `world-names`. `{world_id}` siempre es el nombre real del mundo.

## Mensajes en el chat

Todos los mensajes del chat (inicio, cuenta atrás, captura, en disputa, movimiento, tiempo extra, resultados) están en el archivo de idioma, en `event`, `capture` y `results`. Pon cualquiera en `''` para desactivarlo. Ver [Idiomas y textos](/rnsetups/es/rnkoth/configuration/languages.md).