Início

Visão Geral

Kothar é um poderoso plugin King of the Hill (KOTH) que inclui:

• 🎯 Múltiplos Modos de Captura: Tempo clássico, Pontos e modo OVERLOAD multi-zonas
• 📊 Classificações: Visualizador GUI de vitórias/capturas/XP
• 🎨 Exibições Visuais: Suporte BossBar, Scoreboard, Holograma e Waypoints
• 🔗 Arenas Vinculadas: Conecte vários KOTHs para compartilhar pontuações
• 🛡️ Sistema Anti-Randy: Requisitos de tempo de jogo para evitar alts
• 📢 Integração Discord: Notificações webhook para eventos
• 🔄 Auto-Atualização: Atualizações GitHub com um clique
• 🌍 Multi-Idioma: Inglês, Espanhol, Francês, Português, Russo

Requisitos

Servidor

• Tipo: Spigot ou Paper (Paper recomendado)
• Versão: 1.20+

Dependências

• Hard: Apollo-Bukkit (obrigatório)

Integrações Opcionais

• PlaceholderAPI
• ProtocolLib
• packetevents
• TAB
• Plugins de clãs/equipes (ClansX, SimpleClans, Factions, etc.)

Início Rápido

1. Instale Apollo-Bukkit.
2. Coloque Kothar-<version>.jar na pasta plugins/.
3. Inicie o servidor.
4. Configure os arquivos em plugins/Kothar/
5. Recarregue com /kothar reload

Comandos

Comandos de Jogador

• /kothar help - Mostrar ajuda
• /kothar list - Listar KOTHs
• /kothar info <nome> - Ver detalhes
• /kothar top [wins|captures|coins|xp] - Classificação
• /kothar shop - Abrir loja
• /kothar rank - Ver rank
• /kothar balance - Ver saldo
• /kothar pay <jogador> <quantia> - Transferir moedas
• /kothar playtime [jogador] - Tempo de jogo (Anti-Randy)

Comandos de Admin

• /kothar create <nome> - Criar KOTH
• /kothar delete <nome> - Excluir KOTH
• /kothar start <nome> - Iniciar evento
• /kothar stop <nome> - Parar evento
• /kothar select <nome> - Modo seleção
• /kothar setzone <nome> <cor> - Zonas OVERLOAD
• /kothar reload - Recarregar configuração
• /kothar update - Atualizar plugin
• /kothar coins <give|take|set> <jogador> <quantia> - Gerenciar moedas

Permissões

Admin

• kothar.admin - Todas as permissões de admin
• kothar.admin.create - Criar arenas
• kothar.admin.delete - Excluir arenas
• kothar.admin.start - Iniciar eventos
• kothar.admin.stop - Parar eventos
• kothar.admin.select - Seleção de zonas
• kothar.admin.reload - Recarregar
• kothar.admin.update - Atualizar
• kothar.admin.coins - Gerenciar moedas

Jogador

• kothar.top - Ver classificações
• kothar.info - Ver info
• kothar.command.shop - Usar loja
• kothar.command.rank - Ver rank
• kothar.command.balance - Ver saldo
• kothar.command.pay - Transferir

Bypass

• kothar.bypass.antirandys - Ignorar Anti-Randy

Configuração

Arquivos de configuração:

• plugins/Kothar/config.yml
• plugins/Kothar/database.yml
• plugins/Kothar/ranks.yml
• plugins/Kothar/shops.yml
• plugins/Kothar/webhook.yml
• plugins/Kothar/langs/messages_pt.yml

Configuração do KOTH

KOTH Clássico

1. /kothar create <nome>
2. /kothar select <nome>
3. Selecione pos1/pos2 com a varinha
4. /kothar select <nome> novamente para salvar
5. /kothar start <nome>

KOTH OVERLOAD (4 Zonas)

Requer 4 zonas: VERMELHO, AZUL, VERDE, AMARELO

1. Coloque o KOTH em modo OVERLOAD
2. /kothar select <nome>
3. Selecione e aplique cada cor:
   • /kothar setzone <nome> RED
   • /kothar setzone <nome> BLUE
   • /kothar setzone <nome> GREEN
   • /kothar setzone <nome> YELLOW

Recursos de Visualização

BossBar

Configurado em config.yml em display.bossbar.

Scoreboard

Configurado em config.yml em display.scoreboard.

Holograma

Configurado em config.yml em display.hologram.

Waypoints

Configurado em config.yml em display.waypoints.

Webhook do Discord

Configure webhook.yml.

• Eventos incorporados
• Publicação opcional de classificações
• Rate limiting

Sistema de Atualização

Comando: /kothar update

Baixa automaticamente o último .jar do GitHub Releases.

Placeholders

• {player} - Nome do jogador
• {koth} - Nome do KOTH
• {time} - Tempo restante
• {location} - Coordenadas X, Z
• {capturer} - Capturador atual
• {winner} - Vencedor
• {progress} - Progresso
• {points} - Pontos
• {team} - Equipe

Solução de Problemas

"Este comando só pode ser executado por um jogador"

Você executou um comando apenas-jogador do console. Use-o no jogo.

"Não há jogadores suficientes online…"

A configuração min-players é maior que os jogadores online.

"O KOTH não está configurado corretamente"

Você deve configurar a zona/ponto de spawn via GUI ou seleção.

A loja não faz nada

• Verifique o console por erros de comandos em shops.yml.
• Valide nomes de materiais e sintaxe de comandos.

API para Desenvolvedores

Kothar expõe uma API e eventos.

Eventos

• KotharStartEvent
• KotharEndEvent
• KotharStopEvent
• KotharCaptureEvent
• KotharWinEvent

Acesso Principal

• Kothar.getAPI()
• Kothar.getInstance()