Configuração

O plugin deve funcionar sem necessidade de configuração adicional, mas se você precisar alterar o comportamento do plugin, você está no lugar certo.

Estrutura de arquivos

Abaixo está um exemplo de como é a estrutura de arquivos do plugin. Clique em uma pasta para expandi-la.

Configuração do plugin (config.yml)

O arquivo config.yml é o coração do plugin, onde você controla todos os aspectos do sistema de ligas. Abaixo estão todas as opções disponíveis com explicações detalhadas.

debug-mode

Ativa ou desativa o modo de depuração. Quando ativado, o plugin registrará informações detalhadas no console para ajudar a identificar problemas.

# Determina o funcionamento da depuração. Valores válidos: [false, true]
debug-mode: false

database

Define como e onde os dados das ligas serão armazenados. O plugin suporta três tipos de armazenamento:

• SQLITE: Armazena dados em um arquivo local. Ideal para servidores pequenos.
• MYSQL: Conecta a um servidor MySQL externo. Recomendado para servidores médios.
• HIKARI: Usa pool de conexões para MySQL. Recomendado para servidores grandes por melhor performance.

database:
  # Determina o tipo de banco de dados. Valores válidos: [SQLITE, MYSQL, HIKARI (recomendado)]
  storage-type: SQLITE

  # Dados para conexão ao banco de dados MYSQL.
  data:
    # Endereço de conexão do banco de dados. [EX: 127.0.0.1]
    host: localhost
    # Porta de conexão do banco de dados. [EX: 3306]
    port: 3306
    # Nome do banco de dados a ser conectado. [EX: minecraft]
    database: ''
    # Usuário de conexão. [EX: root]
    username: ''
    # Senha do usuário de conexão: [EX: 123]
    password: ''

redis

Configurações do servidor Redis para sincronização multi-servidor (BungeeCord/Velocity).

redis:
  # Ativar a conexão com o redis
  enabled: false
  # Endereço de conexão. [EX: 127.0.0.1]
  host: 'localhost'
  # Porta de conexão. [EX: 6379]
  port: 6379
  # Usuário de conexão. [EX: root]
  username: ''
  # Senha do usuário de conexão: [EX: 123]
  password: ''

Quando usar Redis:

• Rede BungeeCord/Velocity com múltiplos servidores
• Sincronização em tempo real de pontos entre servidores
• Servidor de mina separado do lobby

login-delay

Delay para carregar os dados depois do login. Necessário quando se usa servidor de mina separado ou rede BungeeCord/Velocity.

# Delay em ticks (20 ticks = 1 segundo)
# Recomendado: 20 ticks
login-delay: 20

limit

Sistema de limite de recompensas a serem recolhidas por vez. Protege o servidor de sobrecarga ao processar muitas recompensas simultaneamente.

limit:
  enabled: true
  # Máximo que irá recolher por vez
  max: 1000

general

Configurações gerais do sistema de ligas.

general:
  # Apenas o líder conseguir clicar para participar da liga
  just-leader: true
  # Sistema de notificar o ganho de pontos (yDiscordHook)
  discordhook:
    enabled: true
    channel: ''
    # Placeholders disponíveis:
    # {action}
    # {player}
    # {clan_tag}
    # {clan_name}
    # {points}
    embed: ''
  # Sistema de notificar o ganho de pontos em webhook
  webhook:
    enabled: true
    # Placeholders disponíveis:
    # {action}
    # {player}
    # {clan_tag}
    # {clan_name}
    # {points}
    embed: 'earn'

just-leader: Define se apenas o líder do clan pode ingressar na liga. Recomendado true para evitar que membros inscrevam o clan sem autorização.

discordhook: Integração com o plugin yDiscordHook para enviar notificações ao Discord.

webhook: Integração direta com webhooks do Discord (configurado em discord.yml).

points

Configuração do ganho e perda de pontos por diferentes ações. Todos os valores são acumulados para o clan do jogador.

