Ligas

Exemplo completo de configuração

As ligas são configuradas em arquivos individuais dentro da pasta leagues/. Aqui está um exemplo completo baseado no arquivo iron.yml:

# Identificação necessária para a API de TOP do yPlugins
yplugins-id: 'yleagues-iron'

order: 1

# Data de ínicio da liga
start-date: '01/01/2020-10:00'

# Data de término da liga
end-date: '01/01/2028-10:00'

# Nome da liga
display: '&fLiga de Ferro'

# Ícones nos menus
icons:
  finished:
    material: 'IRON_INGOT'
    name: '&fLiga de Ferro'
    lore:
      - ''
      - ' &7Líderes:'
      - '  &f> 1º {clan_1}: &a{amount_1}'
      - '  &f> 2º {clan_2}: &a{amount_2}'
      - '  &f> 3º {clan_3}: &a{amount_3}'
      - ''
      - '&cEsta liga já finalizou.'

Estrutura de uma liga

Configurações básicas

yplugins-id

Identificação única da liga para a API de TOP do yPlugins.

Exemplo:

yplugins-id: 'yleagues-iron'

Use um ID único para cada liga. Este ID será usado para acessar o ranking via API.

order

Ordem de exibição da liga nos menus. Ligas com order menor aparecem primeiro.

Exemplo:

order: 1

start-date

Data e hora de início da liga no formato DD/MM/YYYY-HH:MM.

Exemplo:

start-date: '15/12/2024-18:00'

end-date

Data e hora de término da liga no formato DD/MM/YYYY-HH:MM.

Exemplo:

end-date: '31/12/2024-23:59'

display

Nome de exibição da liga (aceita códigos de cores).

Exemplo:

display: '&6Liga de Ouro'

icons

Ícones da liga em diferentes estados nos menus.

finished

Ícone exibido quando a liga já terminou.

Placeholders disponíveis:

{clan_1}, {clan_2}, {clan_3} - Tags dos clans nas posições 1, 2 e 3
{amount_1}, {amount_2}, {amount_3} - Pontos dos clans nas posições 1, 2 e 3

Exemplo:

icons:
  finished:
    material: 'IRON_INGOT'
    name: '&fLiga de Ferro'
    lore:
      - ''
      - ' &7Líderes:'
      - '  &f> 1º {clan_1}: &a{amount_1}'
      - '  &f> 2º {clan_2}: &a{amount_2}'
      - '  &f> 3º {clan_3}: &a{amount_3}'
      - ''
      - '&cEsta liga já finalizou.'

current

Ícone exibido quando a liga está acontecendo (para quem não está participando).

Placeholders disponíveis:

{clan_1}, {clan_2}, {clan_3} - Tags dos clans nas posições 1, 2 e 3
{amount_1}, {amount_2}, {amount_3} - Pontos dos clans
{end_time} - Tempo até o fim
{end_date} - Data de término
{end_hour} - Hora de término

Exemplo:

icons:
  current:
    material: 'IRON_INGOT'
    name: '&fLiga de Ferro'
    lore:
      - ''
      - ' &7Líderes:'
      - '  &f> 1º {clan_1}: &a{amount_1}'
      - '  &f> 2º {clan_2}: &a{amount_2}'
      - '  &f> 3º {clan_3}: &a{amount_3}'
      - ''
      - '&f Finaliza em: &b{end_time} &7({end_date}-{end_hour})'
      - ''
      - '&aEsta liga está ocorrendo.'

coming

Ícone exibido quando a liga ainda não começou.

Placeholders disponíveis:

{start_time} - Tempo até o início
{start_date} - Data de início
{start_hour} - Hora de início

Exemplo:

icons:
  coming:
    material: 'IRON_INGOT'
    name: '&fLiga de Ferro'
    lore:
      - '&7Esta liga ainda será iniciada,'
      - '&7não perca tempo e fique preparado'
      - '&7para garantir sua participação.'
      - ''
      - '&f Inicia em: &b{start_time} &7({start_date}-{start_hour})'
      - ''

participate

Ícone para o botão de participar da liga.

Placeholders disponíveis:

