# \ud83c\udf0d P_Randomtp<\/p>\n
Plugin de **Random Teleport (RTP)** otimizado para servidores **Paper\/Spigot 1.21+**.
\nPermite que jogadores se teleportem para locais aleat\u00f3rios seguros em um mundo, evitando lag e falhas t\u00edpicas de plugins de RTP.<\/p>\n
## \u2728 Recursos<\/p>\n
– \ud83d\udd04 **Teleporte Aleat\u00f3rio Seguro** \u2013 evita l\u00edquidos, blocos perigosos e tetos do Nether.
\n– \ud83e\udded **Raio adaptativo** \u2013 expande automaticamente a \u00e1rea de busca se n\u00e3o encontrar local v\u00e1lido.
\n– \u26a1 **Busca fatiada por tick** \u2013 executa tentativas de forma distribu\u00edda, sem travar o servidor.
\n– \ud83d\udce6 **Carregamento ass\u00edncrono de chunks** \u2013 garante RTP r\u00e1pido mesmo em dist\u00e2ncias grandes.
\n– \ud83d\udee1\ufe0f **Integra\u00e7\u00e3o com WorldGuard** (opcional) \u2013 respeita regi\u00f5es protegidas.
\n– \ud83d\udcb0 **Integra\u00e7\u00e3o com Vault** (opcional) \u2013 cobra valores customizados por mundo.
\n– \u23f3 **Warmup, cooldown e tiers por permiss\u00e3o** \u2013 configura\u00e7\u00f5es flex\u00edveis para balancear o uso.
\n– \ud83c\udf10 **Multi-idioma (pt_br, en_us)** \u2013 mensagens personalizadas por idioma ou for\u00e7adas no `config.yml`.<\/p>\n
—<\/p>\n
## \ud83d\udce5 Instala\u00e7\u00e3o<\/p>\n
1. Baixe o arquivo `.jar` compilado do plugin.
\n2. Coloque em `plugins\/` no seu servidor **Paper 1.21+**.
\n3. Reinicie o servidor para gerar os arquivos de configura\u00e7\u00e3o.
\n4. Edite `config.yml` conforme necess\u00e1rio.
\n5. (Opcional) Instale **Vault** para cobrar por RTP e **WorldGuard** para respeitar prote\u00e7\u00f5es.<\/p>\n
—<\/p>\n
## \u2699\ufe0f Configura\u00e7\u00e3o<\/p>\n
O arquivo [`config.yml`](.\/src\/main\/resources\/config.yml) possui v\u00e1rias op\u00e7\u00f5es.
\nExemplo de configura\u00e7\u00e3o otimizada (trecho):<\/p>\n
“`
\nsettings:
\n cooldown-seconds: 60
\n warmup-seconds: 3
\n per-tick-attempts: 6
\n loaded-chunks-only: false
\n allow-chunk-load: true
\n async-chunk-loads-parallel: 8
\n max-attempts: 120
\n adaptive-radius:
\n enabled: true
\n step-percent: 25
\n max-multiplier: 3.0
\n “`
\n| Permiss\u00e3o | Descri\u00e7\u00e3o | Default |
\n| ———————– | ———————————————- | ————— |
\n| `prandomtp.use` | Permite usar `\/rtp` | \u2705 todos |
\n| `prandomtp.bypass` | Ignora cooldown | \u274c apenas OP |
\n| `prandomtp.free` | Usa RTP sem custo (Vault) | \u274c apenas OP |
\n| `prandomtp.world.*` | Permite selecionar qualquer mundo com `\/rtp` | \u274c apenas OP |
\n| `prandomtp.admin` | Acesso ao `\/rtp reload` | \u274c apenas OP |
\n| `prandomtp.tier.vip` | Tier customizado (cooldown menor, +raio) | \u274c apenas VIP |
\n| `prandomtp.tier.legend` | Tier customizado (cooldown muito menor, +raio) | \u274c apenas Legend |<\/p>\n
| Comando | Uso | Descri\u00e7\u00e3o | # \ud83e\udde9 Integra\u00e7\u00f5es<\/p>\n – Vault \u2013 cobra valor configurado por mundo (economy.cost.per-world).<\/p>\n – WorldGuard \u2013 impede teleporte em \u00e1reas protegidas.<\/p>\n – bStats \u2013 envia m\u00e9tricas an\u00f4nimas (opcional).<\/p>\n ## \ud83d\udd0c API P\u00fablica (para outros plugins)<\/p>\n – Interface dispon\u00edvel via ServicesManager:<\/p>\n – RtpService service = Bukkit.getServicesManager().load(RtpService.class);<\/p>\n – \/\/ Encontrar um local seguro – \/\/ Solicitar RTP completo (como se fosse \/rtp) – Eventos dispon\u00edveis (RtpEvents):<\/p>\n – WarmupStartEvent<\/p>\n – WarmupCancelEvent<\/p>\n – SuccessEvent<\/p>\n – FailEvent<\/p>\n ## \ud83d\ude80 Otimiza\u00e7\u00e3o<\/p>\n – Use allow-chunk-load: true e async-chunk-loads-parallel ajustado conforme o hardware. <\/p>\n – Ajuste per-tick-attempts (4\u20138 \u00e9 ideal). <\/p>\n – Use adaptive-radius para reduzir falhas em seeds com muitos oceanos.<\/p>\n – Se for servidor com muito player simult\u00e2neo, limite RTPs concorrentes (sem\u00e1foro global).<\/p>\n ## \u2753 FAQ<\/p>\n ## \u2753 – O RTP falha em mundos com muito oceano, e agora? ## \u2753 – D\u00e1 lag quando o jogador usa RTP de 2000 blocos. ## \u2753 – Como adicionar mais idiomas? ## \u2753 – Posso desativar RTP em mundos espec\u00edficos? ## \ud83d\udcca bStats<\/p>\n ## \ud83d\udc68\u200d\ud83d\udcbb Autor<\/p>\n – Desenvolvido por Pedro. Sugest\u00f5es, bugs ou PRs s\u00e3o bem-vindos!<\/p>\n # \ud83c\udf0d P_Randomtp<\/p>\n An optimized **Random Teleport (RTP)** plugin for **Paper\/Spigot 1.21+** servers. —<\/p>\n ## \u2728 Features<\/p>\n – \ud83d\udd04 **Safe Random Teleport** \u2013 avoids liquids, dangerous blocks, and Nether ceilings. —<\/p>\n ## \ud83d\udce5 Installation<\/p>\n 1. Download the compiled `.jar` file of the plugin. —<\/p>\n ## \u2699\ufe0f Configuration<\/p>\n The [`config.yml`](.\/src\/main\/resources\/config.yml) file contains several options. “`yaml ### \ud83d\udd11 Permissions<\/p>\n | Permission | Description | Default | ### \u2328\ufe0f Commands<\/p>\n | Command | Usage | Description | —<\/p>\n ## \ud83e\udde9 Integrations<\/p>\n – **Vault** \u2013 charges configured cost per world (`economy.cost.per-world`). —<\/p>\n ## \ud83d\udd0c Public API (for other plugins)<\/p>\n Available through **ServicesManager**: <\/p>\n “`java \/\/ Find a safe location \/\/ Request a full RTP (same as \/rtp) ### \ud83d\udce1 Events (RtpEvents)<\/p>\n – `WarmupStartEvent` —<\/p>\n ## \ud83d\ude80 Optimization<\/p>\n – Use `allow-chunk-load: true` and tune `async-chunk-loads-parallel` according to your hardware. —<\/p>\n ## \u2753 FAQ<\/p>\n ### \u2753 RTP fails in worlds with too many oceans, what now? ### \u2753 There’s lag when players RTP 2000+ blocks away. ### \u2753 How to add more languages? ### \u2753 Can I disable RTP in specific worlds? —<\/p>\n ## \ud83d\udcca bStats<\/p>\n (Optional) Anonymous metrics are collected via **bStats**. <\/p>\n —<\/p>\n ## \ud83d\udc68\u200d\ud83d\udcbb Author<\/p>\n – Developed by **Pedro**. Suggestions, bug reports, and PRs are welcome!<\/p>\n","protected":false},"excerpt":{"rendered":" Plugin de Random Teleport RTP otimizado
\n| ————– | ——————- | ———————————————— |
\n| `\/rtp` | `\/rtp` | Teleporta para um local aleat\u00f3rio no mundo atual |
\n| `\/rtp
\n| `\/rtp reload` | `\/rtp reload` | Recarrega a configura\u00e7\u00e3o e mensagens |<\/p>\n
\nLocation safe = service.findSafeLocation(player, world);<\/p>\n
\nservice.requestRtp(player, world);<\/p>\n
\nAtive adaptive-radius e aumente max-attempts para permitir expandir al\u00e9m dos oceanos.<\/p>\n
\nCertifique-se de estar no Paper 1.21+ e habilite allow-chunk-load: true. O carregamento \u00e9 ass\u00edncrono, n\u00e3o trava o tick.<\/p>\n
\nCrie arquivos em plugins\/P_Randomtp\/idiomas\/ com o c\u00f3digo da l\u00edngua, ex.: es_es.yml.<\/p>\n
\nSim, configure worlds.
\nAllows players to safely teleport to random locations in a world, avoiding lag and common RTP plugin issues.<\/p>\n
\n– \ud83e\udded **Adaptive radius** \u2013 automatically expands the search area if no valid spot is found.
\n– \u26a1 **Per-tick sliced search** \u2013 spreads attempts across ticks to avoid server freezes.
\n– \ud83d\udce6 **Asynchronous chunk loading** \u2013 ensures fast RTP even at large distances.
\n– \ud83d\udee1\ufe0f **WorldGuard integration** (optional) \u2013 respects protected regions.
\n– \ud83d\udcb0 **Vault integration** (optional) \u2013 charge custom prices per world.
\n– \u23f3 **Warmup, cooldown, and permission tiers** \u2013 flexible settings to balance usage.
\n– \ud83c\udf10 **Multi-language (pt_br, en_us)** \u2013 customizable messages per language or forced in `config.yml`.<\/p>\n
\n2. Place it inside the `plugins\/` folder of your **Paper 1.21+** server.
\n3. Restart the server to generate the configuration files.
\n4. Edit `config.yml` as needed.
\n5. (Optional) Install **Vault** to charge for RTP and **WorldGuard** to respect protections. <\/p>\n
\nExample of an optimized setup (snippet): <\/p>\n
\nsettings:
\n cooldown-seconds: 60
\n warmup-seconds: 3
\n per-tick-attempts: 6
\n loaded-chunks-only: false
\n allow-chunk-load: true
\n async-chunk-loads-parallel: 8
\n max-attempts: 120
\n adaptive-radius:
\n enabled: true
\n step-percent: 25
\n max-multiplier: 3.0
\n“`<\/p>\n
\n| ———————– | ———————————————- | ———– |
\n| `prandomtp.use` | Allows using `\/rtp` | \u2705 everyone |
\n| `prandomtp.bypass` | Ignores cooldown | \u274c OP only |
\n| `prandomtp.free` | RTP without cost (Vault) | \u274c OP only |
\n| `prandomtp.world.*` | Allows teleporting to any world with `\/rtp` | \u274c OP only |
\n| `prandomtp.admin` | Access to `\/rtp reload` | \u274c OP only |
\n| `prandomtp.tier.vip` | Custom tier (shorter cooldown, larger radius) | \u274c VIP only |
\n| `prandomtp.tier.legend` | Custom tier (much shorter cooldown, big radius)| \u274c Legend |<\/p>\n
\n| ————– | ——————- | ————————————————– |
\n| `\/rtp` | `\/rtp` | Teleports to a random location in the current world|
\n| `\/rtp
\n| `\/rtp reload` | `\/rtp reload` | Reloads configuration and messages |<\/p>\n
\n– **WorldGuard** \u2013 prevents teleportation into protected regions.
\n– **bStats** \u2013 sends anonymous metrics (optional). <\/p>\n
\nRtpService service = Bukkit.getServicesManager().load(RtpService.class);<\/p>\n
\nLocation safe = service.findSafeLocation(player, world);<\/p>\n
\nservice.requestRtp(player, world);
\n“`<\/p>\n
\n– `WarmupCancelEvent`
\n– `SuccessEvent`
\n– `FailEvent` <\/p>\n
\n– Adjust `per-tick-attempts` (4\u20138 is ideal).
\n– Use `adaptive-radius` to reduce failures on seeds with large oceans.
\n– For high player count servers, limit concurrent RTPs (global semaphore). <\/p>\n
\nEnable `adaptive-radius` and increase `max-attempts` to expand beyond oceans. <\/p>\n
\nMake sure you are on **Paper 1.21+** and enable `allow-chunk-load: true`.
\nLoading is asynchronous and will not freeze the main tick. <\/p>\n
\nCreate files in `plugins\/P_Randomtp\/languages\/` with the language code, e.g. `es_es.yml`. <\/p>\n
\nYes, set `worlds.
\nOptimized Random Teleport RTP plugin<\/p>\n","protected":false},"featured_media":118730,"template":"","meta":{"_minecraft_slug":"p_randomtp","_minecraft_project_id":"hV8zxsFG","_minecraft_author":"Mr_Haruki","_minecraft_license":"MIT","_minecraft_downloads":190,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"p_randomtp.zip","_minecraft_size_bytes":42048,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T12:49:58.607511Z","_minecraft_date_created":"2025-08-27T00:27:29.040123Z","_minecraft_date_modified":"2025-08-25T21:51:23.931876Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/p_randomtp","_minecraft_icon_attachment_id":118730,"_minecraft_imported_at":"2026-06-06T23:34:14+00:00","_minecraft_import_hash":"369449dfa0fd93e268841f70cc40a480","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,124,844,89,122,126,90,127,129,869,92],"mod_loader":[130,132,134],"minecraft_version":[62,37,73,74,38,78,79,80,81],"class_list":["post-118729","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-bukkit","mod_category-economy","mod_category-game-mechanics","mod_category-magic","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-spigot","mod_category-transportation","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8"],"yoast_head":"\n