StellaVariables
##Introducción
Las variables (placeholders) te permiten mostrar información dinámica sobre equipos, jugadores y el estado global del mod en cualquier lugar que soporte la Text Placeholder API — chat, scoreboards, tab list, mensajes personalizados, etc.
Requiere tener instalada la Text Placeholder API de Patbox (no es PlaceholderAPI). Stella registra las variables stella automáticamente cuando detecta la Text Placeholder API — sin configuración extra.
En Fabric el formato de las variables difiere de la versión de Paper:
- El separador es dos puntos:
%stella_team%→%stella:team%. - Los argumentos van separados por espacio en vez de unidos con
_:%stella_exists_admins%→%stella:exists admins%.
Están disponibles las mismas 21 variables — solo cambia el formato.
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 : entre los dos argumentos. |
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 la Text Placeholder API 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 uso
Tu equipo: %stella:team% (prioridad %stella:team_priority%)
Equipos: %stella:all_teams% — %stella:total_players% jugadores en total
¿Está xDrygo en red? %stella:player_in_team xDrygo:red%
¿Existe el equipo admins? %stella:exists admins%El separador exacto de argumentos (se asume que es un espacio) debería confirmarse contra un servidor en ejecución antes de publicar.