config.yml

##Introducción

El archivo config.yml es el archivo de configuración principal del plugin xTeams. Controla cómo se identifica internamente a los jugadores, define tus equipos y configura las integraciones con LuckPerms, los equipos nativos del scoreboard de Minecraft y la función de auto-team.

##Desglose del archivo config.yml

settings:
  # Modo de identificación de jugadores:
  # - "nickname" → para servidores no premium (offline mode)
  # - "uuid"     → para servidores premium (online mode), más robusto frente a cambios de nombre
  identifier_mode: "uuid"

hooks:
  luckperms:
    enabled: false
    team_groups: # [equipo xTeams]: <grupo LuckPerms>
      blue: blue
      red: red
      yellow: yellow
  minecraft_team:
    enabled: false
    team_groups: # [equipo xTeams]: <equipo del scoreboard de Minecraft>
      blue: blue
      red: red
      yellow: yellow
  auto_team:
    enabled: false
    op_bypass: false
    team: red

teams:
  red:
    displayName: "&e&lEquipo Rojo"
    priority: 2
    members:
      - jugador1
      - jugador2
  blue:
    displayName: "&e&lEquipo Azul"
    priority: 1
    members:
      - jugador3
      - jugador4
  yellow:
    displayName: "&e&lEquipo Amarillo"
    priority: 0
    members:
      - jugador5
      - jugador6

##Explicación

###settings

• identifier_mode: cómo guarda xTeams internamente a los miembros de los equipos.
  • "uuid" — recomendado para servidores premium / online-mode. Los jugadores conservan su pertenencia aunque cambien de nickname.
  • "nickname" — recomendado para servidores no premium / offline-mode, donde los UUIDs no son estables.
  • Suele elegirse una vez al instalar. Cambiar el modo después no convierte automáticamente las entradas existentes.

###hooks

Integraciones con sistemas externos. Cada hook se puede activar de forma independiente.

• luckperms — vincula los equipos de xTeams con grupos de LuckPerms.

  • enabled: activa o desactiva el hook. Requiere que LuckPerms esté instalado.
  • team_groups: mapa equipo xTeams → grupo LuckPerms. Cuando un jugador se une a un equipo de xTeams se le asigna el grupo correspondiente; cuando lo abandona, se le retira.

• minecraft_team — sincroniza los equipos de xTeams con los equipos del scoreboard vanilla (los que colorean nameplates y el tab list).

  • enabled: activa o desactiva el hook.
  • team_groups: mapa equipo xTeams → id de scoreboard team. Cuando un jugador se une a un equipo de xTeams se le añade al scoreboard team; cuando lo abandona, se le quita. El nombre mostrado del scoreboard team se toma del displayName del equipo de xTeams.

• auto_team — mete automáticamente a los jugadores nuevos en un equipo por defecto cuando entran al servidor (o cualquier vez que no tengan equipo).

  • enabled: activa o desactiva el hook.
  • op_bypass: si es true, los operadores del servidor no se asignan automáticamente.
  • team: el equipo al que se añadirán los jugadores. Debe coincidir con una entrada existente en teams.

###teams

Donde defines cada equipo.

• La clave de nivel superior (red, blue, yellow) es el nombre interno del equipo — el que se usa en comandos, placeholders y la API.
• displayName: nombre formateado que se muestra a los jugadores. Soporta códigos de color & y hex #RRGGBB.
• priority: número entero. Mayor valor = mayor prioridad. La usan getPlayerTeam y los placeholders del "equipo principal" cuando un jugador pertenece a varios.
• members: lista de jugadores en el equipo. Se guardan como UUIDs o nicknames según settings.identifier_mode. Normalmente no la editas a mano — usa /xteams join y /xteams leave.

Tip de recarga: ejecutar /xteams reload vuelve a leer este archivo y aplica los cambios en equipos, hooks y la configuración de auto-team sin necesidad de reiniciar el servidor.