ToastRTP

Modern async RTP for Paper.

Paper 1.21.11 | Java 21 | MiniMessage | Queue | Rank Cooldowns

What is ToastRTP?

ToastRTP is a modern, async-first random teleport plugin built for Paper servers that want fast performance, safe teleport logic, and a polished player experience.

It supports random teleports with world-specific settings, queue-based pre-generated locations, rank cooldowns, titles, sounds, MiniMessage formatting, optional economy support, and optional protection hooks for claim plugins.

Preview

Highlights

• Async-first RTP searching built for modern Paper
• Safe teleport checks with configurable blacklist blocks
• Queue of pre-generated safe RTP destinations
• Rank-based cooldown permissions
• World-specific settings and cooldown options
• MiniMessage support for all player-facing messages
• Countdown titles and configurable sounds
• First join RTP and death RTP support
• Optional Vault economy support
• Optional GriefPrevention, WorldGuard, and Towny integrations

Features

• World Control: Set different radius, center, shape, Y-levels, cooldowns, prices, and biome filters per world
• Queue System: Pre-generate safe RTP locations in the background for faster teleports
• Cooldown System: Use global cooldowns, per-world cooldowns, rank cooldowns, and reset cooldowns on death if wanted
• Delay System: Add a teleport delay with movement cancellation, countdown titles, and custom sounds
• Safe Teleport Logic: Avoid unsafe blocks, liquids, bad spawn spaces, and invalid terrain
• Claim Support: Block teleports into protected claims or regions when supported plugins are installed
• MiniMessage Messages: Fully customizable messages, titles, and placeholders
• First Join / Death RTP: Automatically RTP players on first join or after death
• World Border Support: Respect vanilla world borders or use custom RTP ranges
• Permission Group Overrides: Apply special settings to players with specific permissions

Commands

/rtp | Teleports the player in their current world. Requires toastrtp.use and toastrtp.world .

/rtp | Teleports the player in the chosen world. Requires toastrtp.world and toastrtp.world..

/rtp reload | Reloads the plugin. Requires toastrtp.reload.

/rtp info | Shows plugin info. Intended for admins.

/rtp bypass | Toggles bypass mode. Requires toastrtp.admin.

/rtp queue status | Shows queue info. Requires toastrtp.admin.

Permissions

toastrtp.use | Allows /rtp in the player’s current world.

toastrtp.world | Allows /rtp .

toastrtp.world. | Allows RTP in a specific world.

toastrtp.world.* | Allows RTP in all worlds.

toastrtp.use. | Legacy-compatible alias for specific world access.

toastrtp.reload | Allows reload.

toastrtp.bypass.cooldown | Bypasses cooldowns.

toastrtp.bypass.delay | Bypasses delay.

toastrtp.bypass.price | Bypasses cost.

toastrtp.bypass.unsafe | Bypasses safety restrictions.

toastrtp.firstjoin.exempt | Skips first join RTP.

toastrtp.cooldown. | Applies a rank cooldown.

toastrtp.group. | Applies a configured group override.

toastrtp.admin | Full admin access.

Examples

To use /rtp in world: toastrtp.use + toastrtp.world.world
To use /rtp world_nether: toastrtp.world + toastrtp.world.world_nether

Integrations

Vault - Optional economy pricing
GriefPrevention - Optional claim checking
WorldGuard - Optional region checking
Towny - Optional town claim checking

If one of these plugins is not installed, ToastRTP will simply disable that hook and continue running normally.

Configuration Notes

Biomes: [] means all biomes are allowed
PreloadRadius controls how many chunks are preloaded around the destination
RespectRankCooldowns lets rank cooldowns override a custom world cooldown
Sounds support both formats: ENTITY_ENDERMAN_TELEPORT and entity.enderman.teleport
MiniMessage is supported in messages and title settings

Installation

Run a Paper 1.21.11 server
Drop ToastRTP.jar into your plugins folder
Start the server
Edit the config if needed
Use /rtp reload after making changes
Why ToastRTP?

Built specifically for modern Paper
Designed with async safety in mind
Fast queue-based RTP generation
Clean and readable config
Flexible cooldown and world behavior
Polished messages, sounds, and title feedback

Inspired by BetterRTP!