EzRTP

Advanced Random Teleport Plugin

Production-ready random teleport plugin for modern Minecraft servers

Latest release: See the GitHub project for the current release and up-to-date documentation: github.com/ez-plugins/EzRTP
Java 17+, Bukkit API baseline 1.13+, actively packaged for Bukkit/Paper/Spigot/Purpur.

📥 Modrinth • 📥 SpigotMC • 📥 Hangar • 📕 GitHub (latest releases & docs) • 💬 Discord Support • 🐛 Report Issues

✨ Key Features

🚀 Performance · 🛡️ Safety · 🎨 Customization · 💰 Economy · 🌐 Multi-World
Lightning-fast RTP with intelligent caching · World-border aware with biome filtering · MiniMessage chat output · Vault integration · Permission-gated GUI selector

🎯 Core Capabilities

• 🏠 Safe Random Teleportation: Finds solid ground within world borders, avoids unsafe blocks, reports coordinates with rich formatting
• 🌍 Multi-World Support: Curated destinations for overworld, nether, end, resource worlds with GUI selection
• 🏞️ Advanced Biome Selection: Target specific biomes or exclude unwanted areas for tailored exploration
• 👥 Join Protection: Automatic teleportation on join with configurable delays and bypass permissions
• 💰 Economy Integration: Charge for teleports with Vault, refund on failures, localized messaging
• ⚡ Performance Queue: Throttle usage with configurable queues and bypass permissions
• 📊 Comprehensive Analytics: RTP statistics, biome metrics, heatmap visualization, and performance monitoring

🛠️ Technical Excellence

• 🔧 Plugin Compatibility: Paper, Purpur, SpigotMC 1.19+
• ☕ Java Requirements: Java 17 or newer
• 💾 Storage Options: YAML or MySQL for usage limits and statistics
• 🌐 Network Ready: BungeeCord/Velocity support for multi-server networks
• 🔒 Security: Protection plugin integration (WorldGuard, GriefPrevention)
• 📈 Metrics: bStats integration for anonymous usage statistics

🚀 Quick Start Guide

Prerequisites: Bukkit/Paper/Spigot/Purpur, Java 17+

Installation Steps

1. Download EzRTP.jar from Modrinth, SpigotMC, Hangar or the project's GitHub Releases (github.com/ez-plugins/EzRTP/releases)
2. Install by dropping into your plugins/ directory
3. Restart your server to generate configuration files
4. Configure config.yml with your world settings, teleport parameters, and preferences
5. Customize messages in messages/{language}.yml (for example messages/en.yml) using MiniMessage formatting
6. Enable GUI in gui.yml for visual world selection
7. Test with /rtp command

Expansions / Modules

EzRTP ships as a core runtime plus optional platform modules and integrations. For production servers:

Platform modules and other expansion jars (GUI/analytics helpers) are available from the project's GitHub Releases and the platform package pages listed above. See the module installation notes on GitHub: github.com/ez-plugins/EzRTP/blob/main/docs/over…

Basic Configuration

Essential settings in config.yml

world: world
center:
x: 0
z: 0
radius:
min: 256
max: 2048
use-world-border: true
max-attempts: 32
cost: 0.0 # Free teleports

Commands & Permissions

Command · Description · Permission · Default
/rtp · Random teleport to safe location · ezrtp.use · ✅ All players
/rtp reload · Reload configuration · ezrtp.reload · ❌ Operators only
/rtp stats · View RTP performance metrics · ezrtp.stats · ❌ Operators only
/rtp stats biomes · Detailed biome statistics · ezrtp.stats · ❌ Operators only
/rtp heatmap [size] [world] · Generate RTP distribution map · ezrtp.heatmap · ❌ Operators only
/forcertp [world] · Admin teleport override · ezrtp.forcertp · ❌ Operators only
/rtp fake · Simulate teleports for testing · ezrtp.heatmap.fake · ❌ Operators only

Additional Permissions:

• ezrtp.queue.bypass - Skip teleport queues
• ezrtp.bypass.cooldown - Ignore cooldowns
• ezrtp.bypass.limit - Unlimited daily/weekly usage
• ezrtp.gui.* - Access specific GUI world options

Permissions Reference:

• ezrtp.use: Execute /rtp (default: all players)
• ezrtp.reload: Reload configuration (default: ops)
• ezrtp.stats: View RTP statistics and metrics (default: ops)
• ezrtp.heatmap: Generate heatmaps (default: ops)
• ezrtp.forcertp: Force RTP for a player (default: ops)
• ezrtp.heatmap.fake: Simulate teleports for testing (default: ops)
• ezrtp.queue.bypass: Bypass teleport queue (default: false)
• ezrtp.bypass.cooldown: Bypass cooldowns (default: false)
• ezrtp.bypass.limit: Bypass daily/weekly limits (default: false)
• ezrtp.gui.*: Per-option GUI access (use gui.yml to configure)
• ezrtp.admin: Administrative UI/cache visibility and advanced actions (default: ops)

