## \ud83c\udf0d RandomTeleport \u2014 Wild Teleport, Reinvented
\n**The most configurable RTP plugin for Paper \u2014 per-world cooldowns, daily use limits, interactive GUI, LuckPerms integration, and zero bloat.**<\/p>\n
—<\/p>\n
### \u2726 What is RandomTeleport?
\nRandomTeleport lets your players explore the world with a single command. Open an interactive world selector menu, pick your destination, and get teleported to a safe random location \u2014 with sounds, particles, and a countdown to keep things smooth.<\/p>\n
Built from the ground up for **Paper 1.21+**, it’s designed to be clean, performant, and fully customizable without a single unnecessary line.<\/p>\n
—<\/p>\n
### \u2726 Why RandomTeleport?
\nUnlike bloated alternatives, RandomTeleport focuses on **what matters**:
\n– **Zero hard dependencies** \u2014 Vault and LuckPerms are optional, plugin works standalone
\n– **Paper-native performance** \u2014 Built specifically for Paper’s async APIs
\n– **One config file** \u2014 Everything in config.yml, no mess
\n– **Real-time status display** \u2014 Players see cooldowns AND daily uses directly in the GUI
\n– **True LuckPerms integration** \u2014 Native API support with group inheritance resolution<\/p>\n
—<\/p>\n
### \u2726 Features<\/p>\n
#### \ud83c\udfaf Core Gameplay
\n– **Interactive GUI** \u2014 Beautiful inventory menu with world selection. Disabled worlds are hidden from regular players but visible to admins.
\n– **Daily use limits** \u2014 Limit RTP uses per world per day, with per-group overrides via LuckPerms. Resets at midnight automatically.
\n– **Per-world cooldowns** \u2014 Each world has its own cooldown configuration with group-based overrides (LuckPerms native support).
\n– **Real-time GUI feedback** \u2014 Each world button shows cooldown status AND daily use count in the item lore.
\n– **Custom player-head icons** \u2014 Display player skulls for each world instead of blocks using Paper’s native PlayerProfile API.<\/p>\n
#### \ud83d\udd12 Safety & Performance
\n– **Smart location finder** \u2014 Async multi-threaded search with configurable block blacklist, liquid avoidance, void protection, and chunk pre-loading.
\n– **Countdown system** \u2014 Configurable countdown before teleportation, cancellable on move, damage, or command.
\n– **Blindness effect** \u2014 Optional blindness during countdown and post-teleport for immersive transitions.<\/p>\n
#### \ud83d\udcb0 Economy & Permissions #### \u2699\ufe0f Admin Tools #### \ud83c\udfa8 Customization —<\/p>\n ### \u2726 Commands<\/p>\n | Command | Description | —<\/p>\n ### \u2726 Permissions<\/p>\n | Permission | Description | —<\/p>\n ### \u2726 Compatibility<\/p>\n | | | > \u26a0\ufe0f **Spigot is not supported.** This plugin uses Paper-exclusive APIs.<\/p>\n —<\/p>\n ### \u2726 Configuration **Example world configuration:** —<\/p>\n ### \u2726 Quick Start<\/p>\n 1. **Install** \u2014 Drop `RandomTeleport.jar` into your `plugins\/` folder **Optional:** Install Vault for economy integration and LuckPerms for advanced group-based permissions.<\/p>\n —<\/p>\n *Made with love by **valival_***<\/p>\n","protected":false},"excerpt":{"rendered":" The most configurable RTP plugin for Paper<\/p>\n","protected":false},"featured_media":143715,"template":"","meta":{"_minecraft_slug":"smart-rtp","_minecraft_project_id":"z5rEMVkF","_minecraft_author":"Valival","_minecraft_license":"MIT","_minecraft_downloads":59,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"smart-rtp.zip","_minecraft_size_bytes":98017,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T20:48:59.124317Z","_minecraft_date_created":"2026-02-21T00:15:07.154395Z","_minecraft_date_modified":"2026-02-21T18:39:07.723435Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/smart-rtp","_minecraft_icon_attachment_id":143715,"_minecraft_imported_at":"2026-06-08T13:52:00+00:00","_minecraft_import_hash":"9730e388d976ebdd62b6b7ec1f50a382","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[844,89,126,127,123,92],"mod_loader":[132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-143714","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-economy","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-technology","mod_category-utility","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– **Economy support** \u2014 Optional Vault integration with per-group pricing and automatic refund on teleport failure.
\n– **LuckPerms-ready** \u2014 Native LuckPerms API integration with primary group \u2192 inherited groups \u2192 permission fallback resolution.
\n– **Fine-grained permissions** \u2014 Per-world access (`rtp.world.
\n– **Hot reload** \u2014 `\/rtpadmin reload` reloads configuration without server restart.
\n– **Usage management** \u2014 Reset daily counters, clear cooldowns, toggle bypasses.
\n– **Structured logging** \u2014 Every teleport, failed attempt, economy transaction, and admin action is logged by category.
\n– **Hidden tab-completion** \u2014 `\/rtpadmin` is completely invisible to non-admin players.<\/p>\n
\n– **Effects system** \u2014 Custom sounds and particles on departure and landing. Title + action bar support.
\n– **Flexible configuration** \u2014 World icons, GUI layout, filler items, cooldown groups, economy amounts, log categories, and async performance settings.<\/p>\n
\n|—|—|
\n| `\/rtp` | Open the world selector GUI |
\n| `\/rtp [world]` | Teleport directly to a world |
\n| `\/rtp [player] [world]` | Teleport another player (admin) |
\n| `\/rtpadmin reload` | Reload the configuration |
\n| `\/rtpadmin cooldown
\n| `\/rtpadmin uses reset
\n| `\/rtpadmin bypass
\n| `\/rtpadmin stats [player]` | View teleport statistics |<\/p>\n
\n|—|—|
\n| `rtp.use` | Access to `\/rtp` command |
\n| `rtp.world.
\n| `rtp.bypass.cooldown` | Bypass all cooldowns |
\n| `rtp.bypass.cooldown.
\n| `rtp.bypass.uses` | Bypass daily use limits |
\n| `rtp.bypass.economy` | Bypass economy costs |
\n| `rtp.others` | Teleport other players |
\n| `rtp.admin` | Access to all admin commands |<\/p>\n
\n|—|—|
\n| **Server software** | Paper only |
\n| **Minecraft versions** | 1.21.0 \u2014 1.21.4+ (all 1.21.x) |
\n| **Java** | 21+ |
\n| **Optional dependencies** | Vault (economy), LuckPerms (permission groups) |<\/p>\n
\nEverything is configurable from a single `config.yml` \u2014 world icons (including custom player heads), GUI layout, filler items, sounds, particles, cooldown groups, daily use limits, economy amounts, log categories, async performance settings, and more. No secondary files, no clutter.<\/p>\n
\n“`yaml
\nworlds:
\n world:
\n enabled: true
\n icon: PLAYER_HEAD
\n head-uuid: “ddb0f735-90ac-44e2-8578-a7dd5a1abfc5”
\n display-name: “&a&lOverworld”
\n cooldown:
\n default-seconds: 300
\n groups:
\n admin: 0
\n vip: 120
\n default: 300
\n uses:
\n default-uses: 5
\n groups:
\n admin: 0
\n vip: 10
\n default: 5
\n“`<\/p>\n
\n2. **Restart** \u2014 Start your Paper server (1.21+)
\n3. **Configure** \u2014 Edit `plugins\/RandomTeleport\/config.yml` to your liking
\n4. **Reload** \u2014 Use `\/rtpadmin reload` to apply changes without restart
\n5. **Test** \u2014 Run `\/rtp` and explore!<\/p>\n