MightyRTP

WARNING: Be careful using this plugin in problematic worlds like CaveBlock or cave-generated worlds, as they can cause server crashes. It is strongly recommended to blacklist these worlds in the configuration.

TIP: For smoother teleportation, consider preloading chunks within your configured teleport distance using Chunky or similar chunk preloading tools.

Features

• Smart Surface Detection: Automatically discovers safe, random locations using intelligent terrain scanning instead of arbitrary Y levels

• Advanced Safety System: Comprehensive safety checks with configurable strictness levels (1-5 scale)

• Performance Optimized: Asynchronous teleport searching prevents server lag and TPS drops

• World Management: Flexible world restrictions and blacklisting

• Cooldown System: Configurable usage limits with bypass permissions

• Rich Messaging: Customizable titles, subtitles, and chat messages with MiniMessage support

• Easy Configuration: Extensive configuration options for all aspects of the plugin

• Player Management: Teleport other players with proper permission checks

• User Experience: Smart tab completion and intuitive command structure

• Stable Performance: No more server crashes from chunk loading operations

• Update Checker: Automatic update notifications with manual check command

• Config Migration: Automatic config migration preserves your settings when updating

• Custom RTP Centers: Set custom center points per world for RTP radius calculations

• Custom Teleport Spots: Pre-set teleport locations for controlled RTP destinations

• Multiverse-CommandDestination compatible: Use as a portal destination (cmd:mightyrtp) for RTP from Multiverse portals; console command and [world] support included.

Quick Start

Installation

1. Download the latest JAR file from releases

2. Place it in your server's plugins folder

3. Restart your server

4. Configure the plugin using the generated config files

Basic Usage

• /rtp - Teleport to a random safe location

• /rtp [player] - Teleport another player (requires permission)

• /rtp [player] [world] - Teleport another player to specified world (requires permission)

• /rtp-reload - Reload plugin configuration (requires permission)

• /rtp-update - Check for plugin updates (requires permission)

• /rtp-center - Set RTP center point for current world (requires permission)

• /rtp-set - Add custom teleport spot at your location (requires permission, only works when teleport-distance: CUSTOM)

Commands

/rtp

• Description: Teleport to random safe location

• Permission: mightyrtp.rtp

• Usage: /rtp

/rtp [player]

• Description: Teleport another player

• Permission: mightyrtp.rtp.other

• Usage: /rtp <player>

/rtp [player] [world]

• Description: Teleport another player or yourself to specified world

• Permission: mightyrtp.rtp.other + mightyrtp.rtp.world

• Usage: /rtp <player> <world>

/rtp-reload

• Description: Reload configuration

• Permission: mightyrtp.reload

• Usage: /rtp-reload

/rtp-update

• Description: Check for plugin updates

• Permission: mightyrtp.update

• Usage: /rtp-update

/rtp-center

• Description: Set the RTP center point for the current world (defaults to 0,0)

• Permission: mightyrtp.admin

• Usage: /rtp-center (stand where you want the center to be)

/rtp-set

• Description: Add a custom teleport spot at your current location (only works when teleport-distance: CUSTOM in config)

• Permission: mightyrtp.admin

• Usage: /rtp-set (stand where you want the teleport spot to be)

Permissions

mightyrtp.rtp

• Description: Allows players to use /rtp command

• Default: true

mightyrtp.rtp.other

• Description: Allows players to use /rtp command on other players

• Default: op

mightyrtp.rtp.world

• Description: Allows players to use /rtp command with world specification

• Default: op

mightyrtp.bypass

• Description: Allows players to bypass the cooldown limit

• Default: op

mightyrtp.reload

• Description: Allows players to reload the plugin configuration

• Default: op

mightyrtp.update

• Description: Allows players to check for plugin updates

• Default: op

mightyrtp.admin

• Description: Allows players to set RTP center points and custom teleport spots

• Default: op

Advanced Features

Custom RTP Centers

Set custom center points for RTP radius calculations per world:

1. Stand at the desired center location
2. Run /rtp-center
3. All RTP teleports in that world will use this location as the center point
4. Centers are stored in centers.yml and persist across restarts

Custom Teleport Spots

Use pre-set teleport locations instead of random generation:

1. Set teleport-distance: CUSTOM in config.yml
2. Stand at desired teleport locations and run /rtp-set for each spot
3. Players using /rtp will be teleported to random spots from your list
4. Spots are stored in spots.yml per world
5. Switch back to normal mode by setting teleport-distance to a number (e.g., 5000) and reloading

Note: You must set spots for each world separately. Remember to reload config after changing modes.

Troubleshooting

Common Issues

Plugin fails to find safe locations:

• Increase max-attempts in config

• Verify world generation is working properly

• Consider adjusting safety.strictness (lower = more strict, higher = more lenient)

Server lag during teleportation:

• Ensure async-teleport-search: true is enabled

• Reduce max-attempts if needed

• Check server performance settings

Chunk loading errors:

• Verify server has sufficient RAM

• Check if world generation is enabled

• Ensure proper server permissions

Performance Tips

• Normal worlds: Default settings work well

• Complex terrain: Increase max-attempts to 75-100

• Cave worlds: Set safety.strictness to 4-5 for more lenient placement, BUT HIGHLY RECOMMENDED TO BLOCK THESE WORLDS.

• High-traffic servers: Keep max-attempts moderate (50-75) to balance success rate and performance

Support

If you need help or have suggestions, please open an issue on the GitHub repository or join the linked Discord and navigate to # plugin-help

---