Mods Server

EzRTP

  • 99 views • 1 today
  • 2 downloads • 0 today
  • 1
  • 0
ez-plugins
Level 1 : New System
0
EzRTP - Advanced Random Teleport Plugin
Production-ready random teleport plugin for modern Minecraft servers
Latest release and docs: https://github.com/ez-plugins/EzRTP • Java 17+ • Bukkit/Paper/Spigot/Purpur/Folia support


ModrinthSpigotMCHangarDiscord


Feature Summary
  • Safe RTP with configurable unsafe-block filtering and recovery behavior
  • Biome include/exclude filtering, pre-cache, and rare-biome optimization
  • Search pattern control: random, circle, square, triangle, diamond
  • Per-world/per-group cooldowns, daily/weekly limits, and optional costs
  • GUI destination selector with permission-gated entries
  • Heatmap generation and PNG export
  • Named centers and WorldGuard region command routing
  • Optional Chunky pre-generation support
  • Optional performance and unsafe-location monitoring exports
  • Folia-compatible runtime behavior for modern scheduler environments


Feature Preview

Biome Statistics Dashboard
EzRTP Minecraft Mod

Heatmap Visualization
EzRTP Minecraft Mod

World Selector GUI
EzRTP Minecraft Mod

Commands and Subcommands

Main Commands
CommandDescriptionPermission
/rtpDefault RTP flow (GUI or direct teleport depending on setup)ezrtp.use
/forcertp <player> [​world]Force RTP for a target playerezrtp.forcertp


/rtp Subcommands
SubcommandUsagePermissionNotes
reload/rtp reloadezrtp.reloadReload configuration
stats/rtp statsezrtp.statsOverall RTP metrics
stats biomes/rtp stats biomes [​page]ezrtp.statsBiome activity stats with paging
stats rare-biomes/rtp stats rare-biomesezrtp.statsRare-biome optimization stats
stats performance/rtp stats performanceezrtp.statsPercentile and timing metrics
unsafe-stats/rtp unsafe-statsezrtp.statsUnsafe rejection breakdown
heatmap/rtp heatmap [​biome]ezrtp.heatmapCreates and gives a heatmap map item
heatmap save/rtp heatmap saveezrtp.heatmapExports heatmap PNG to plugin folder
fake/rtp fake <amount|clear> [​world]ezrtp.heatmap.fakeAdd or clear simulated samples
setcenter/rtp setcenter <x> <z> or /rtp setcenter <world> <x> <z>ezrtp.setcenterUpdates center and reloads configuration
addcenter/rtp addcenter <name>ezrtp.setcenterStores named center from player location
pregenerate/rtp pregenerate [​world] [​radius]ezrtp.pregenerateStarts Chunky-assisted warmup tasks


Extra RTP Routing:
  • /rtp <center-name> uses centers.named.<name> from rtp.yml
  • /rtp <region-id> uses WorldGuard region routing when worldguard.region-command.enabled: true


Permissions

Declared in plugin.yml
PermissionDefaultPurpose
ezrtp.usetrueUse /rtp
ezrtp.reloadopUse /rtp reload
ezrtp.statsopUse stats and unsafe-stats
ezrtp.heatmapopUse heatmap commands
ezrtp.heatmap.fakeopUse /rtp fake
ezrtp.queue.bypassopBypass queue
ezrtp.forcertpopUse /forcertp


Used by Runtime or Config
  • ezrtp.setcenter - required for /rtp setcenter and /rtp addcenter
  • ezrtp.pregenerate - required for /rtp pregenerate
  • ezrtp.bypass.cooldown - bypass cooldown checks
  • ezrtp.bypass.limit - bypass daily/weekly limits
  • ezrtp.gui.<name> - per-destination GUI permission nodes from gui.yml


Configuration Files

FileScopeKey Examples
config.ymlCore plugin/global optionsmessage-prefix, language, enable-bstats, worldguard.region-command.*
rtp.ymlRTP behavior/safety/biomessearch-pattern, radius.*, countdown.*, unsafe-blocks, biomes.*, chunky-integration.*
limits.ymlCooldowns, limits, group/world overridesrtp-limits.default, rtp-limits.worlds, allow-gui-during-cooldown
storage.ymlLimits storage backendrtp-limits.storage, rtp-limits.mysql.*
gui.ymlGUI layout and entriesenabled, rows, worlds.*, rare_biomes.*
queue.ymlQueue throttlingenabled, max-size, interval-ticks
network.ymlProxy/server selector entriesenabled, lobby, servers.<name>.*
force-rtp.yml/forcertp behaviordefault-world, bypass.cooldown, bypass.permission, bypass.safety
performance.ymlOptional performance monitoringperformance.monitoring.enabled, warnings.*, percentiles.*
unsafe-location-monitoring.ymlOptional unsafe-location trackingunsafe-location-monitoring.monitoring.enabled, logging.*, metrics.*
messages/en.ymlLocalizable message templatesteleport-*, forcertp-*, heatmap-*, fake-*, stats-*


Selected Current Defaults
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
  • Paper, Purpur, Spigot, or Folia 1.7+
  • Optional: Vault/EzEconomy for pricing
  • Optional: WorldGuard/GriefPrevention for protection-aware behavior
  • Optional: Chunky for pre-generation workflows


Support
Progress100% complete
Game VersionMinecraft 26.1.1
Tags

  Have something to say?

Welcome