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 <currentworld>.

/rtp <world> | Teleports the player in the chosen world. Requires toastrtp.world and toastrtp.world.<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 <world>.

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

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

toastrtp.use.<world> | 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.<group> | Applies a rank cooldown.

toastrtp.group.<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!