StarLigas

Ligas de clans por temporada: os clans acumulam pontos jogando, disputam o placar e levam premio quando a liga encerra. Complemento do StarClans. Um jar unico da 1.8 a 1.21.

Temporadas com comeco, meio e fim

Cada liga tem data de inicio e de fim no ligas.yml, e comeca e encerra sozinha na hora marcada. Da para encerrar antes por meta de pontos: o primeiro clan a bater o numero leva a temporada.

ferro:
  Nome: '&f&lLIGA DE FERRO'
  Inicio: '01/01/2027-10:00'
  Fim: '01/02/2027-10:00'
  Encerramento:
    Pontos para vencer: 100.0

Varias ligas podem rodar ao mesmo tempo, e uma pode exigir que o clan tenha disputado a anterior — do jeito que se monta uma escada de temporadas.

Um botao para cada situacao

O item da liga no menu muda conforme quem esta olhando: a comecar, participar, participando, encerrada ou sem clan. Cada estado tem o proprio icone e a propria lore, entao da para escrever textos diferentes sem precisar de cinco botoes.

Inscricao que o lider decide

Entrar na liga custa dinheiro, exige um minimo de pontos acumulados e respeita o limite de clans. Por padrao so o lider inscreve o clan — a decisao e do clan, nao de quem clicou primeiro.

De onde vem os pontos

Matar jogador (com bonus por rival), morrer, matar mob (por tipo, com um padrao para o resto), quebrar bloco (com curinga: *_ORE) e pescar.

E qualquer outro plugin manda pontos pela API — e assim que evento, mina, boss ou minigame viram ponto de liga sem o StarLigas precisar conhecer nenhum deles.

Anti-abuso

• Bloco colocado por jogador nao pontua quando for quebrado de volta.
• Anti free kill: a dupla que fica se matando nao pontua.
• Mesmo clan e aliado nao contam — nada de farmar ponto com os proprios amigos.
• Mundos bloqueados e permissao starligas.ignorar para a staff testar sem sujar a liga.

Mercado que custa posicao

O mercado de cada liga e pago com os pontos do placar, e nao com dinheiro. Comprar custa posicao na disputa — e essa e a decisao que o mercado propoe ao clan.

Premio nao se perde

Quando a liga encerra, o premio vai para o correio do jogador, nao para o inventario. O vencedor pode estar offline ou de inventario cheio na hora do encerramento; do correio ele recolhe quando quiser, e o que nao couber continua guardado.

A chance e por premio: duas linhas de 100 entregam as duas; duas de 50 podem nao entregar nenhuma. Da para premiar so o lider ou o clan inteiro.

Ranks por pontos acumulados

O ranks.yml define as faixas — bronze, prata, ouro, diamante, o que voce quiser. O acumulado do clan vale para o rank e para os requisitos de entrada, e nao zera quando a temporada acaba.

Placar e historico

O placar mostra todos os clans em ordem, com pontos, lider, membros e a data de entrada, e a sua posicao fixa na barra de baixo. O historico guarda as colocacoes de cada temporada encerrada.

Feito para servidor cheio

• As ligas ficam na memoria; abrir o menu nao consulta o banco.
• Nada de I/O na thread principal: a gravacao vai para uma fila de uma thread so, em lote, com a liga congelada antes de sair do tique.
• SQLITE ou MYSQL. Com MySQL, a mesma liga vale para varios servidores da rede.

Integracao

• StarClans: e de onde vem os clans, os lideres e as rivalidades. O StarClans, por sua vez, ganha um botao de Ligas nos menus assim que este produto entra no servidor.
• PlaceholderAPI: pontos, rank, posicao, inscritos, tempo restante e o top por posicao — prontos para a scoreboard.
• API propria para outros plugins darem pontos e premios.

Personalizacao

• As ligas no ligas.yml, um bloco por temporada. Copie, apague, crie: o plugin nao repoe os exemplos que voce tirar.
• Premios no recompensas.yml, faixas no ranks.yml.
• Todas as telas no menus.yml; Slot: -1 some com qualquer botao.
• Todas as mensagens no mensagens.yml; mensagem vazia simplesmente nao e enviada.
• Nomes e aliases de comandos e subcomandos trocaveis no comandos.yml.

Requisitos

StarClans instalado. Spigot, Paper ou Purpur da 1.8 a 1.21. Vault e opcional (sem ele, a cobranca da inscricao funciona por comando de console). PlaceholderAPI e opcional, so para os placeholders.