# EzRTP – The random teleport plugin for Minecraft servers **EzRTP** is a powerful, safe, and highly configurable random teleport (RTP) plugin for Minecraft servers. Designed for Paper, Purpur, and Spigot (1.7–1.21+), EzRTP offers advanced features like biome selection, world-border awareness, Vault economy integration, and a modern GUI for world and biome selection. Perfect for survival, adventure, and networked servers seeking a reliable, lag-free RTP experience. **Key Features:** - Compatible with **Paper**, **Purpur**, and **Spigot** (1.7–1.21+) - Requires **Java 17+** - Safe random teleportation with world-border and biome awareness - Modern MiniMessage chat output - Optional Vault economy support for paid teleports - Lightweight, standalone JAR – easy to install and update ## Why Choose EzRTP for Your Minecraft Server? - **Safe Random Teleport (RTP):** `/rtp` finds solid ground inside the configured world border, skips unsafe blocks, and reports the final coordinates with MiniMessage styling. ![RTP GUI – World Selector](https://i.ibb.co/fGCZwJFL/image.png) - **Multi-World & Biome Teleports:** Offer curated destinations for overworld, nether, end, resource, or event worlds with an optional permission-gated GUI selector. Biome selection lets players target their favorite environments. - **Join Protection:** Optionally teleport newcomers (or everyone) on join with delay and bypass permission toggles to prevent spawn camping. - **Vault Economy Integration:** Charge a configurable fee for each teleport, refund on failure, and display friendly "insufficient funds" prompts. Works seamlessly with Vault and popular economy plugins. - **Performance-Conscious Queue:** Throttle heavy usage with a configurable teleport queue that spaces out searches while respecting bypass permissions. - **Purpose-Built & Modular:** Cleanly separates config, command, and teleport logic so you can drop the jar into any survival or network setup without conflicts. --- ## Feature Highlights ### Biome Selector GUI Example The world selector GUI now supports biome selection for RTP: ![Biome Selector GUI](https://i.ibb.co/vvHkb6YC/image.png) ### Biome Stats Example View detailed biome-specific statistics with `/rtp stats biomes`: ![RTP Stats Biomes](https://i.ibb.co/YBy2z8vZ/image.png) - **Heatmap Example** – RTP location distribution can be visualized with a heatmap for analysis and troubleshooting. ![RTP Heatmap](https://i.ibb.co/Z0sDdMz/image.png) - **Interactive world selector** – Enable an inventory GUI with filler items, custom icons, and per-option permissions so players pick their landing zone. - **Safe block filtering** – Maintain a denylist of unsafe floor blocks (lava, water, magma, powder snow, etc.) and expand it per biome or gamemode needs. - **Chunk readiness checks** – Skips ungenerated chunks, ensures the destination chunk is loaded, and applies configurable retry limits. Automatically unloads temporarily loaded chunks to optimize memory usage. - **MiniMessage messaging** – Customize searching, success, failure, queue, and missing-world alerts with Adventure MiniMessage placeholders ``, ``, ``, and more. - **Teleport flair** – Trigger configurable particle effects at the landing spot so players know the teleport completed. - **Economy feedback** – Configure the teleport cost, enable Vault integration automatically, and localise insufficient balance messaging. - **Biome inclusion/exclusion** – Restrict teleports to approved biome lists or skip unwanted regions like oceans and deserts. - **Smart biome pre-caching** – Automatically cache pre-validated safe locations per biome to dramatically improve success rates and reduce lag when biome filters are active. Failed teleport attempts (player offline, insufficient funds) are now also cached to prevent wasting valid locations. Configure cache size, warmup, and expiration in `biomes.pre-cache`. - **RTP statistics & monitoring** – Track RTP performance with `/rtp stats` command showing success rates, cache hit rates, per-biome metrics, and failure causes with actionable recommendations. Use `/rtp stats biomes` for detailed biome-specific analysis. - **Heatmap visualization** – Use `/rtp heatmap [gridSize] [world]` to analyze cached RTP location distribution with grid-based statistical analysis. Verify randomness, detect clustering, and troubleshoot imbalances with configurable grid resolution (16-4096 blocks). - **Performance-conscious queue** – Throttle heavy usage with a configurable teleport queue that spaces out searches while respecting bypass permissions. - **Join-delay scheduler** – Wait a configurable number of ticks after login before teleporting so players load resource packs or tutorials first. - **Reload subcommand** – `/rtp reload` hot-swaps config changes without kicking players or restarting the server. - **Per-player cooldowns, limits, & costs** – Configure per-world, per-group cooldowns, daily/weekly usage limits, and optional cost overrides for `/rtp`, with permission-based bypass and persistent tracking (YAML or MySQL). - **Configurable teleport countdown** – Add an optional, per-player countdown before teleportation with optional bossbar and particle rings. Set `countdown-seconds` or use the `countdown` block in `config.yml` to control visuals and timing. - **Y-level and debug controls** – Restrict random teleports to a min/max Y-level range (`min-y`, `max-y`), and enable detailed debug logging for rejected locations with `debug-rejection-logging` in `config.yml` for troubleshooting safe-location logic. - **Protection-aware search** – Optionally avoid protected regions/claims by enabling `protection.avoid-claims` and listing providers like `worldguard` or `griefprevention`. ## Quick Start 1. Drop `EzRTP.jar` into your Paper or Purpur `plugins/` directory and restart the server. 2. Edit `plugins/EzRTP/config.yml` to set the target world, teleport center, radius bounds, teleport cost, unsafe block list, particles, and on-join behaviour. 3. Localise the MiniMessage output in `plugins/EzRTP/messages.yml` so the searching, success, failure, and queue prompts match your server's style. 4. Toggle `enabled` inside `gui.yml` and add world entries to present a permission-aware teleport selector menu. 5. Adjust `queue.yml` if you need to throttle teleport requests during peak hours or grant bypass permissions to staff. 6. Hook Vault + your economy plugin if you want to charge for teleports; leave `cost` at `0` for free usage. 7. Run `/rtp reload` or restart once you finish editing to apply the new settings. ## Commands & Permissions | Command | Description | Permission | |----------------------|--------------------------------------------------|----------------------| | `/rtp` | Teleport the executing player to a random safe location. | `ezrtp.use` (default: true) | | `/rtp reload` | Reload EzRTP configuration from disk. | `ezrtp.reload` (default: op) | | `/rtp stats` | View comprehensive RTP statistics including cache performance, success rates, and per-biome metrics. | `ezrtp.stats` (default: op) | | `/rtp stats biomes` | View detailed biome-specific statistics showing top biomes by activity, success rates, and average teleport times. | `ezrtp.stats` (default: op) | | `/rtp heatmap [gridSize] [world]` | Visualize cached RTP location distribution with grid-based heatmap analysis. Verify randomness, detect clustering, and troubleshoot imbalances with configurable grid resolution (16-4096 blocks). | `ezrtp.heatmap` (default: op) | Grant `ezrtp.queue.bypass` to let trusted players skip the queue, and assign per-option GUI permissions directly in `gui.yml`. ## Configuration Overview