{points} - Pontos iniciais necessários
{money} - Dinheiro necessário
{clan_1}, {clan_2}, {clan_3} - Tags dos clans líderes
{amount_1}, {amount_2}, {amount_3} - Pontos dos clans líderes

Exemplo:

icons:
  participate:
    material: 'IRON_INGOT'
    name: '&fLiga de Ferro'
    lore:
      - '&7Participe da liga dos clans e'
      - '&7garanta prêmios exclusivos.'
      - ''
      - ' &fPontos iniciais necessários: &b{points}'
      - ' &fMoney necessário: &2$ &a{money}'
      - ''
      - ' &7Líderes Atuais:'
      - '  &f> 1º {clan_1}: &a{amount_1}'
      - '  &f> 2º {clan_2}: &a{amount_2}'
      - '  &f> 3º {clan_3}: &a{amount_3}'
      - ''
      - '&aClique para participar.'

participating

Ícone exibido quando o clan já está participando.

Exemplo:

icons:
  participating:
    material: 'IRON_INGOT'
    name: '&fLiga de Ferro'
    lore:
      - '&7Seu clan está participando desta liga'
      - '&7e pode garantir prêmios exclusivos.'
      - ''
      - ' &7Líderes Atuais:'
      - '  &f> 1º {clan_1}: &a{amount_1}'
      - '  &f> 2º {clan_2}: &a{amount_2}'
      - '  &f> 3º {clan_3}: &a{amount_3}'
      - ''
      - '&f Finaliza em: &b{end_time} &7({end_date}-{end_hour})'
      - ''

no-clan

Ícone exibido quando o jogador não tem clan.

Exemplo:

icons:
  no-clan:
    material: 'IRON_INGOT'
    name: '&fLiga de Ferro'
    lore:
      - '&7Você precisa entrar ou criar'
      - '&7um clan para participar das ligas.'
      - ''
      - '&c Você não possui um clan.'
      - ''

Sistema de participação

participate

Configurações de requisitos para participar da liga.

clan-limit

Limite máximo de clans que podem participar da liga (0 = sem limite).

Exemplo:

participate:
  clan-limit: 10

min-initial-points

Quantidade mínima de pontos que o clan precisa ter para ingressar.

Exemplo:

participate:
  min-initial-points: 10.0

previous-league

Order da liga anterior que o clan precisa ter participado (0 = nenhuma).

Exemplo:

participate:
  previous-league: 0

Use previous-league para criar progressão entre ligas. Por exemplo, para participar da Liga de Ouro, o clan precisa ter participado da Liga de Ferro.

insert-automatic

Se deve inserir clans automaticamente na liga quando ela começar.

Exemplo:

participate:
  insert-automatic: false

message

Mensagens exibidas ao participar da liga.

Placeholders disponíveis:

{money} - Valor pago
Outros placeholders da economia

Exemplo:

participate:
  message:
    private: '&aVocê pagou &f{money}&a para ingressar seu clan na liga de clans.'
    broadcast: '&e{player} ingressou o clan {clan_tag} na liga!'

Deixe broadcast: '' se não quiser anunciar publicamente.

prices

Preços para participar da liga.

Exemplo:

participate:
  prices:
    price1:
      provider: 'money'
      amount: 1000.0
    price2:
      provider: 'points'
      amount: 500

Sistema de vitória

win

Configurações de vitória e recompensas.

amount

Quantidade de pontos necessária para ganhar a liga antes do tempo (0 = apenas no final).

Exemplo:

win:
  amount: 100.0

Se amount: 0, o vencedor será definido apenas quando a data de término chegar.

reset

Se deve resetar os pontos dos clans ao finalizar a liga.

Exemplo:

win:
  reset: true

rewards

Lista de recompensas dadas ao líder do clan vencedor.

Formato: chance,id_da_recompensa

Exemplo:

win:
  rewards:
    - '100.0,reward1'
    - '50.0,reward2'
    - '25.0,reward3'

As recompensas são configuradas no arquivo rewards.yml.

Mensagens da liga

messages

Mensagens transmitidas durante a liga.

start

Mensagem exibida quando a liga começa.

Exemplo:

messages:
  start: |

    &f&lLIGA DE FERRO: &aA liga COMEÇOU!

stop

Mensagem exibida quando a liga termina com vencedor.

Placeholders:

