> 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/reference/placeholders.md). # Placeholders Placeholders de PlaceholderAPI para scoreboards, listas de tab y hologramas, y los placeholders de cada mensaje. ## PlaceholderAPI Con [PlaceholderAPI](https://modrinth.com/plugin/placeholderapi) instalado, rnKoth registra los placeholders `%rnkoth_...%` automáticamente (no hace falta descargar nada de eCloud). Úsalos en scoreboards, listas de tab, hologramas y otros plugins. Los textos se dan sin colores y en el idioma del servidor (`language`). Los nombres de los KOTHs son los nombres de sus archivos (`spawn` para `koths/spawn.yml`). ### Cualquier KOTH | Placeholder | Ejemplo | | | ----------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------- | | `%rnkoth_running%` | `1` | Cuántos KOTHs están en curso | | `%rnkoth_near%` | `yes` | `yes` cuando el jugador está en la audiencia de la barra lateral (`display.audience.sidebar`) de un KOTH en curso, y si no `no` (ver abajo) | | `%rnkoth_next_name%` | `Spawn` | Nombre visible del KOTH que empieza antes por su horario | | `%rnkoth_next_id%` | `spawn` | Su nombre | | `%rnkoth_next_time%` | `2h 5m` | Tiempo hasta que empieza | | `%rnkoth_next_seconds%` | `7500` | Lo mismo, en segundos | | `%rnkoth_hud%` | `on` | `on` u `off`: si el jugador tiene activados el localizador y la barra lateral (`/koth hud`) | Cuando no hay ningún KOTH programado, los placeholders `next_` muestran `Ninguno` (`words.none` en el archivo de idioma). ### Un KOTH: `%rnkoth__%` Por ejemplo `%rnkoth_spawn_holder%`. Usa `current` en lugar del nombre para el KOTH en curso más cercano al jugador, en su mundo (o el primero en curso si no hay ninguno en su mundo): `%rnkoth_current_holder%`. Es útil para una línea del scoreboard que sirve para todos los KOTHs. | Valor | Ejemplo | En curso | Sin estar en curso | | ------------- | ----------------- | ---------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ | | `name` | `Spawn` | Nombre visible | Nombre visible | | `mode` | `Captura` | `Captura` o `Puntos` | Lo mismo | | `status` | `en curso` | `en curso` | `iniciando`, `desactivado` o `en espera` | | `next` | `2h 5m` | Tiempo hasta el próximo inicio programado | Lo mismo, o `Ninguno` | | `world` | `Spawn` | Mundo de la zona actual, con su nombre visible (`display.world-name` o `world-names`, como `{world}`) | Lo mismo, para la zona donde empieza el próximo evento | | `world_name` | `world` | Nombre real de ese mundo | Lo mismo | | `x`, `y`, `z` | `120` | Centro de la zona actual | Centro de la zona donde empieza el próximo evento | | `holder` | `Steve` | Jugador o equipo que avanza ahora, o `Ninguno` | `Ninguno` | | `leader` | `Steve` | Quien domina, o el mejor bando cuando nadie domina | `Ninguno` | | `percent` | `45` | Progreso del líder, de 0 a 100 | `0` | | `progress` | `45%` / `120/300` | Progreso (captura) o puntos / meta (puntos) | `0%` | | `points` | `120` | Puntos del líder (modo puntos) | `0` | | `time_left` | `8:12` | Tiempo restante (el tiempo extra restante durante el tiempo extra, como `{time_left}`). `Sin límite` con `duration: 0` | `0:00` (`Sin límite` con `duration: 0`) | | `elapsed` | `6:48` | Tiempo desde que se abrió | `0:00` | | `inside` | `3` | Jugadores dentro que cuentan | `0` | | `players` | `7` | Jugadores que participaron | `0` | | `distance` | `16` | Bloques desde el jugador hasta la zona (`-` en otro mundo) | `-` | | `your_time` | `1:30` | Tiempo que estuvo dentro el jugador que lo ve | `0:00` | Con `current_` y ningún KOTH en curso, `status` muestra `en espera` y los demás valores muestran `Ninguno`. ### Nombres que no puedes usar Un nombre de KOTH no puede ser una de las primeras palabras de estos placeholders, o se mezclarían: `running`, `current`, `next`, `top`, `hud`, `wins`, `captures`, `events`, `time`, `time_formatted`, `kills`, `king`, `king_kills`, `near`, ni empezar por `top_`, `next_` o `current_`. `/koth create` y el editor los rechazan con un mensaje. Un archivo con uno de esos nombres que creaste a mano igual se carga, con un aviso en la consola. ### Mostrar un scoreboard solo cerca del KOTH (TAB y otros) `%rnkoth_near%` vale `yes` mientras el jugador está en la **audiencia de la barra lateral** de un KOTH en curso (`display.audience.sidebar` en su archivo, 60 bloques en un KOTH nuevo; ver [Quién ve qué](https://realisticnode.gitbook.io/rnsetups/es/rnkoth/reference/pages/dB0L8q0dtvCgpZK0Y9Uj#quién-ve-qué)), y si no `no`. Son justo los jugadores que reciben la barra lateral de rnKoth: con `sidebar: server` vale `yes` en todas partes, con `world` en el mundo del KOTH, con `60` hasta 60 bloques de la zona, con `off` nunca. Los archivos de KOTH que no lo tienen (archivos antiguos) usan `display.sidebar-radius` de `config.yml` (0 = a cualquier distancia en ese mundo). No depende de `display.sidebar` de `config.yml` ni de `/koth hud`, así que también funciona con la barra lateral de rnKoth desactivada. Úsalo como condición en tu plugin de scoreboard, así el scoreboard del KOTH solo sale cerca del evento y el tuyo normal vuelve cuando el jugador se aleja o cambia de mundo. Por ejemplo en TAB (`plugins/TAB/config.yml` → `scoreboard` → `scoreboards`): ```yaml koth: # Tu marcador del KOTH (con display.sidebar: false en el config.yml de rnKoth) display-condition: "%rnkoth_near%=yes" normal: # Tu marcador de siempre, oculto mientras sale la barra lateral de rnKoth display-condition: "%rnkoth_near%=no" ``` ### Estadísticas del jugador que lo ve | Placeholder | | | ------------------------- | ------------------------------------------------------------------------------------------------------------------------- | | `%rnkoth_wins%` | Victorias | | `%rnkoth_captures%` | Eventos en los que el jugador tomó el control de un KOTH | | `%rnkoth_events%` | Eventos jugados | | `%rnkoth_time%` | Tiempo dominando, en segundos | | `%rnkoth_time_formatted%` | Tiempo dominando, como `1:02:05` | | `%rnkoth_kills%` | Bajas durante eventos en las que el que mata o la víctima estaba dentro de la zona (las bajas de un compañero no cuentan) | | `%rnkoth_king_kills%` | Bajas al rey | ### Tops | Placeholder | | | -------------------------------------- | -------------------------------------------------------------- | | `%rnkoth_top___name%` | Nombre en esa posición, por ejemplo `%rnkoth_top_wins_1_name%` | | `%rnkoth_top___value%` | Valor en esa posición, por ejemplo `%rnkoth_top_wins_1_value%` | Estadísticas: `wins`, `captures`, `events`, `time`, `kills`, `king_kills`. Posiciones de 1 a 10. Una posición vacía muestra `-` como nombre y `0` como valor. Los tops se vuelven a leer cada minuto y después de cada evento. ### Ejemplo de scoreboard ``` &6&lKOTH &7Nombre: &f%rnkoth_current_name% &7Domina: &e%rnkoth_current_holder% &7Progreso: &a%rnkoth_current_progress% &7Restante: &f%rnkoth_current_time_left% &7 &7Próximo: &f%rnkoth_next_name% &7en &f%rnkoth_next_time% &7Tus victorias: &f%rnkoth_wins% ``` ## Placeholders dentro de los mensajes Los textos del archivo de idioma y de los archivos de KOTH usan placeholders `{...}`. Cada mensaje del archivo de idioma indica los que puede usar. Estos son todos: **Todos los mensajes de un KOTH** | Placeholder | Valor | | ------------------- | --------------------------------------------------------------------- | | `{prefix}` | El `prefix` del archivo de idioma | | `{koth}` | Nombre del KOTH (nombre del archivo) | | `{koth_name}` | Nombre visible, con colores | | `{mode}` | `Captura` o `Puntos` | | `{duration}` | Duración del evento, como `15:00` (`Sin límite` con `duration: 0`) | | `{overtime}` | Tiempo extra, como `1:00` | | `{target}` | Puntos para ganar (puntos) o tiempo de captura (captura) | | `{world}` | Nombre del mundo, o el nombre de `world-names` / `display.world-name` | | `{world_id}` | Nombre real del mundo | | `{x}`, `{y}`, `{z}` | Centro de la zona (antes de un evento: la zona donde empezará) | **Mientras el KOTH está en curso** | Placeholder | Valor | | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `{holder}` | Jugador o equipo que avanza ahora, o `Nadie` | | `{leader}` | Quien domina, o el mejor bando | | `{percent}` | Progreso del líder, de 0 a 100 | | `{progress}` | `45%` (captura) o `120/300` (puntos) | | `{points}` | Puntos del líder | | `{bar}` | Barra de progreso como `■■■■□□□□□□` | | `{meter}` | El progreso según `display.progress-style` | | `{time_left}` | Tiempo restante (el tiempo extra restante durante el tiempo extra; `Sin límite` con `duration: 0`) | | `{overtime_left}` | Tiempo extra restante | | `{elapsed}` | Tiempo desde que se abrió | | `{capture_left}` | Segundos que aún necesita el líder (modo captura) | | `{inside}` | Jugadores dentro que cuentan | | `{players}` | Jugadores que participaron | | `{move_in}` | Tiempo hasta que se mueve un KOTH itinerante, o `-` | | `{state}` | `Libre`, `Capturando`, `En disputa`, `Quitando progreso` (un bando baja el progreso de otro) o `Defendiendo` (`contested: holder`, hay otros dentro con el que lo domina) | | `{top_1_name}` ... `{top_3_name}` | Los tres mejores bandos | | `{top_1_score}` ... `{top_3_score}` | Su progreso o sus puntos | **Sobre el jugador que lo lee** | Placeholder | Valor | | -------------- | ----------------------------- | | `{your_time}` | Tiempo que estuviste dentro | | `{your_kills}` | Tus bajas en este evento | | `{your_score}` | Progreso o puntos de tu bando | **Solo en algunos mensajes** | Placeholder | Dónde | | ----------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `{next}` | Tiempo hasta el próximo inicio (holograma, menús, `/koth list`) | | `{time}`, `{seconds}` | Cuenta atrás y avisos: tiempo hasta que se abre | | `{needed}`, `{online}` | `event.not-enough-players` | | `{previous}` | `capture.taken` / `capture.taken-score`: el bando que lo tenía | | `{winner}`, `{winner_score}` | Resultados y `commands.on-end` | | `{other}`, `{other_percent}`, `{other_progress}`, `{other_meter}` | Mientras un bando baja el progreso de otro (`hud.draining`, `bossbar.draining`, `hologram.draining`, `hud.locator-draining`): ese bando y su progreso | | `{others}` | Con `contested: holder`: cuántos jugadores de otros bandos hay dentro mientras el que lo domina sigue avanzando (`bossbar.defending`, `bossbar.defending-score`, `hologram.defending`, `hud.locator-defending`); si no, `0` | | `{amount}`, `{items}` | Mensajes del buzón de premios: el número y `objeto` / `objetos` (`words.item`, `words.items`) | | `{arrow}`, `{distance}` | `hud.locator` | Para los placeholders de las líneas de premio (`{player}`, `{team}`, `{place}`...), ver [Premios](/rnsetups/es/rnkoth/guides/rewards.md#placeholders-en-los-premios). {% hint style="info" %} Los mensajes que se envían a un jugador también aceptan los placeholders de PlaceholderAPI de ese jugador y las palabras del idioma `{@ruta}` (ver [Idiomas](/rnsetups/es/rnkoth/configuration/languages.md#palabras-del-idioma)). Los comandos (líneas de premio `[console]` y `[player]`, `commands.on-start` y `on-end`) también los aceptan: `{@ruta}` en el idioma del servidor, y PlaceholderAPI con el jugador que recibe el premio (sin jugador en `commands.on-start` / `on-end`). {% endhint %}