EzRTP

Advanced Random Teleport Plugin

Production-ready random teleport plugin for modern Minecraft servers.

Documentation: https://ez-plugins.github.io/EzRTP

Installation guide: https://ez-plugins.github.io/EzRTP/overview-installation.html#installation

• < 3.0.0 build on Java 17 (MC 1.13 - 1.21.11.*) for Bukkit/Paper/Spigot/Purpur/Folia
• >= 3.0.0 build on Java 25 (MC 26.1.*) for Bukkit/Paper/Spigot/Purpur/Folia
• >= 3.1.0 build on Java 17 (MC 1.13 - 1.21.11.*) for Bukkit/Paper/Spigot/Purpur/Folia

Modrinth • SpigotMC • Hangar • Discord

---

Feature Summary

• Safe random teleport with configurable unsafe-block filtering and recovery behavior.
• Biome include/exclude filtering, pre-cache, and rare-biome optimization (weighted search + hotspot tracking).
• Search pattern control: random, circle, square, triangle, diamond.
• Queue controls and cooldown/usage limits per world and per group.
• GUI destination selector with per-destination permissions.
• Heatmap tools (/rtp heatmap, /rtp heatmap save) and simulated samples (/rtp fake).
• Named centers (/rtp addcenter, /rtp <center-name>) and center editing (/rtp setcenter).
• Optional network selector entries via network.yml.
• Optional Chunky pre-generation command (/rtp pregenerate [world] [radius]).
• Optional performance and unsafe-location monitoring exports.
• Folia-compatible runtime behavior for modern server scheduling models.

Feature Preview

Biome Statistics Dashboard

Heatmap Visualization

World Selector GUI

---

Subcommands

Main Commands

Command	Description	Permission
/rtp	Default RTP flow (GUI or direct teleport based on setup)	ezrtp.use
/forcertp <player> [world]	Force RTP for a target player	ezrtp.forcertp

/rtp Subcommands

Subcommand	Usage	Permission	Notes
reload	/rtp reload	ezrtp.reload	Reload configuration
stats	/rtp stats	ezrtp.stats	Overall RTP metrics
stats biomes	/rtp stats biomes [page]	ezrtp.stats	Biome activity + paging
stats rare-biomes	/rtp stats rare-biomes	ezrtp.stats	Rare-biome optimization stats
stats performance	/rtp stats performance	ezrtp.stats	Percentile/timing metrics
unsafe-stats	/rtp unsafe-stats	ezrtp.stats	Unsafe rejection breakdown
heatmap	/rtp heatmap [biome]	ezrtp.heatmap	Gives in-game heatmap map
heatmap save	/rtp heatmap save	ezrtp.heatmap	Saves heatmap PNG to plugin folder
fake	`/rtp fake <amount	clear> [world]`	ezrtp.heatmap.fake
setcenter	/rtp setcenter <x> <z> or /rtp setcenter <world> <x> <z>	ezrtp.setcenter	Updates world center and reloads
addcenter	/rtp addcenter <name>	ezrtp.setcenter	Stores named center at player location
pregenerate	/rtp pregenerate [world] [radius]	ezrtp.pregenerate	Starts Chunky-assisted warmup tasks

Extra RTP Routing

• /rtp <center-name>: teleports using centers.named.<name> from rtp.yml.
• /rtp <region-id>: WorldGuard region-based RTP when worldguard.region-command.enabled: true.

---

Permissions

Declared in plugin.yml

Permission	Default	Purpose
ezrtp.use	true	Use /rtp
ezrtp.reload	op	Use /rtp reload
ezrtp.stats	op	Use stats/unsafe-stats
ezrtp.heatmap	op	Use heatmap generation/export
ezrtp.heatmap.fake	op	Use /rtp fake
ezrtp.queue.bypass	op	Bypass queue
ezrtp.forcertp	op	Use /forcertp

Used by Runtime/Config

Permission	Source	Purpose
ezrtp.setcenter	command code	Access setcenter and addcenter
ezrtp.pregenerate	command code	Access /rtp pregenerate
ezrtp.bypass.cooldown	limits.yml defaults	Cooldown bypass
ezrtp.bypass.limit	limits.yml defaults	Daily/weekly limit bypass
ezrtp.gui.<name>	gui.yml entries	Per-destination GUI access

---

Configuration Files

EzRTP now splits configuration by concern.

File	Scope	Example Keys
config.yml	Core plugin/global options	message-prefix, language, enable-bstats, worldguard.region-command.*
rtp.yml	RTP behavior and safety	search-pattern, radius.*, countdown.*, unsafe-blocks, biomes.*, chunky-integration.*
limits.yml	Cooldowns/usage/cost profiles	rtp-limits.default, rtp-limits.worlds, allow-gui-during-cooldown
storage.yml	Limits storage backend	rtp-limits.storage, rtp-limits.mysql.*
gui.yml	GUI layout and destinations	enabled, rows, worlds.*.icon, disable-cache-filtering, rare_biomes.*
queue.yml	Queue throttling	enabled, max-size, start-delay-ticks, interval-ticks
network.yml	Proxy/server selector	enabled, lobby, servers.<name>.*
force-rtp.yml	/forcertp behavior	default-world, bypass.cooldown, bypass.permission, bypass.safety
performance.yml	Optional perf monitoring	performance.monitoring.enabled, warnings.*, metrics.*, percentiles.*
unsafe-location-monitoring.yml	Optional unsafe tracking	unsafe-location-monitoring.monitoring.enabled, logging.*, metrics.*
messages/en.yml	User-facing text templates	teleport-*, queue-*, forcertp-*, heatmap-*, fake-*, stats-*

Current Core Defaults (selected)

# config.yml
message-prefix: "&7[&bEzRTP&7] &r"
language: en
enable-bstats: true
worldguard:
  region-command:
    enabled: false
    autocomplete: false

# rtp.yml
search-pattern: random
max-attempts: 16
countdown-seconds: 5
heatmap:
  enabled: false
biomes:
  enabled: true
  pre-cache:
    enabled: false
  rare-biome-optimization:
    enabled: false
chunky-integration:
  enabled: false

# limits.yml
rtp-limits:
  default:
    cooldown-seconds: 300
    daily-limit: 10
    weekly-limit: 50
  bypass-permissions:
    - ezrtp.bypass.cooldown
    - ezrtp.bypass.limit
  allow-gui-during-cooldown: true

# storage.yml
rtp-limits:
  storage: yaml # yaml or mysql

---

Requirements

• Java 17 or newer.
• Bukkit, Paper, Purpur, Spigot, or Folia 1.7+.
• Optional: Vault/EzEconomy for pricing.
• Optional: WorldGuard/GriefPrevention for claim-aware behavior.
• Optional: Chunky for pre-generation workflows.

Support

• Discord: https://discord.gg/yWP95XfmBS
• Project and releases: https://github.com/ez-plugins/EzRTP