MightyRTP

# 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 (https://github.com/pop4959/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 `` 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 ` - Teleport another player (requires permission) - `/rtp ` - 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 `** - Description: Teleport another player - Permission: `mightyrtp.rtp.other` - Usage: `/rtp <player>` **`/rtp `** - 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