config.yml

##Introducción

El archivo config.yml contiene los ajustes globales de Stella: el comprobador de actualizaciones, los valores por defecto que se aplican a los equipos nuevos, y las integraciones opcionales (hooks) con LuckPerms, los equipos del scoreboard de Minecraft y el auto-equipo al entrar.

##Desglose del archivo config.yml

# Stella — plugin settings

# Checks Modrinth for a newer version on startup.
update-checker:
  enabled: true
  # Notify OPs when they join if an update is available.
  notify-ops: true

teams:
  # Default color when creating a team.
  default-color: "#FFFFFF"
  # Default priority when not specified in /stella create.
  default-priority: 0

# Optional integrations.
hooks:
  # Reflects team membership as LuckPerms inheritance groups.
  # team_groups maps team-id -> group name. Only the groups listed
  # here are touched. A player in multiple mapped teams receives multiple groups.
  # Requires LuckPerms. Download at https://luckperms.net
  luckperms:
    enabled: false
    # Example:
    #   admins: staff
    #   vip: vip
    team_groups: {}

  # Reflects teams as vanilla scoreboard teams; the nametag takes the color
  # of the primary team (highest priority). team_groups maps team-id
  # scoreboard team name (max 16 characters, must be unique).
  minecraft_team:
    enabled: false
    # Example:
    #   admins: sb_admins
    #   vip: sb_vip
    team_groups: {}

  # Adds teamless players to a default team on join.
  # Players with the 'stella.autoteam.bypass' permission are always exempt.
  auto_team:
    enabled: false
    team: ""
    # If true, OPs are not auto-assigned.
    op_bypass: false

##Explicación

###update-checker

• enabled — cuando es true, Stella comprueba en Modrinth al iniciar si hay una versión más nueva.
• notify-ops — cuando es true, se avisa a los OPs de que hay una actualización disponible al entrar.

###teams

Valores por defecto que se aplican al crear un equipo nuevo.

• default-color — el color hex (#RRGGBB) que se da a un equipo creado sin color explícito. Cámbialo después por equipo con /stella setcolor.
• default-priority — la prioridad asignada por /stella create <id> cuando no pasas un argumento de prioridad.

###hooks

Integraciones opcionales, cada una activable de forma independiente.

• luckperms — refleja la membresía de equipos como grupos de LuckPerms.

  • enabled — activa/desactiva el hook. Requiere LuckPerms.
  • team_groups — un mapa de id-equipo → grupo de LuckPerms. Solo se tocan los grupos listados: cuando un jugador entra a un equipo mapeado recibe el grupo; al salir se le quita. Un jugador en varios equipos mapeados recibe varios grupos.

• minecraft_team — refleja los equipos como equipos del scoreboard vanilla (los que colorean los nombres y la tab list).

  • enabled — activa/desactiva el hook.
  • team_groups — un mapa de id-equipo → nombre de equipo del scoreboard. Cada nombre debe ser único y de ≤ 16 caracteres. El nombre toma el color del equipo principal del jugador (mayor prioridad).

• auto_team — asigna a los jugadores sin equipo a un equipo por defecto al entrar.

  • enabled — activa/desactiva el hook.
  • team — el id del equipo al que se añaden los jugadores. Debe ser un equipo existente.
  • op_bypass — si es true, los OPs no son auto-asignados. Los jugadores con el permiso stella.autoteam.bypass siempre quedan exentos, independientemente de este ajuste.

##Almacenamiento de equipos (teams.yml)

Los equipos se guardan en plugins/stella/teams.yml. Normalmente los gestionas con comandos (/stella create, add, setcolor, …), pero aquí tienes la estructura como referencia:

teams:
  red:
    priority: 2
    display-name: "Red Team"
    color: "#FF5555"
    members:
      - "f7c8b3a0-1234-4abc-9def-0123456789ab"
      - "a1b2c3d4-5678-49ef-8abc-fedcba987654"
  blue:
    priority: 1
    display-name: "Blue Team"
    color: "#5555FF"
    members: []

• La clave de nivel superior (red, blue) es el id del equipo — siempre en minúsculas, usado en comandos, variables y la API.
• priority — entero; el mayor gana cuando un jugador pertenece a varios equipos.
• display-name — el nombre mostrado a los jugadores. Configúralo con /stella setname.
• color — color hex (#RRGGBB). Configúralo con /stella setcolor.
• members — lista de UUIDs de jugadores. Stella guarda a los miembros solo por UUID, así que las membresías sobreviven a los cambios de nombre. Edita con /stella add / /stella remove en vez de a mano.