Plugin Minecraft SimpleTpa

🔌 Sobre o SimpleTPA

SimpleTPA é um plugin de Minecraft que fornece um sistema simples de solicitação de teleporte (TPA) para servidores. Ele permite que os jogadores enviem pedidos de teleporte para outros jogadores, aceitem ou neguem solicitações recebidas, cancelem solicitações enviadas e bloqueiem solicitações recebidas com um alternador. O plugin foca em um fluxo de trabalho compacto e configurável para pedidos de teleporte no jogo e configuração no lado do servidor.

🎯 Objetivo

O SimpleTPA resolve a necessidade comum de teleporte controlado entre jogadores em servidores multiplayer. Ele evita spam por meio de cooldowns e da regra de uma única solicitação pendente, oferece suporte a warmup/atraso antes do teleporte e dá aos administradores do servidor comportamento configurável para timeouts, sons e registros.

⚙️ Recursos

• Pedidos de teleporte entre jogadores via /tpa e pedidos reversos via /tpahere.
• Ações para aceitar, negar e cancelar pedidos (/tpaccept, /tpdeny, /tpacancel).
• Ative ou desative o recebimento de solicitações com /tpatoggle.
• Timeout de solicitação configurável (padrão mostrado como 60 segundos).
• Cooldown configurável entre envios de solicitações para reduzir spam.
• Warmup/atraso do teleporte com contagem regressiva na action bar e cancelamento ao se mover ou sofrer dano.
• Apenas uma solicitação pendente por jogador para evitar solicitações sobrepostas.
• Efeitos sonoros personalizáveis para solicitação, aceitação, negação e teleporte bem-sucedido.
• Suporte total a códigos de cor para mensagens e opções detalhadas de registro para administradores.

🧩 Para quem é

• Servidores Survival/SMP pequenos e médios que querem um sistema leve de TPA.
• Servidores que preferem um comportamento mínimo e configurável de pedidos de teleporte em vez de uma suíte maior de teleporte.
• Administradores que querem configuração por servidor para cooldowns, warmups e logs.

🏗️ Casos de uso de exemplo

• Um jogador usa /tpa para pedir teleporte a um amigo; o amigo aceita com /tpaccept e o plugin aplica um warmup configurado antes do teleporte.
• A equipe do servidor ativa /tpatoggle para membros da staff bloquearem solicitações aleatórias de teleporte durante eventos ou tarefas de moderação.
• Administradores definem um cooldown para evitar que jogadores enviem solicitações de teleporte em spam.

⌨️ Comandos

🔐 Permissões

⚙️ Instalação

📥 Configuração

• Baixe o JAR do plugin na página oficial de recursos do plugin.
• Coloque o arquivo .jar baixado no diretório plugins/ do seu servidor Spigot.
• Reinicie o servidor e verifique o console do servidor para mensagens de carregamento do plugin.

📦 Dependências

• Nenhuma dependência obrigatória está documentada.

🧾 Configuração

• O plugin usa um arquivo de configuração (indicado como config.yml no recurso do plugin). Ao atualizar entre versões principais, o autor recomenda remover o config.yml existente antes de reiniciar para que as novas chaves padrão sejam aplicadas.
• As opções de configuração expostas incluem timeout de solicitação, cooldowns, warmup do teleporte, cancelamento por movimento/dano, configurações de som, códigos de cor das mensagens e opções de log.

🧠 Notas técnicas

• Versões do Minecraft com suporte confirmado (conforme listado no recurso do plugin): 1.19, 1.20, 1.20.6 e 1.21.
• Plataforma confirmada: Spigot.
• O plugin implementa timeouts, cooldowns e mecânicas de warmup no lado do servidor e faz limpeza automática de solicitações expiradas.

🤝 Quando este plugin é útil

SimpleTPA é útil quando você precisa de um sistema focado e configurável de pedidos de teleporte sem adicionar uma suíte completa de teleporte/casas. Ele se encaixa em servidores que querem fluxos de /tpa diretos, cooldowns para evitar spam e comportamento de warmup para teleportes mais seguros.