config.json

##Introducción

El archivo config.json contiene los ajustes globales de Stella en Fabric: el comprobador de actualizaciones, los valores por defecto que se aplican a los equipos nuevos, y las integraciones opcionales (hooks). Es el equivalente en JSON del config.yml de Paper, con claves en camelCase.

##Desglose del archivo config.json

{
  "updateChecker": {
    "enabled": true,
    "notifyOps": true
  },
  "teams": {
    "defaultColor": "#FFFFFF",
    "defaultPriority": 0
  },
  "hooks": {
    "scoreboard": {
      "enabled": false,
      "teamGroups": {}
    },
    "autoTeam": {
      "enabled": false,
      "team": "",
      "opBypass": false
    }
  }
}

##Explicación

###updateChecker

• enabled — cuando es true, Stella comprueba en Modrinth al iniciar si hay una versión más nueva.
• notifyOps — 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.

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

###hooks

Integraciones opcionales, cada una activable de forma independiente.

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

  • enabled — activa/desactiva el hook.
  • teamGroups — 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).

  "teamGroups": {
    "admins": "sb_admins",
    "vip": "sb_vip"
  }

• autoTeam — 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.
  • opBypass — si es true, los OPs no son auto-asignados. (En Fabric no hay un nodo de permiso para esto — mira Permisos.)

##Almacenamiento de equipos (teams.json)

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

{
  "red": {
    "priority": 2,
    "displayName": "Red Team",
    "color": "#FF5555",
    "members": [
      "f7c8b3a0-1234-4abc-9def-0123456789ab",
      "a1b2c3d4-5678-49ef-8abc-fedcba987654"
    ]
  },
  "blue": {
    "priority": 1,
    "displayName": "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.
• displayName — 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.