Tip: Add bypass nodes to the rtp-limits.bypass-permissions list in config.yml to grant global bypass behavior.

🎮 Feature Showcase

📊 Advanced Analytics & Monitoring

Biome Statistics Dashboard

View comprehensive biome-specific metrics with /rtp stats biomes

Heatmap Visualization

Generate professional RTP distribution maps with configurable grid sizes

Professional yellow-to-red gradient • Auto-scaling • Configurable resolution (16-4096 blocks)

Usage Examples:
/rtp stats # Overall performance metrics
/rtp stats biomes # Per-biome success rates & timing
/rtp heatmap 64 world # Generate 64-block grid heatmap
/rtp fake 1000 # Simulate 1000 teleports for testing

🎨 Interactive GUI System

World & Biome Selector

Permission-gated inventory interface with custom icons and real-time status

Custom icons • Permission controls • Real-time cooldown display

Configuration:
gui:
enabled: true
title: "Random Teleport"
worlds:
overworld:
slot: 11
permission: ""
icon:
material: GRASS_BLOCK
name: "🌍 Overworld"

🛡️ Safety & Performance Features

Smart Location Validation

• Block Safety: Configurable unsafe block filtering
• Chunk Management: Automatic loading/unloading with memory optimization
• Biome Awareness: Include/exclude specific biomes
• World Border: Respects configured borders automatically

Intelligent Caching System

• Biome Pre-caching: Cache safe locations per biome for instant teleports
• Rare Biome Optimization: Weighted algorithms for efficient rare biome targeting
• Hotspot Tracking: Maintains performance data for optimal search patterns

💰 Economy Integration

Vault-Compatible Pricing

• Flexible Costs: Per-world, per-group pricing with overrides
• Refund System: Automatic refunds on teleport failures
• Localized Messages: Multi-language support for economy feedback

🌐 Network & Multi-World Support

BungeeCord/Velocity Integration

• Server Transfers: GUI options for cross-server teleports
• Status Monitoring: Real-time ping and player count display
• Permission Controls: Granular access control per server

⚙️ Advanced Configuration

📁 Configuration Files Overview

EzRTP uses multiple configuration files for comprehensive customization:

• config.yml - Core teleport settings, safety, performance, and economy
• messages/{language}.yml - MiniMessage formatted chat messages and localization
• gui.yml - Interactive world/biome selector GUI configuration
• queue.yml - Teleport queue management and throttling
• network.yml - BungeeCord/Velocity multi-server integration
• force-rtp.yml - Admin override settings

🔧 Core Configuration (config.yml)

📋 Complete config.yml Example

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 (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

Target world for RTP

world: world

Center coordinates for RTP search area

center:
x: 0
z: 0

Teleport radius bounds

radius:
min: 256

max: 2048

use-world-border: true

Maximum attempts to find a safe location

max-attempts: 32

Cost per teleport (0 = free)

cost: 0.0

Optional countdown before teleport (0 = disabled)

countdown-seconds: 0

Countdown configuration with bossbar and particles

countdown:
bossbar:
enabled: false
title: "Teleporting in seconds..."
color: YELLOW
style: SOLID
particles:
enabled: true
type: ENCHANTMENT_TABLE
points: 12
radius: 1.2
height-offset: 0.8
extra: 0.0
force: false
secondary-particle: PORTAL
secondary-count: 6
secondary-offset: 0.35

Blocks to avoid during location validation

unsafe-blocks:

• WATER
• LAVA
• MAGMA_BLOCK
• POWDER_SNOW
• FIRE
• CAMPFIRE
• SOUL_FIRE

Biome filtering and optimization

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

pre-cache:
enabled: true
max-per-biome: 50
warmup-size: 20
expiration-minutes: 10

Rare biome optimization

rare-biome-optimization:
enabled: true
rare-biomes: []
use-weighted-search: true
enable-hotspot-tracking: true

Protection plugin integration

protection:
avoid-claims: false
providers:

• worldguard
• griefprevention

Landing particle effects

particles:
enabled: false
type: PORTAL
count: 40
offset:
x: 0.5
y: 1.0
z: 0.5
extra: 0.0
force: false

Join teleportation settings

on-join:
enabled: false
only-first-join: false
bypass-permission: ""
delay-ticks: 40

RTP cooldowns and usage limits

rtp-limits:
allow-gui-during-cooldown: true
default:
cooldown-seconds: 300 # Cooldown between uses
daily-limit: 10 # Max uses per day
weekly-limit: 50 # Max uses per week
cost: 0.0 # Cost override
worlds:
world:
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
bypass-permissions:

• ezrtp.bypass.cooldown
• ezrtp.bypass.limit

storage: yaml # or mysql
mysql:
url: jdbc:mysql://localhost:3306/mc
user: root
password: ""

💬 Message Configuration (messages/{language}.yml)

📋 Complete messages/{language}.yml Example

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: "..."

🎨 GUI Configuration (gui.yml)

📋 Complete gui.yml Example

##