config.yml

```yml # EzRTP teleport configuration # Set to true to enable debug logging for rejected random teleport locations (for troubleshooting safe location logic). debug-rejection-logging: false # Enable or disable bStats metrics (https://bstats.org/plugin/bukkit/EzRTP/27735) # These anonymous metrics help track plugin usage and performance across servers. enable-bstats: true # Optional: restrict random teleport Y-levels (inclusive). If omitted, world min/max height is used. # min-y: 64 # max-y: 120 world: world center: x: 0 z: 0 radius: min: 256 # max: 2048 use-world-border: true max-attempts: 32 cost: 0.0 countdown-seconds: 0 # Optional countdown before teleport (0 = disabled) countdown: # Optional: override countdown seconds here instead of countdown-seconds. # seconds: 5 bossbar: enabled: false title: "Teleporting in seconds..." color: YELLOW style: SOLID particles: enabled: true # Primary Bukkit particle to use for the countdown ring. type: ENCHANTMENT_TABLE # Number of points in the ring around the player. points: 12 # Ring radius in blocks. radius: 1.2 # Height offset from the player's feet. height-offset: 0.8 # Additional speed/extra parameter passed to the particle effect. extra: 0.0 # Force the particles to render for players at long distances (1.13+ servers). force: false # Optional secondary sparkle particle. secondary-particle: PORTAL secondary-count: 6 secondary-offset: 0.35 unsafe-blocks: - WATER - LAVA - MAGMA_BLOCK - POWDER_SNOW - FIRE - CAMPFIRE - SOUL_FIRE biomes: # Optional: list of allowed biomes. Leave empty to allow all. include: [] # Optional: list of biomes to avoid. exclude: [] # Pre-caching configuration for biome-filtered RTPs # When enabled, the server will pre-generate and cache safe locations for biome filters, # significantly improving RTP success rates and reducing failed attempts. pre-cache: # Toggle pre-caching on/off. Enabled by default for better RTP performance with biome filters. enabled: true # Maximum number of locations to cache per biome (higher = better hit rate but more memory) max-per-biome: 50 # Number of locations to pre-generate during server startup/reload for each configured biome warmup-size: 20 # How long (in minutes) cached locations remain valid before expiring expiration-minutes: 10 protection: avoid-claims: false providers: - worldguard - griefprevention particles: enabled: false type: PORTAL count: 40 offset: x: 0.5 y: 1.0 z: 0.5 extra: 0.0 force: false on-join: enabled: false only-first-join: false bypass-permission: "" delay-ticks: 40 # RTP cooldowns and usage limits rtp-limits: default: cooldown-seconds: 300 # Cooldown in seconds between /rtp uses daily-limit: 10 # Max uses per day weekly-limit: 50 # Max uses per week cost: 0.0 # Optional cost override for this group worlds: world: default: cooldown-seconds: 300 daily-limit: 10 weekly-limit: 50 cost: 0.0 group.vip: cooldown-seconds: 60 daily-limit: 50 weekly-limit: 200 cost: 0.0 world_nether: default: cooldown-seconds: 600 daily-limit: 5 weekly-limit: 20 cost: 0.0 group.staff: cooldown-seconds: 0 daily-limit: -1 # -1 = unlimited weekly-limit: -1 cost: 0.0 bypass-permissions: - ezrtp.bypass.cooldown - ezrtp.bypass.limit storage: yaml # or mysql mysql: url: jdbc:mysql://localhost:3306/mc user: root password: "" ```

