Stella • Primeros Pasos

##1. Instalación

Para empezar con Stella, instala el mod en tu servidor de Minecraft:

Requisitos: un servidor con Fabric Loader y Minecraft 1.21.1, con el mod Fabric API instalado. Stella es solo del lado del servidor — los jugadores pueden entrar con un cliente vanilla.
Integraciones opcionales:
- Text Placeholder API (de Patbox) — añade las variables %stella:…%.

Coloca el .jar en la carpeta mods de tu servidor (junto con la Fabric API) y reinicia. Stella genera config.json, messages.json, teams.json y names.json dentro de config/stella/.

INFO

Stella guarda a los miembros de los equipos por UUID, así que las membresías sobreviven a los cambios de nombre — no hay un modo de identificador que elegir.

##2. Crear y Gestionar Equipos

Cada acción se ejecuta con el comando /stella. Todos los subcomandos de /stella requieren OP — mira Permisos.

###Crear un Equipo

/stella create <id> [prioridad]

Reemplaza <id> con el id del equipo (se pasa a minúsculas automáticamente) y opcionalmente [prioridad] (mayor = más importante cuando un jugador está en varios equipos). Ejemplo: /stella create red 10. Sin prioridad usa teams.defaultPriority de config.json.

###Gestionar Miembros

Añadir miembros
```
/stella add <equipo> [objetivo]
```
Deja [objetivo] vacío para añadirte a ti mismo. El objetivo también puede ser un nombre de jugador, @all, @online, o @team:<id>. Ejemplo: /stella add red Alex o /stella add vip @online.
Quitar miembros
```
/stella remove <equipo> [objetivo]
```
Mismos objetivos que add. Ejemplo: /stella remove red Alex, o /stella remove old @team:new para sacar a todos los de new de old.

###Ver Información

Los detalles de un equipo — nombre visible, color, prioridad y miembros:
```
/stella info team <equipo>
```
Todos los equipos de un jugador (su equipo principal va marcado con estrella):
```
/stella info player <jugador>
```
Todos los equipos de un vistazo:
```
/stella list
```

###Personalizar un Equipo

/stella setname <equipo> <nombre>
/stella setcolor <equipo> <#hex>
/stella setpriority <equipo> <prioridad>

Ejemplo: /stella setname red Red Team, /stella setcolor red #FF5555, /stella setpriority red 10. El color debe ser un hex #RRGGBB de 6 dígitos y controla el color del nombre vanilla cuando el hook del scoreboard está activado.

###Eliminar un Equipo

/stella delete <equipo>

Ejemplo: /stella delete red elimina el equipo y a todos sus miembros.

###Recargar

/stella reload

Vuelve a leer config.json y messages.json sin reiniciar.

##3. Hooks Opcionales

Abre config.json para activar las integraciones:

scoreboard — mapea ids de equipos a equipos del scoreboard vanilla para que los nombres/tab tomen el color del equipo.
autoTeam — asigna automáticamente a los jugadores sin equipo a un equipo por defecto al entrar.

Mira la página de config.json para el desglose completo.

##4. Más Recursos

Plugin
Archivos de Configuración
- config.json
- messages.json
API
- Stella API

Ya estás listo para empezar a crear equipos con Stella.