Stella • Primeros Pasos

##1. Instalación

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

Requisitos: un servidor Spigot o Paper con Minecraft 1.20.x – 1.21.x. CraftBukkit no es compatible.
Integraciones opcionales:
- PlaceholderAPI — añade las variables %stella_…%.
- LuckPerms — permite que Stella añada/quite un grupo de permisos cuando un jugador entra o sale de un equipo.

Coloca el .jar en la carpeta plugins de tu servidor y reinicia. Stella genera config.yml, messages.yml y teams.yml dentro de plugins/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.

###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.default-priority de config.yml.

###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 de equipos de Minecraft 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.yml y messages.yml sin reiniciar.

##3. Hooks Opcionales

Abre config.yml para activar las integraciones:

luckperms — mapea ids de equipos a grupos de LuckPerms para que la membresía otorgue/quite un grupo.
minecraft_team — mapea ids de equipos a equipos del scoreboard vanilla para que los nombres/tab tomen el color del equipo.
auto_team — asigna automáticamente a los jugadores sin equipo a un equipo por defecto al entrar.

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

##4. Más Recursos

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

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