messages.yml

```yml # EzRTP MiniMessage templates # Placeholders: , , , , , , , teleporting: "Searching for a safe location..." teleport-success: "Teleported to , in ." teleport-failed: "Unable to find a safe location. Please try again." teleport-failed-biome: "No valid biome was found. Please try again or try a different biome filter." world-missing: "The configured world '' is not available." join-searching: "Finding you a safe place to explore..." insufficient-funds: "You need to use random teleport." queue-queued: "You joined the random teleport queue. Position: ." queue-full: "The random teleport queue is currently full. Please try again soon." # Cooldown and usage limit messages cooldown: "You must wait seconds before using /rtp again." limit-daily: "You have reached your daily /rtp limit for this world." limit-weekly: "You have reached your weekly /rtp limit for this world." # Countdown messages countdown-start: "Teleporting in seconds..." countdown-tick: "..." ```

queue.yml

```yml # EzRTP teleport queue configuration enabled: false max-size: 0 bypass-permission: "ezrtp.queue.bypass" start-delay-ticks: 20 interval-ticks: 40 ```

gui.yml

```yml # EzRTP GUI configuration enabled: false title: "Select a destination" rows: 1 no-permission-message: "You do not have permission to teleport there." filler: enabled: true material: GRAY_STAINED_GLASS_PANE name: " " worlds: overworld: # slot: 0 permission: "" icon: material: GRASS_BLOCK name: "Overworld" lore: - "Teleport to a random location in the overworld." settings: world: world radius: min: 256 use-world-border: true resource: slot: 1 permission: "ezrtp.gui.resource" icon: material: IRON_PICKAXE name: "Resource World" lore: - "Gather materials without ruining the main world." settings: world: resource radius: min: 512 max: 4096 use-world-border: false ```

network.yml

```yml # EzRTP proxy / network configuration enabled: false lobby: false ping-interval-ticks: 200 ping-timeout-millis: 1500 servers: skyblock: bungee-server: "skyblock" host: "127.0.0.1" port: 25566 slot: 4 permission: "" display-name: "Skyblock" hide-when-offline: false allow-when-offline: false connect-message: "Connecting you to ..." offline-message: " is currently unavailable." icon: material: ENDER_PEARL name: "" lore: - "Status: " - "Ping: ms" ```

## Requirements - Java 17 or newer - Paper, Purpur, or SpigotMC 1.21+ server build - Optional: Vault + an economy plugin if you want to charge for teleports - Optional: A permissions plugin (LuckPerms, etc.) if you want granular control over `/rtp reload`, queue bypass, GUI option access, or cost bypasses ## Support & Links - Need help? [Join our Discord](https://discord.gg/yWP95XfmBS) and open a ticket under the EzRTP category. - Share seeds, biome rules, or config presets on the discussion tab so other admins can jumpstart their setup. - Pair EzRTP with EzSpawners, EzAuction, and the rest of the Ez-series utilities for a cohesive network toolkit. - [Get EzEconomy – Modern Vault Economy Plugin](https://www.spigotmc.org/resources/1-21-ezeconomy-modern-vault-economy-plugin-for-minecraft-servers.130975/) --- **Ready to launch players into adventure?** Install EzRTP and give explorers a safe, stylish way to discover your world, across every dimension! [![Try the other Minecraft plugins in the EzPlugins series](https://i.ibb.co/PzfjNjh0/ezplugins-try-other-plugins.png)](https://modrinth.com/collection/Q98Ov6dA)

Published on	January 17, 2026
Downloads	2

EzRTP

Release 1.3.1

Shadow48402 released EzRTP version 1.3.1 on Yesterday 7:07 AM

Information

Platforms

Dependencies

Release
1.3.1