TAB & SCOREBOARD

belowname:
  enabled: true               # false apaga la entidad y devuelve la placa vanilla
  interval-ticks: 2      # cada cuántos ticks se recalculan los textos
  follow-ticks: 1        # 0 = salto instantáneo; 1 = acompaña el suavizado del cliente
  y-offset: 2.6          # altura de la PRIMERA fila sobre los pies del jugador
  anchor: top            # top = la fila 1 queda fija y las demás crecen hacia abajo
  line-height: 0.3       # separación entre filas en bloques (a escala 1)
  scale: 0.4             # tamaño del texto (0.05 - 4)
  max-lines: 3           # filas por encima de la cabeza (1 - 3)
  alignment: CENTER      # LEFT, CENTER o RIGHT
  shadowed: true         # sombra del texto
  see-through: false     # true permite ver la etiqueta a través de bloques
  show-to-self: true     # el propio jugador ve sus filas (útil para comprobarlas)
  opacity: 255           # 0 - 255
  background: none       # none, #RRGGBB o #AARRGGBB
  animation:
    enabled: true
    interval-ticks: 20
  contexts:
    lobby:
      lines:
        - "{rank_prefix}{player}"      # rango solo en lobby y espera
        - "&7Clan: {clan} &8✧ &bLv.{level}"
        - "&c{heart_bar}"
    waiting:
      lines:
        - "{rank_prefix}{player}"
        - "&7Equipo: {player_team} &8✧ &eEn {countdown}s"
        - "&c{heart_bar}"
    game:
      lines:
        - "{team_prefix}{player}"      # sin rango: etiqueta de equipo + nick en su color
        - "&7Bajas: {kills} &8✧ &cMuertes: {deaths}"
        - "&c{heart_bar}"
    spectator:
      lines:
        - "&7[ESP] {player}"
        - "&7&lESPECTADOR"
    parkour:
      lines:
        - "&a[PARKOUR] {player}"
        - "&a{parkour_course} &8✧ &7Punto {parkour_points}"
        - "&bLv.{level}"
    pcw:
      lines:
        - "{team_prefix}{player}"
        - "&6Clan: {clan} &8✧ &bLv.{level}"
        - "&c{heart_bar}"

Orden de la lista: en lobby, espera, Parkour y PCW manda el peso del grupo de LuckPerms (de mayor a menor) y, a igualdad, el orden alfabético del nick. En partida PTC primero se agrupa por equipo y después por peso/nick. El cliente ordena por el nombre visible de la lista, así que PTC antepone un código de color invisible con la posición y después el prefijo configurado en list-format (rango en lobby/espera; equipo o clan en partida) y el color del nick: el orden se mantiene estable sin cambiar el aspecto.

• PlaceholderAPI prueba por defecto %luckperms_prefix%, %vault_prefix% y %player_prefix%, en ese orden. Cuando está instalado, sus placeholders de las expansiones disponibles también se resuelven en el header/footer TAB, los prefijos/sufijos de nombre y las líneas/título del scoreboard.
• Si PAPI no devuelve un prefijo, PTC intenta LuckPerms directamente y luego el servicio de chat de Vault.
• El orden se puede editar en integrations.prefix-placeholders.
• PTC registra su propia expansión de PlaceholderAPI: %ptc_player%, %ptc_rank%, %ptc_rank_prefix%, %ptc_coins%, %ptc_level%, %ptc_clan%, %ptc_arena%, %ptc_arena_state%, %ptc_team%, %ptc_team_color%, %ptc_kills%, %ptc_deaths%, %ptc_assists%, %ptc_kill_streak%, %ptc_online% y %ptc_max_online%.
• prefix-format controla la combinación, por ejemplo {rank_prefix}{team_prefix}. {rank_prefix} nunca muestra nombres de nivel de PTC: usa el prefijo de LuckPerms/Vault/PlaceholderAPI y queda vacío si el grupo no tiene prefijo; rank-prefixes.operator (DevOP) aplica solo si no hay plugin de permisos. La fila de la cabeza usa prefix para los rangos con prefijo y default-prefix para los usuarios normales, que se quedan solo con el nick; la lista TAB se compone aparte con list-format (rango en lobby/espera, equipo/clan en partida) y el color de list-nick-color. Consulta la guía de rangos.
• team-prefixes personaliza color y nombre del equipo, clan PCW y Parkour. En nametag.contexts, cada modalidad tiene prefijos/sufijos propios, editables con texto o listas YAML; las filas que flotan sobre la cabeza se editan en belowname.contexts.<contexto>.lines con los mismos placeholders.