points:
  # Ao morrer
  player-death: -1.0
  # Ao matar um player
  player-kill: 1.0
  # Ao upar de rank
  yrankup: 1.0
  # Ao ganhar um evento
  yeventos: 1.0
  # Ao perder um evento
  yeventos-lose: 1.0
  # Ao kickar um jogador do clan (yClans)
  yclans-kick: -1.0
  # Ao ganhar um evento
  yguerra: 1.0
  # Ao matar um mob
  yspawners: 0.3
  # Ao matar um boss
  ystackbosses: 0.5
  # Ao matar um boss
  ybosses: 0.5
  # Ao quebrar um bloco
  yminas: 0.1
  # Ao quebrar um bloco
  yminaspackets: 0.1
  # Ao quebrar uma plantação
  yplantacoes: 0.1
  # Ao quebrar uma plantação
  ycampo: 0.1
  # Ao quebrar um bloco
  yfloresta: 0.1
  # Ao pescar um peixe
  ypesca: 0.3
  # Ao levar mute (yPunish)
  punish-mute: -5.0
   # Ao levar ban (yPunish e StormPunish)
   punish-ban: -10.0

# Sistema de pontos para o TitansBattle
titans-battle:
  # Nome do evento:quantia de pontos
  win:
    - 'name:10'

# Sistema de pontos para o yGuerra (jogador)
yguerra:
  # Nome do evento:quantia de pontos
  win:
    - 'name:10'

# Sistema de pontos para o yGuerra (clan)
yguerra-clans:
  # Nome do evento:quantia de pontos
  win:
    - 'name:10'

Como funciona o sistema de pontos:

1. Cada ação realizada por um membro do clan acumula (ou remove) pontos
2. Pontos são contabilizados em tempo real
3. O histórico de ações fica registrado na auditoria
4. Ações negativas (mortes, punições) penalizam o clan

Exemplo prático:

Um jogador que:

• Quebrou 1000 blocos na mina (yMinas): +100 pontos
• Matou 10 players: +10 pontos
• Morreu 5 vezes: -5 pontos
• Total: +105 pontos para o clan

Plugins compatíveis para obtenção de pontos:

• yMinas / yMinasPackets - Quebrar blocos em minas
• yPesca - Pescar peixes
• yCampo / yPlantacoes - Quebrar plantações
• yFloresta - Quebrar blocos em floresta
• ySpawners - Matar mobs de spawners
• yBosses / yStackBosses - Matar bosses
• yRankup - Evoluir de rank
• yEventos - Participar de eventos
• yTitansBattle - Ganhar batalhas (requer plugin yTitansBattle)

Sistema TitansBattle

O yLeagues se integra com o plugin yTitansBattle para conceder pontos automaticamente ao ganhar batalhas. Ideal para servidores com sistema de batalhas PvP estruturado.

Configuração:

# Sistema de pontos para o TitansBattle
titans-battle:
  # Nome do evento:quantia de pontos
  win:
    - 'name:10'

Explicação:

• titans-battle: Seção de configuração do sistema TitansBattle
• win: Ações que concedem pontos
• name:valor - Ganha valor pontos ao vencer uma batalha TitansBattle

Exemplo expandido:

titans-battle:
  win:
    - 'name:10'              # Vitória padrão: 10 pontos
    - 'boss_battle:25'       # Batalha de boss: 25 pontos (se existir)

Requisitos:

• Plugin yTitansBattle instalado e configurado
• Integração ativada neste arquivo
• Clans participando de ligas para acumular pontos

Sistema yGuerra

O yLeagues também pode pontuar vitórias do yGuerra separando pontos de jogador e pontos de clan.

# Sistema de pontos para o yGuerra (jogador)
yguerra:
  win:
    - 'name:10'

# Sistema de pontos para o yGuerra (clan)
yguerra-clans:
  win:
    - 'name:10'

Use yguerra para pontuações individuais e yguerra-clans para pontuações vinculadas ao clan vencedor.

medals

Sistema de medalhas concedidas automaticamente ao final de cada liga aos clans com estatísticas específicas.

medals:
  # Maior número de mortes ao final da temporada
  enemy-of-life: '&c[X]'
  # Maior número de kills ao final da temporada
  hard-to-kill: '&a[V]'

Como funciona:

• enemy-of-life: Medalha dada ao clan cujo membro teve mais mortes durante a liga
• hard-to-kill: Medalha dada ao clan cujo membro teve mais kills durante a liga

As medalhas aparecem automaticamente no chat (nChat) e em placeholders (PlaceholderAPI):

• Chat: {yleagues_medal_enemy-of-life} e {yleagues_medal_hard-to-kill}
• PAPI: %yleagues_medal_enemy-of-life% e %yleagues_medal_hard-to-kill%

Exemplo de uso no nChat:

{yleagues_medal_hard-to-kill} {yleagues_rank} {player}: {message}

Resultado: &a[V] &7[>] Steve: Olá!