# 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 generate in-game maps showing 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`. - **Per-world daily limit controls** – Disable daily and weekly RTP limits per world with `disable-daily-limit: true` for unlimited usage in specific worlds while maintaining limits elsewhere. - **Flexible GUI cooldown behavior** – Configure `allow-gui-during-cooldown: true` to allow GUI opening during cooldowns, with worlds on cooldown appearing disabled rather than blocking GUI access entirely. - **Visible cooldown indicators** – Options on cooldown are now shown in the GUI with clear cooldown timers in the item lore, making remaining wait times immediately visible to players. - **Human-readable cooldown messages** – Display cooldowns in readable format like "1h 30m 45s" instead of raw seconds using ``, ``, and `` placeholders in messages. - **Admin-only cache visibility** – Control biome cache information display with `admin-only-cache-info: false` to show cache stats to all players by default, and `disable-cache-filtering: true` to globally disable cache-based biome filtering by default. - **Multi-language support** – Language-specific message files with automatic fallback to English, supporting MiniMessage and legacy color codes. - **PlaceholderAPI integration** – Use dynamic placeholders like `%player_name%` in GUI item names and lore for personalized teleport menus. - **Rare biome optimization** – Intelligent search strategies prioritize rare biome hotspots while maintaining randomness, with configurable weighted search algorithms. - **ForceRTP with PlaceholderAPI** – Use `/rtp forcertp ` to force random teleportation on specific players. Supports PlaceholderAPI placeholders like `%player_name%` for command block automation and custom portal integration. Bypasses cooldowns and limits for administrative control. ## 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` (or create language-specific files like `messages/en.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) | | `/rtp forcertp ` | Force random teleportation for a specified player. Supports PlaceholderAPI placeholders like `%player_name%`. Bypasses cooldowns and limits. | `ezrtp.forcertp` (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 # Rare biome optimization for improved search efficiency # When enabled, uses intelligent strategies to prioritize rare biome hotspots rare-biome-optimization: # Toggle rare biome optimization on/off enabled: true # Custom list of biomes considered "rare" (leave empty for built-in list) rare-biomes: [] # Enable weighted search that favors hotspots for rare biomes use-weighted-search: true # Track and maintain hotspots for rare biomes enable-hotspot-tracking: true 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: # Allow opening the GUI even if the current world has an active cooldown # When true, GUI opens but worlds with active cooldowns are disabled in the GUI # When false, GUI won't open if any world has an active cooldown (current behavior) allow-gui-during-cooldown: true 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: # Disable daily limit for this world (overrides daily-limit and weekly-limit) disable-daily-limit: false 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: disable-daily-limit: false 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 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." # Only show cache info (biome counts) to players with ezrtp.admin permission admin-only-cache-info: false # Disable cache filtering entirely (show all biomes regardless of cache status) disable-cache-filtering: true # Supports PlaceholderAPI placeholders in item names and lore (e.g., %player_name%) 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)

EzRTP

Compatibility

Minecraft: Java Edition

Platforms

Links

Creators

Details