channels:
  team:
    format: "&8| &bPTC &7» {rank_prefix}{clan} {player_color}{player}&8: &f{message}"
  pcw:
    format: "&8| &cPCW &7» {rank_prefix}{clan} {player_color}{player}&8: &f{message}"

El nombre de clan se representa como (NombreDelClan). Los formatos editables están en chat_es.yml; para un jugador sin clan, el token queda vacío.

team-prefixes:
  parkour: "&a[PARKOUR] "
  pcw: "{clan_color}[PCW] "
nametag:
  contexts:
    lobby:
      prefix: ["{rank_prefix}"]
      default-prefix: [""]
      suffix: [""]
    waiting:
      prefix: "{rank_prefix}{team_prefix}"
      default-prefix: "{team_prefix}"
      suffix: ""
    game:
      prefix: "{rank_prefix}{team_prefix}"
      default-prefix: "{team_prefix}"
      suffix: ""
    pcw:
      prefix: "{rank_prefix}{team_prefix}"
      default-prefix: "{team_prefix}"
      suffix: ""

La placa vanilla sobre la cabeza queda oculta mientras el belowname está activo; si lo apagas con belowname.enabled: false, vuelve a mostrarse y tiene dos formatos: prefix se aplica a quien tiene prefijo de rango (rangos de pago y staff, que siempre ven rango + nick) y default-prefix a los jugadores del grupo default/usuario, que por defecto se quedan solo con el nick. Si prefieres que todo el mundo lea una etiqueta, escribe {rank} en default-prefix y dale texto a ranks.none de mensajes_es.yml (viene vacío; por ejemplo "&fUSUARIO"). También vale un texto literal o un color como &a. Los marcos admiten cadena o lista YAML (animación). La lista TAB es independiente y se compone con list-format: en lobby y espera muestra el prefijo del rango, y en partida, Parkour, espectador y PCW muestra la etiqueta de equipo/clan, siempre con el nick pintado por list-nick-color (blanco por defecto; team usa el color del equipo; cada contexto puede sobrescribirlo con nametag.contexts.<contexto>.list-nick-color).

En las cabeceras y pies del TAB puedes usar {rank_tag}: pinta la plantilla rank-tag-format (por defecto " &8• {rank_prefix}") solo cuando el jugador tiene rango, así que un usuario normal lee "Bienvenido/a ItsNoirix" sin punto ni etiqueta suelta. Si escribes {player_rank} en su lugar, el rango se muestra siempre y los sin rango leen ranks.none.

Placeholders de nametag y belowname: {rank_prefix}, {rank_tag}, {team_prefix}, {rank}, {player_rank}, {player} (nick con el color del equipo), {clan}, {level}, {health}, {max_health}, {hearts}, {heart_bar}, {kills}, {deaths}, {assists}, {kill_streak}, {players}, {max_players}, {countdown}, {player_team}, {parkour_course}, {parkour_points}, {parkour_checkpoints} y, para PCW, {pcw_arena}/{pcw_state}. La lista TAB y su visibilidad se aíslan por lobby, sala/arena PTC, partida PCW y circuito Parkour; el sidebar se edita en PTC-Games/scoreboard_es.yml.

game:
  lines:
    - "&fAsesinatos: &a{kills}"
    - "&fMuertes: &c{deaths}"
    - "&fRacha: &6{kill_streak}"

La racha se reinicia al morir y se recompensa cada cinco asesinatos seguidos (+5 Coins base por hito). Las recompensas elegibles aplican una sola vez el multicoins activo, sin límite diario.

1. Prueba nombre largo, prefijo externo ausente y nombre con colores/equipo.
2. En partida PTC comprueba que la lista no muestra rango sino la etiqueta del equipo y el nick en su color (&c[R] Noob1), que sobre la cabeza la primera fila usa el equipo y que el nick se ve en amarillo, verde, azul o rojo según el equipo. Confirma también que la placa vanilla no repite el nombre (se oculta sola con belowname.enabled: true). En lobby y espera, en cambio, la lista debe leerse rango + nick.
3. Comprueba ciclos de animación y caracteres Unicode con el cliente y versión de servidor objetivo.
4. Verifica espera, partida y espectador; en partidas PTC/PCW el nombre usa el color real del equipo/clan. Revisa colisión con plugins que administren scoreboard o equipos.
5. Guarda copias de PTC-Games/tab_es.yml y PTC-Games/scoreboard_es.yml antes de editar.