# RtpQueue Advance
\n## `\u1d21\u029c\u1d07\u0274 \u1d1b\u1d07\ua731\u1d1b\u026a\u0274\u0262 \u1d18\u029f\u1d1c\u0262\u026a\u0274 \ua730\u1d07\u1d00\u1d1b\u1d1c\u0280\u1d07\ua731, \u1d18\u029f\u1d07\u1d00\ua731\u1d07 \u1d05\u1d07-\u1d0f\u1d18 \u028f\u1d0f\u1d1c\u0280\ua731\u1d07\u029f\ua730 \ua730\u026a\u0280\ua731\u1d1b \u1d00\u0274\u1d05 \u1d1b\u029c\u1d07\u0274 \u1d1b\u1d07\ua731\u1d1b \u1d1b\u029c\u1d07 \ua731\u1d07\u0280\u1d20\u1d07\u0280 \u1d00\ua731 \u1d00 \u0274\u1d0f\u0280\u1d0d\u1d00\u029f \u1d18\u029f\u1d00\u028f\u1d07\u0280. \u1d18\u029f\u1d1c\u0262\u026a\u0274 \ua730\u1d07\u1d00\u1d1b\u1d1c\u0280\u1d07\ua731 \u1d05\u1d0f \u0274\u1d0f\u1d1b \u1d21\u1d0f\u0280\u1d0b \u1d04\u1d0f\u0280\u0280\u1d07\u1d04\u1d1b\u029f\u028f \u1d21\u029c\u1d07\u0274 \u1d1b\u029c\u1d07 \u1d18\u029f\u1d00\u028f\u1d07\u0280 \u029c\u1d00\ua731 \u1d0f\u1d18\u1d07\u0280\u1d00\u1d1b\u1d0f\u0280 (\u1d0f\u1d18) \u1d18\u1d07\u0280\u1d0d\u026a\ua731\ua731\u026a\u1d0f\u0274\ua731, \ua731\u1d0f \u1d1b\u1d07\ua731\u1d1b\u026a\u0274\u0262 \u1d00\ua731 \u1d0f\u1d18 \u1d0d\u1d00\u028f \u0262\u026a\u1d20\u1d07 \u026a\u0274\u1d04\u1d0f\u0280\u0280\u1d07\u1d04\u1d1b \u0280\u1d07\ua731\u1d1c\u029f\u1d1b\ua731`.
\n## \u200e
\nA powerful Minecraft plugin for random teleportation with queue-based matchmaking. Players can join a queue and wait for opponents before being teleported together to a random location.<\/p>\n
<\/p>\n
## Features<\/p>\n
– **World Selection GUI** – Beautiful interface to select which world to queue for
\n– **Queue System** – Wait for other players before teleporting together
\n– **Multi-World Support** – Configure multiple worlds with custom settings
\n– **Safe Teleportation** – Finds safe locations avoiding lava, fire, water, and dangerous blocks
\n– **Customizable Messages** – Full control over all plugin messages with color codes
\n– **Action Bar Display** – Persistent action bar showing queue status until player is found
\n– **Title Notifications** – On-screen titles when joining queue and finding opponents
\n– **Broadcast System** – Announce to all players when someone joins the queue
\n– **Bypass Permission** – Allow staff to skip the queue and teleport instantly<\/p>\n
## Commands<\/p>\n
| Command | Aliases | Description | Permission |
\n|———|———|————-|————|
\n| `\/rtpqueue` | `\/rtpq` | Opens the world selection GUI to join a queue | `rtpqueue.use` |
\n| `\/rtpqueueleave` | `\/rtpleave`, `\/leavequeue` | Leave your current queue | `rtpqueue.use` |
\n| `\/rtpqueuereload` | – | Reload the plugin configuration | `rtpqueue.admin` |<\/p>\n
## Permissions<\/p>\n
| Permission | Description | Default |
\n|————|————-|———|
\n| `rtpqueue.use` | Allows players to use the RTP queue system | `true` (all players) |
\n| `rtpqueue.admin` | Allows reloading the plugin configuration | `op` |
\n| `rtpqueue.bypass` | Skip the queue and teleport instantly | `op` |<\/p>\n
## Configuration<\/p>\n
### Queue Settings<\/p>\n
“`yaml
\nqueue:
\n min-players: 2 # Minimum players needed to start teleport
\n countdown-seconds: 3 # Countdown before teleport (3-2-1)
\n teleport-together: true # Teleport all queued players together
\n“`<\/p>\n
### GUI Settings<\/p>\n
“`yaml
\ngui:
\n title: “&6&lRTP Queue &8| &fWorld Selection”
\n size: 27 # Options: 9, 18, 27, 36, 45, 54
\n“`<\/p>\n
### Action Bar Settings<\/p>\n
“`yaml
\nactionbar:
\n enabled: true
\n message: “&7Waiting for a &aplayer &7in &a\/rtpqueue &7(%current%\/%max%)”
\n interval: 20 # Ticks between refresh (20 = 1 second, keeps visible until found)
\n“`<\/p>\n
### Title Settings<\/p>\n
“`yaml
\ntitle:
\n enabled: true
\n join-title: “&a&l+”
\n join-subtitle: “&aJoined &e&lRTPQueue&a!”
\n found-title: “&a&l\u2713”
\n found-subtitle: “&aOpponent found!”
\n fade-in: 10
\n stay: 40
\n fade-out: 10
\n“`<\/p>\n
### Broadcast Settings<\/p>\n
“`yaml
\nbroadcast:
\n enabled: true
\n header: “&a\u2726 &a&lRTPQUEUE &a\u2726”
\n lines:
\n – “&e%player% &7is waiting for”
\n – “&7an opponent to fight!”
\n footer: “&a+ \/rtpqueue +”
\n“`<\/p>\n
### World Configuration<\/p>\n
Each world can be configured individually:<\/p>\n
“`yaml
\nworlds:
\n world:
\n enabled: true
\n display-name: “&a&lOVERWORLD”
\n description: “&7Classic survival world”
\n material: GRASS_BLOCK
\n slot: 11
\n spawn-range:
\n min: 100 # Minimum distance from center
\n max: 5000 # Maximum distance from center
\n center:
\n x: 0
\n z: 0
\n“`<\/p>\n
### Messages<\/p>\n
All messages are fully customizable with color code support:<\/p>\n
“`yaml
\nmessages:
\n prefix: “&aRTPQUEUE &8\u00bb &r”
\n joined-queue: “&aYou joined the queue for &e%world%&a! &7(%current%\/%max% players)”
\n left-queue: “&cYou left the queue for &e%world%&c.”
\n opponent-found: “&aOpponent found, you will be teleported!”
\n teleportation-countdown: “&eTeleportation in &c%seconds%s”
\n teleported: “&aYou have been teleported!”
\n already-in-queue: “&cYou are already in a queue!”
\n not-in-queue: “&cYou are not in any queue!”
\n world-not-found: “&cWorld not found!”
\n no-permission: “&cYou don’t have permission to use this!”
\n config-reloaded: “&aConfiguration reloaded successfully!”
\n“`<\/p>\n
## Placeholders<\/p>\n
| Placeholder | Description |
\n|————-|————-|
\n| `%player%` | Player’s name |
\n| `%world%` | World display name |
\n| `%current%` | Current players in queue |
\n| `%max%` | Minimum players needed |
\n| `%seconds%` | Countdown seconds remaining |<\/p>\n
## How It Works<\/p>\n
1. Player runs `\/rtpqueue` to open the world selection GUI
\n2. Player clicks on a world to join that world’s queue
\n3. Action bar shows waiting status (persists until opponent found)
\n4. When enough players join (default: 2), countdown begins
\n5. All queued players are teleported together to a safe random location
\n6. Players can leave queue anytime with `\/rtpqueueleave`<\/p>\n
## Safe Location Finding<\/p>\n
The plugin automatically finds safe teleport locations by:
\n– Checking for solid ground (no lava, fire, water, etc.)
\n– Ensuring 2 blocks of air space for the player
\n– Avoiding dangerous blocks nearby (lava, fire, cactus, magma)
\n– Multiple attempts to find the perfect spot<\/p>\n
## Installation<\/p>\n
1. Download the plugin JAR file
\n2. Place it in your server’s `plugins` folder
\n3. Restart or reload your server
\n4. Configure the plugin in `plugins\/RtpQueueAdvance\/config.yml`
\n5. Use `\/rtpqueuereload` to apply changes<\/p>\n
## Requirements<\/p>\n
– Minecraft Server: Paper\/Spigot 1.21+
\n– Java: 21+<\/p>\n
## Author<\/p>\n
Created by **YourSenior**<\/p>\n
## Version<\/p>\n
1.0.0<\/p>\n","protected":false},"excerpt":{"rendered":"
A powerful Minecraft plugin for random teleportation with queue-based matchmaking. Players can join a queue and wait for opponents before being teleported together to a random location.<\/p>\n","protected":false},"featured_media":134572,"template":"","meta":{"_minecraft_slug":"rtpqueue-advance","_minecraft_project_id":"ouTHMGaI","_minecraft_author":"YourSenior","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":592,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"rtpqueue-advance.zip","_minecraft_size_bytes":62028,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-16T10:19:23.206257Z","_minecraft_date_created":"2025-12-14T00:46:35.860434Z","_minecraft_date_modified":"2025-12-14T09:37:29.179691Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/rtpqueue-advance","_minecraft_icon_attachment_id":134572,"_minecraft_imported_at":"2026-06-07T22:42:18+00:00","_minecraft_import_hash":"609a2eba02c5648e8eefc76b1d88793b","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,127,128,129],"mod_loader":[132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-134571","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","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