xTeamsVariables
##Introducción
Los placeholders te permiten mostrar información dinámica sobre equipos, jugadores y el estado global del plugin en cualquier lugar que soporte PlaceholderAPI — chat, scoreboards, hologramas, tab list, mensajes personalizados, etc.
Requiere PlaceholderAPI instalado en tu servidor. xTeams se registra automáticamente cuando detecta PlaceholderAPI.
##Placeholders Soportados
###Globales
| Placeholder | Descripción | Formato Devuelto |
|---|---|---|
| %xteams_total_teams% | Número total de equipos registrados. | Integer (ej., 3) |
| %xteams_total_players% | Número total de jugadores distintos que pertenecen a al menos un equipo. | Integer (ej., 12) |
| %xteams_all_teams% | Lista separada por comas con el nombre interno de cada equipo. | String (ej., red, blue, yellow) |
###Sobre el jugador que ve el placeholder
| Placeholder | Descripción | Formato Devuelto |
|---|---|---|
| %xteams_team% | Nombre interno del equipo principal del jugador (mayor prioridad). | String o null |
| %xteams_team_display% | Nombre visible del equipo principal del jugador. | String o null |
| %xteams_team_priority% | Prioridad del equipo principal del jugador. | Integer o null |
| %xteams_in_any_team% | Si el jugador pertenece a algún equipo. | Boolean (true / false) |
| %xteams_in_team_<team>% | Si el jugador pertenece a un equipo específico. | Boolean (true / false) |
| %xteams_team_count% | A cuántos equipos pertenece el jugador. | Integer |
| %xteams_teams_list% | Lista separada por comas de todos los equipos del jugador, ordenados por prioridad (mayor primero). | String o none |
###Sobre otro jugador (por nickname)
| Placeholder | Descripción | Formato Devuelto |
|---|---|---|
| %xteams_player_team_<player>% | Nombre interno del equipo principal de <player>. |
String o null |
| %xteams_player_team_display_<player>% | Nombre visible del equipo principal de <player>. |
String o null |
| %xteams_player_team_count_<player>% | A cuántos equipos pertenece <player>. |
Integer |
| %xteams_player_in_any_team_<player>% | Si <player> pertenece a algún equipo. |
Boolean (true / false) |
| %xteams_player_in_team_<player>:<team>% | Si <player> pertenece a <team>. Nota el separador : entre jugador y equipo. |
Boolean (true / false) |
###Sobre un equipo concreto
| Placeholder | Descripción | Formato Devuelto |
|---|---|---|
| %xteams_exists_<team>% | Si <team> existe. |
Boolean (true / false) |
| %xteams_display_<team>% | Nombre visible de <team>. |
String o null |
| %xteams_priority_<team>% | Prioridad de <team>. |
Integer o null |
| %xteams_size_<team>% | Número de miembros de <team>. |
Integer o null |
| %xteams_members_<team>% | Lista separada por comas de los miembros de <team> (resueltos a nicknames). |
String o null |
##Cómo usar estos placeholders
Coloca el placeholder en cualquier sitio donde PlaceholderAPI procese texto. xTeams lo reemplaza por el valor en vivo al renderizar.
- Los placeholders del "jugador que ve" dependen de un contexto de jugador — solo se resuelven cuando lo hay (mensajes de chat, scoreboards atados a un jugador, etc.). En consola devuelven
null. - Los placeholders "sobre otro jugador" y "sobre un equipo" son independientes del contexto y funcionan en cualquier lugar.
##Ejemplo de configuración
chat-format: "%xteams_team_display% &7| &f%player_name%: %message%"
sidebar-line: "Tu equipo: %xteams_team% (prioridad %xteams_team_priority%)"
admin-list: "Equipos: %xteams_all_teams% — %xteams_total_players% jugadores en total"
ally-check: "¿xDrygo está en red? %xteams_player_in_team_xDrygo:red%"##Compatibilidad con PlaceholderAPI
Si PlaceholderAPI está instalado en tu servidor, el plugin se integra con él automáticamente — no necesitas configuración adicional. Solo añade los placeholders donde quieras y xTeams se encarga del resto.