Vaeli RTP

VaeliRTP is a lightweight and highly configurable random teleportation plugin for Minecraft servers. It provides several teleportation modes, intelligent safe-location detection, customizable cooldowns and delays, and extensive configuration options.

Designed for performance, stability, and compatibility, VaeliRTP offers a convenient RTP system without unnecessary server load.

Features

• Multiple teleportation modes — random teleportation, long-distance teleportation, and teleportation near a random player.
• Asynchronous location search — safe destination searching with asynchronous chunk loading.
• Advanced safety checks — checks for dangerous blocks, liquids, available space, and safe landing conditions.
• Flexible search shapes — choose between square and circular teleportation areas.
• Surface and underground teleportation — configure whether players can teleport only to the surface or also into caves.
• Teleport countdown — configurable countdown with automatic cancellation when a player moves, changes worlds, or disconnects.
• Individual cooldowns and delays — separate settings for each teleportation mode.
• Player-based teleportation — configurable target selection with support for vanished/invisible player filtering, world restrictions, and minimum online player requirements.
• World management — automatically select a world, specify a particular destination world, or enable automatic loading and creation of missing worlds.
• Customizable sounds — configure teleportation and countdown sounds using version-independent string keys.
• Advanced color support — supports HEX colors and the legacy &x&R&R&G&G&B&B format.
• Automatic configuration migration — migrates older configuration files to the current format.
• Multilingual support — English and Russian translations with automatic fallback to English for missing translation keys.

Commands

| Command | Description |

| /rtp | Random teleportation | | /rtp default | Standard random teleportation | | /rtp long | Long-distance teleportation | | /rtp player | Teleport near a random player | | /rtp help | Display available commands | | /rtp reload | Reload the plugin configuration |

Aliases: /vaelirtp, /rtpcmd

Permissions

| Permission | Description | Default |

| rtp.use | Use basic RTP commands | Everyone | | rtp.long | Use long-distance RTP | OP | | rtp.player | Use player-based RTP | OP | | rtp.bypass.delay | Bypass teleportation delays | OP | | rtp.bypass.cooldown | Bypass teleportation cooldowns | OP | | rtp.reload | Reload the plugin configuration | OP |

Configuration

The plugin provides flexible configuration through YAML files.

• settings — language, world selection, destination world, and spawn settings.
• teleport — search attempts, search shape, liquids, air space, and surface restrictions.
• sounds — teleportation and countdown sounds.
• default — standard teleportation settings, radius, delay, and cooldown.
• long — long-distance teleportation settings.
• player — player-based teleportation settings and target selection.
• unsafe-blocks — list of blocks that cannot be used as teleportation destinations.

Languages

Supported languages:

• English (en) - default.
• Russian (ru).

Translation files are located in:

plugins/VaeliRTP/lang/

Missing translation keys automatically fall back to English.

Compatibility

• Minecraft: 1.16.5 – 1.26.x
• Platforms: Paper
• Java: 8+