StellaVariables
##Introducción
Las variables (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 tener PlaceholderAPI instalado. Stella registra la expansión stella automáticamente cuando detecta PlaceholderAPI — sin configuración extra.
Cuando un valor no se puede resolver (equipo o jugador desconocido), la variable devuelve el texto literal
null.
##Variables Soportadas
###Globales
| Variable | Descripción | Formato Devuelto |
|---|---|---|
| %stella_total_teams% | Número total de equipos registrados. | Entero (ej. 3) |
| %stella_total_players% | Número de jugadores distintos que pertenecen al menos a un equipo. | Entero (ej. 12) |
| %stella_all_teams% | Lista separada por comas de los id de todos los equipos. | Texto (ej. red, blue, yellow) |
###Sobre el jugador que ve la variable
| Variable | Descripción | Formato Devuelto |
|---|---|---|
| %stella_team% | Id del equipo principal del jugador (mayor prioridad). | Texto o null |
| %stella_team_display% | Nombre visible del equipo principal del jugador. | Texto o null |
| %stella_team_priority% | Prioridad del equipo principal del jugador. | Entero o null |
| %stella_team_color% | Color hex del equipo principal del jugador. | Texto o null |
| %stella_in_any_team% | Si el jugador pertenece a algún equipo. | Booleano (true / false) |
| %stella_team_count% | A cuántos equipos pertenece el jugador. | Entero |
| %stella_teams_list% | Lista separada por comas de todos los equipos del jugador, mayor prioridad primero. | Texto o none |
| %stella_in_team_<equipo>% | Si el jugador pertenece a un equipo específico. | Booleano (true / false) |
###Sobre otro jugador (por nombre)
| Variable | Descripción | Formato Devuelto |
|---|---|---|
| %stella_player_team_<jugador>% | Id del equipo principal de <jugador>. |
Texto o null |
| %stella_player_team_display_<jugador>% | Nombre visible del equipo principal de <jugador>. |
Texto o null |
| %stella_player_team_count_<jugador>% | A cuántos equipos pertenece <jugador>. |
Entero o null |
| %stella_player_in_any_team_<jugador>% | Si <jugador> pertenece a algún equipo. |
Booleano o null |
| %stella_player_in_team_<jugador>:<equipo>% | Si <jugador> pertenece a <equipo>. Fíjate en el separador :. |
Booleano o null |
###Sobre un equipo específico
| Variable | Descripción | Formato Devuelto |
|---|---|---|
| %stella_exists_<equipo>% | Si <equipo> existe. |
Booleano (true / false) |
| %stella_display_<equipo>% | Nombre visible de <equipo>. |
Texto o null |
| %stella_priority_<equipo>% | Prioridad de <equipo>. |
Entero o null |
| %stella_color_<equipo>% | Color hex de <equipo>. |
Texto o null |
| %stella_size_<equipo>% | Número de miembros de <equipo>. |
Entero o null |
##Cómo usar estas variables
Coloca la variable en cualquier lugar donde PlaceholderAPI procese texto. Stella la reemplaza con el valor en vivo al renderizar.
- Las variables del "jugador que ve" necesitan un contexto de jugador — solo se resuelven cuando existe uno (chat, scoreboards ligados a un jugador, etc.). En contextos de consola devuelven
null. - Las variables "sobre otro jugador" y "sobre un equipo" no dependen del contexto y funcionan en cualquier lugar.
##Ejemplo de configuración
chat-format: "%stella_team_display% &7| &f%player_name%: %message%"
sidebar-line: "Tu equipo: %stella_team% (prioridad %stella_team_priority%)"
admin-list: "Equipos: %stella_all_teams% — %stella_total_players% jugadores en total"
ally-check: "¿Está xDrygo en red? %stella_player_in_team_xDrygo:red%"##Compatibilidad con PlaceholderAPI
Si PlaceholderAPI está instalado, la integración es automática — sin configuración extra. Solo coloca las variables donde quieras y Stella se encarga del resto.