{clan} - Tag do clan vencedor
{amount} - Pontos do clan vencedor

Exemplo:

messages:
  stop: |

    &f&lLIGA DE FERRO: &aA liga acabou!
    &bGanhador: &a{clan} com {amount} pontos!

stop-none

Mensagem exibida quando a liga termina sem vencedor.

Exemplo:

messages:
  stop-none: |

    &f&lLIGA DE FERRO: &aA liga acabou!
    &cNINGUÉM GANHOU!

rewards-give

Mensagem exibida quando as recompensas são depositadas.

Placeholders:

{player} - Nome do líder que recebeu as recompensas

Exemplo:

messages:
  rewards-give: |
    &f&lLIGA DE FERRO: &aAs recompensas foram depositadas no correio de recompensas do líder &f{player}&a.

Use | no início para criar mensagens com múltiplas linhas.

Mercado da liga

market

Sistema de loja exclusiva da liga usando pontos.

items

Lista de itens disponíveis no mercado.

Exemplo completo:

market:
  items:
    item1:
      # Slot do item no menu
      slot: 11
      # Preço em pontos
      price: 10.0
      # Ícone no menu
      display:
        material: 'STONE'
        name: '&cPedra Misteriosa'
        lore:
          - '&7Esta pedra irá lhe causar'
          - '&7efeitos diferenciados.'
          - ''
          - ' &fPDL necessário: &b10'
          - ''
          - '&7Clique para comprar a pedra'
      # Item que será dado
      item:
        material: 'STONE'
        amount: 64
        name: '&cPedra Misteriosa'
      # Comandos que serão executados
      commands: 
        - 'give {player} stone 64'

Se não quiser dar um item, remova a seção item:. Os comandos ainda serão executados.

Estados da liga

finished e started

Estados internos da liga (não edite manualmente).

Exemplo:

finished: false
started: false

Estes valores são gerenciados automaticamente pelo plugin. Não os altere manualmente.

Criando múltiplas ligas

Você pode criar várias ligas criando novos arquivos na pasta leagues/:

Liga de Bronze (bronze.yml)

yplugins-id: 'yleagues-bronze'
order: 1
start-date: '01/01/2025-00:00'
end-date: '31/01/2025-23:59'
display: '&8Liga de Bronze'
# ... restante da configuração
participate:
  clan-limit: 20
  min-initial-points: 0
  previous-league: 0

Liga de Prata (silver.yml)

yplugins-id: 'yleagues-silver'
order: 2
start-date: '01/02/2025-00:00'
end-date: '28/02/2025-23:59'
display: '&7Liga de Prata'
# ... restante da configuração
participate:
  clan-limit: 15
  min-initial-points: 50.0
  previous-league: 1  # Precisa ter participado da Bronze

Liga de Ouro (gold.yml)

yplugins-id: 'yleagues-gold'
order: 3
start-date: '01/03/2025-00:00'
end-date: '31/03/2025-23:59'
display: '&6Liga de Ouro'
# ... restante da configuração
participate:
  clan-limit: 10
  min-initial-points: 100.0
  previous-league: 2  # Precisa ter participado da Prata

Use o campo order para criar progressão entre ligas e o campo previous-league para exigir participação anterior.

Boas práticas

Planeje as datas

Evite sobrepor ligas. Deixe um intervalo entre elas:

# Liga 1
start-date: '01/01/2025-00:00'
end-date: '15/01/2025-23:59'

# Liga 2 - Começa após a Liga 1
start-date: '16/01/2025-00:00'
end-date: '31/01/2025-23:59'

Balanceie os requisitos

# Liga Iniciante
participate:
  min-initial-points: 0
  prices:
    price1:
      provider: 'money'
      amount: 1000.0

# Liga Avançada
participate:
  min-initial-points: 100.0
  prices:
    price1:
      provider: 'money'
      amount: 10000.0

Use materiais temáticos

# Liga de Ferro
icons:
  finished:
    material: 'IRON_INGOT'

# Liga de Ouro
icons:
  finished:
    material: 'GOLD_INGOT'

# Liga de Diamante
icons:
  finished:
    material: 'DIAMOND'

Após criar ou editar uma liga, execute /liga reload para aplicar as mudanças.

Nesta página