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

# Placeholders

Placeholders de PlaceholderAPI de rnCombatPvP.

Necesita [PlaceholderAPI](https://modrinth.com/plugin/placeholderapi). Los valores son texto sin colores, listos para scoreboards, listas del tab y nametags. `sí` / `no` siguen `words.yes` / `words.no` del archivo de idioma.

## Combate

| Placeholder                 | Valor                                                                                 |
| --------------------------- | ------------------------------------------------------------------------------------- |
| `%rncombat_tagged%`         | `sí` mientras el jugador está en combate, si no `no` (también `%rncombat_in_combat%`) |
| `%rncombat_time%`           | Segundos que quedan en combate (`0` fuera de combate)                                 |
| `%rncombat_time_formatted%` | Segundos que quedan con `s` (`12s`), o `-` fuera de combate                           |
| `%rncombat_enemy%`          | Nombre del último enemigo, o `-`                                                      |
| `%rncombat_enemy_health%`   | Vida del último enemigo en corazones, o `-`                                           |
| `%rncombat_npc%`            | `sí` mientras el NPC de desconexión del jugador está en el mundo                      |

## Protecciones

| Placeholder                   | Valor                                                                                                 |
| ----------------------------- | ----------------------------------------------------------------------------------------------------- |
| `%rncombat_pvp%`              | `on` u `off`                                                                                          |
| `%rncombat_pvp_status%`       | Las palabras `SÍ` / `NO` del archivo de idioma                                                        |
| `%rncombat_newbie%`           | Segundos de protección de novato que quedan (`0` = ninguna)                                           |
| `%rncombat_newbie_formatted%` | Tiempo de novato que queda como `25m 10s`, o `-`                                                      |
| `%rncombat_protected%`        | `sí` cuando ahora no se puede golpear al jugador (novato, PvP desactivado o protección al reaparecer) |

## Estadísticas

| Placeholder              | Valor                                                       |
| ------------------------ | ----------------------------------------------------------- |
| `%rncombat_kills%`       | Asesinatos                                                  |
| `%rncombat_deaths%`      | Muertes                                                     |
| `%rncombat_kdr%`         | Asesinatos / muertes, con dos decimales                     |
| `%rncombat_streak%`      | Racha actual                                                |
| `%rncombat_best_streak%` | Mejor racha                                                 |
| `%rncombat_assists%`     | Asistencias                                                 |
| `%rncombat_rating%`      | Rating (ELO)                                                |
| `%rncombat_logs%`        | Veces que el jugador se desconectó en combate               |
| `%rncombat_bounty%`      | Recompensa por el jugador, con formato de dinero (`$1,500`) |
| `%rncombat_bounty_raw%`  | Recompensa por el jugador como número solo (`1500.0`)       |

## Mejores jugadores

`%rncombat_top_<tipo>_<puesto>_name%` y `%rncombat_top_<tipo>_<puesto>_value%`, con `<tipo>` uno de `kills`, `kdr`, `streak`, `rating`, `assists` y `<puesto>` del 1 al 100.

* `%rncombat_top_kills_1_name%` → `Steve`
* `%rncombat_top_kills_1_value%` → `152`
* `%rncombat_top_streak_1_value%` es la mejor racha. La lista `kdr` solo tiene jugadores con 5 asesinatos o más.
* Un puesto vacío muestra `-` como nombre y `0` como valor.

Las listas se leen de la base de datos en segundo plano y se guardan 30 segundos, así que los scoreboards que preguntan cada tick no cuestan nada.

## Ejemplo: TAB

Muestra una espada delante de los jugadores en combate con TAB en lugar de `display.nametag-prefix`, usando un placeholder condicional de TAB:

```yaml
conditions:
  incombat:
    conditions:
      - "%rncombat_tagged%=sí"
    true: "&c⚔ "
    false: ""
```

Después usa `%condition:incombat%` en el prefijo del nametag de tus grupos. Si tu servidor usa el idioma `en`, compara con `yes`.

Los placeholders de otros plugins también se pueden usar en todos los textos de los archivos de idioma.