JustRTP

A random teleport plugin for Paper, Folia, and proxy networks. It drops players at a safe spot, handles the cooldowns, costs, and warmups around it, and adds an arena style zone system, an admin dashboard, and full cross server support on top. The goal is to stay fast and stable on busy servers and across a network.

Runs on Minecraft 1.21.11 up to 26.2, on Paper, Folia, and Folia forks like CanvasMC.

How it works

A safe /rtp looks for a spot that is not lava, not inside a wall, and not in a biome or block you have blacklisted, then teleports the player there. It handles the Overworld, Nether, and End, plus a VOID type for skyblock and void worlds. A background location cache keeps ready spots on hand, so a normal /rtp lands close to instant instead of searching live every time.

Everything is set per world: radius, center, cooldown, warmup, cost, which worlds are allowed, and the biomes or blocks to avoid. Permission groups can override the radius, cost, cooldown, and delay for ranks like VIP, by priority.

Ways to teleport

• /rtp to a random safe spot in the current or default world
• /rtp <world> for a specific world with its own radius, cost, and rules
• /rtp <world> <min> <max> for a custom radius, with optional radius based pricing tiers
• /rtp <player> to teleport someone else
• /rtp nearplayer to land near a random online player
• /rtp nearclaim to land near a claimed base (SimpleClaim, GriefPrevention, Lands, WorldGuard), and the subcommand name is renameable
• /rtp location <id> for named locations, each with its own permission, cost, and radius
• /rtp gui for a clickable world picker with live cooldowns and costs
• /rtp spectator for a circular floating head world switcher, handy for staff
• Matchmaking queue that pairs players for 1v1, 2v2, or team RTP with /rtp queue
• Jump RTP to teleport by double jumping, per world, with its own cooldown

Automatic teleports

• First join RTP for new players
• Respawn RTP after death
• Spawn world redirect to push players out of a hub on join
• RTP Zones: 3D regions that teleport everyone inside on a timer, with live countdown holograms, group spread, and a per player opt out

Network and cross server

• Cross server RTP over MySQL for Velocity and BungeeCord, with instant arrival and no second warmup
• Optional Redis for shared cooldowns, caches, and live messaging across the network
• RTP Zone sync so the same zones stay in step across multiple servers

Visuals and feedback

• Titles, action bar, boss bar, and chat messages, all in MiniMessage with gradients and color
• A delay countdown with an action bar timer and a sound that rises in pitch, and moving cancels the teleport
• Particle animations while warming up and on arrival
• Zone countdown holograms through FancyHolograms, AxoHologram, PacketEvents, or vanilla Display Entities, picked automatically

Economy and permissions

• Vault costs per world, per group, or by radius tier, with a confirmation step for paid teleports and an automatic refund if the teleport fails
• Permission groups with priority based per world cooldown, delay, cost, and radius
• Bypass permissions for cooldown, warmup, cost, and Jump RTP

Admin and technical

• /rtp dashboard, an in game panel to enable, disable, and tune every module live, written back into config.yml in place so your comments stay
• Built in update checker with console and in game notices for admins
• Addon system to load extra behavior from plugins/JustRTP/addons
• PlaceholderAPI placeholders for cooldown, cost, and delay, usable in scoreboards and other plugins
• Folia, Canvas, and Paper detected automatically, with all chunk and entity work kept on the correct region threads
• Location cache and an async teleport queue to keep things smooth under load

Commands

Command	What it does
/rtp	Random safe teleport
/rtp <world>	Teleport in a specific world
/rtp <world> <min> <max>	Teleport with a custom radius
/rtp <server>:<world>	Cross server teleport (needs MySQL)
/rtp <player>	Teleport another player
/rtp nearplayer	Teleport near a random online player
/rtp nearclaim	Teleport near a claimed area
/rtp location <id>	Teleport to a named location
/rtp gui	Open the world picker
/rtp spectator	Open the spectator switcher
/rtp queue join	Join the matchmaking queue
/rtp dashboard	Open the admin panel
/rtpzone setup <id>	Create and manage an RTP zone
/rtp reload	Reload the configuration

The full command and permission list is in the docs.

Compatibility

• Java 21 or newer
• Paper, Folia, or a Folia fork such as CanvasMC
• Minecraft 1.21.11 through 26.2
• Optional hooks: Vault, PlaceholderAPI, WorldGuard, GriefPrevention, Lands, SimpleClaim, FancyHolograms, AxoHologram, PacketEvents, MySQL, Redis

Setup

1. Put the jar in your plugins folder
2. Start the server once to generate the config files
3. Set your worlds, radius, and cooldowns in config.yml
4. Run /rtp reload

Updating is safe. New options are merged into your existing files, your old configs are backed up first, and your comments and layout stay where you put them.

Visual Description

ignore: rtp, cross server, randomtp, wildtp, redis, mysql, rtpzone