P_Randomtp

# 🌍 P_Randomtp Plugin de **Random Teleport (RTP)** otimizado para servidores **Paper/Spigot 1.21+**. Permite que jogadores se teleportem para locais aleatórios seguros em um mundo, evitando lag e falhas típicas de plugins de RTP. ## ✨ Recursos - 🔄 **Teleporte Aleatório Seguro** – evita líquidos, blocos perigosos e tetos do Nether. - 🧭 **Raio adaptativo** – expande automaticamente a área de busca se não encontrar local válido. - ⚡ **Busca fatiada por tick** – executa tentativas de forma distribuída, sem travar o servidor. - 📦 **Carregamento assíncrono de chunks** – garante RTP rápido mesmo em distâncias grandes. - 🛡️ **Integração com WorldGuard** (opcional) – respeita regiões protegidas. - 💰 **Integração com Vault** (opcional) – cobra valores customizados por mundo. - ⏳ **Warmup, cooldown e tiers por permissão** – configurações flexíveis para balancear o uso. - 🌐 **Multi-idioma (pt_br, en_us)** – mensagens personalizadas por idioma ou forçadas no `config.yml`. --- ## 📥 Instalação 1. Baixe o arquivo `.jar` compilado do plugin. 2. Coloque em `plugins/` no seu servidor **Paper 1.21+**. 3. Reinicie o servidor para gerar os arquivos de configuração. 4. Edite `config.yml` conforme necessário. 5. (Opcional) Instale **Vault** para cobrar por RTP e **WorldGuard** para respeitar proteções. --- ## ⚙️ Configuração O arquivo (./src/main/resources/config.yml) possui várias opções. Exemplo de configuração otimizada (trecho): ``` settings: cooldown-seconds: 60 warmup-seconds: 3 per-tick-attempts: 6 loaded-chunks-only: false allow-chunk-load: true async-chunk-loads-parallel: 8 max-attempts: 120 adaptive-radius: enabled: true step-percent: 25 max-multiplier: 3.0 ``` | Permissão | Descrição | Default | | ----------------------- | ---------------------------------------------- | --------------- | | `prandomtp.use` | Permite usar `/rtp` | ✅ todos | | `prandomtp.bypass` | Ignora cooldown | ❌ apenas OP | | `prandomtp.free` | Usa RTP sem custo (Vault) | ❌ apenas OP | | `prandomtp.world.*` | Permite selecionar qualquer mundo com `/rtp` | ❌ apenas OP | | `prandomtp.admin` | Acesso ao `/rtp reload` | ❌ apenas OP | | `prandomtp.tier.vip` | Tier customizado (cooldown menor, +raio) | ❌ apenas VIP | | `prandomtp.tier.legend` | Tier customizado (cooldown muito menor, +raio) | ❌ apenas Legend | | Comando | Uso | Descrição | | -------------- | ------------------- | ------------------------------------------------ | | `/rtp` | `/rtp` | Teleporta para um local aleatório no mundo atual | | `/rtp <mundo>` | `/rtp world_nether` | Teleporta para outro mundo (se permitido) | | `/rtp reload` | `/rtp reload` | Recarrega a configuração e mensagens | # 🧩 Integrações - Vault – cobra valor configurado por mundo (economy.cost.per-world). - WorldGuard – impede teleporte em áreas protegidas. - bStats – envia métricas anônimas (opcional). ## 🔌 API Pública (para outros plugins) - Interface disponível via ServicesManager: - RtpService service = Bukkit.getServicesManager().load(RtpService.class); - // Encontrar um local seguro Location safe = service.findSafeLocation(player, world); - // Solicitar RTP completo (como se fosse /rtp) service.requestRtp(player, world); - Eventos disponíveis (RtpEvents): - WarmupStartEvent - WarmupCancelEvent - SuccessEvent - FailEvent ## 🚀 Otimização - Use allow-chunk-load: true e async-chunk-loads-parallel ajustado conforme o hardware. - Ajuste per-tick-attempts (4–8 é ideal). - Use adaptive-radius para reduzir falhas em seeds com muitos oceanos. - Se for servidor com muito player simultâneo, limite RTPs concorrentes (semáforo global). ## ❓ FAQ ## ❓ - O RTP falha em mundos com muito oceano, e agora? Ative adaptive-radius e aumente max-attempts para permitir expandir além dos oceanos. ## ❓ - Dá lag quando o jogador usa RTP de 2000 blocos. Certifique-se de estar no Paper 1.21+ e habilite allow-chunk-load: true. O carregamento é assíncrono, não trava o tick. ## ❓ - Como adicionar mais idiomas? Crie arquivos em plugins/P_Randomtp/idiomas/ com o código da língua, ex.: es_es.yml. ## ❓ - Posso desativar RTP em mundos específicos? Sim, configure worlds.<nome>.allow: false no config.yml. ## 📊 bStats ## 👨‍💻 Autor - Desenvolvido por Pedro. Sugestões, bugs ou PRs são bem-vindos! # 🌍 P_Randomtp An optimized **Random Teleport (RTP)** plugin for **Paper/Spigot 1.21+** servers. Allows players to safely teleport to random locations in a world, avoiding lag and common RTP plugin issues. --- ## ✨ Features - 🔄 **Safe Random Teleport** – avoids liquids, dangerous blocks, and Nether ceilings. - 🧭 **Ad