ToastRTP

Modern async RTP for Paper.

Paper | 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

1. Run a Paper server
2. Drop ToastRTP.jar into your plugins folder
3. Start the server
4. Edit the config if needed
5. 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!