zbRTPQueue

Random-teleport 1v1 duel matchmaking for Paper servers.

Turn random teleportation into competitive PvP. zbRTPQueue is a configurable matchmaking and duel plugin that lets players join world-specific queues, get paired with another player, and teleport to safe random locations for an automated 1v1 fight.

No manual matchmaking. No need to find an opponent yourself. Just join a queue, get matched, and fight.

✨ Features

• 🎯 1v1 Matchmaking — Automatically pairs two players from the same world queue for a duel.
• 🌍 Multi-World Support — Configure separate queues for different worlds, including the Overworld, Nether, End, or custom worlds.
• 🧭 World Selection GUI — A configurable inventory menu lets players choose their preferred duel world.
• 📍 Random Safe Teleportation — Finds suitable locations within configurable spawn ranges and places opponents a set distance apart, facing each other.
• ⚔️ Automated Duels — Players are temporarily frozen before the fight, preventing movement, attacks, item usage, and damage during the countdown.
• ⏱️ Configurable Countdown — Customize the matchmaking teleport countdown and the pre-fight countdown.
• 🏆 Duel Results — Automatically detects wins, losses, and draws. The first death ends the duel, and disconnecting during a fight counts as a loss.
• ⌛ Duel Time Limit — Set a maximum fight duration or disable the limit entirely.
• 📢 Queue Broadcasts — Announce waiting players globally or only to players in the relevant queue, with configurable anti-spam cooldowns.
• 💬 Rich Notifications — Customize chat messages, titles, subtitles, action bars, and join notifications.
• 🔊 Sound Effects — Configure sounds for queue actions, teleportation, countdowns, fights, and duel results.
• ⚙️ Extensive Configuration — Customize world entries, display names, GUI materials, queue behavior, teleport ranges, duel settings, messages, and more.
• 🔄 Configuration Reload — Reload the plugin configuration in-game without manually restarting the server.

🎮 Commands

Aliases

• /rtpq — Alias for /rtpqueue
• /rtpqleave and /leavequeue — Aliases for /rtpqueueleave

🔐 Permissions

🛠️ Configuration

The plugin includes a customizable config.yml with settings for:

• Worlds: Enable or disable worlds, configure GUI entries, and set teleport centers and minimum/maximum spawn distances.
• Queues: Set matchmaking countdowns and determine how countdowns behave when a player leaves.
• Teleportation: Configure the number of attempts to find suitable teleport locations.
• Duels: Set opponent distance, fight countdown, time limit, and result notifications.
• Messages: Customize plugin messages, placeholders, and formatting.
• Broadcasts: Configure announcement scope, cooldowns, and message templates.
• GUI, Titles, Action Bars & Sounds: Personalize the player experience.

Both legacy color codes (&a, &l, &#RRGGBB) and MiniMessage formatting are supported for text customization.

📦 Installation

1. Download the zbRTPQueue JAR.
2. Place it in your server's plugins folder.
3. Start or restart your Paper server.
4. Open plugins/zbRTPQueue/config.yml and configure the worlds you want to use.
5. Adjust the teleport ranges, duel settings, messages, and other options to suit your server.
6. Ensure your configured worlds are loaded and available, then use /rtpqueue to start matchmaking.

Tip: Customize your world centers and spawn ranges to keep duels within your intended PvP areas.

📋 Compatibility

• Platform: Paper
• Minecraft API version: 1.21
• Plugin version: 1.0.0

Test the plugin on your target Minecraft and Paper version before deploying it to a production server.

👨‍💻 Credits

Developed by: nis Organization: Zarbunex Private Limited License: CC BY-NC-ND 4.0

Redistribution and use are subject to the terms of the project's license.

Queue up. Get teleported. Fight.

zbRTPQueue — Random-teleport 1v1 duels, made simple.