---

⚡ What is RtpqX?

RtpqX is a next-generation matchmaking and combat leash plugin built from scratch for Crystal PvP, Practice, KitPvP, and Survival SMP servers.

It queues combatants and pairs them into random wilderness duels instantly. Its custom asynchronous terrain engine ensures players never spawn inside blocks, lava, ocean voids, or high-fall traps, placing opponents directly face-to-face at a balanced distance.

---

🌟 Core Features

• ⚡ Asynchronous Safe Wilderness RTP:

  • Scans and loads chunks asynchronously without stalling the main thread.
  • Heuristics automatically avoid lava, water, leaves, caves, and dangerous drop-offs.
  • Opponents spawn facing each other at a customizable distance (e.g., 14 blocks apart).
  • Configurable multi-world support (whitelist arenas or survival worlds).

• 🏹 Combat Leash & Disconnect Guard:

  • Leashes opponents together so runners cannot flee combat.
  • Automatically awards the win if an opponent disconnects or flees the match.
  • Built-in teleport grace period prevents false cancellations across worlds.

• 🔥 Killstreaks & Automatic Monthly Resets:

  • Tracks current streaks, all-time personal bests, and monthly leaderboard scores.
  • Automatic monthly resets keep your server's competitive season fresh.
  • Configurable milestone announcements across the server.

• 🏆 Interactive Killstreak GUI (/ks):

  • Clean non-italicized layout showing personal records, total wins, and the server's #1 streaker.
  • Styled in clean small-caps unicode and soft gray accents.

• 📢 Animated Action Bar Broadcasts:

  • Notifies online players when someone is searching in the queue with animated indicator dots (...).
  • Broadcasts your custom server IP when the queue is idle.

• ⚙️ DeluxeMenus & PlaceholderAPI Ready:

  • Players can toggle actionbar alerts with /rtpq toggle.
  • Settings are cached in memory and saved to SQLite with zero tick lag.
  • Complete suite of %rtpq_*% placeholders ready for custom menus.

---

⌨️ Commands & Permissions

Command	Permission	Description
/rtpq	rtpq.use	Join or leave the 1v1 RTP matchmaking queue
/rtpq leave	rtpq.use	Leave the matchmaking queue
/rtpq toggle [actionbar] [on|off]	rtpq.use	Toggle actionbar visibility for yourself
/rtpq toggle <player> [actionbar] [on|off]	rtpq.admin	Toggle or set actionbar visibility for a player
/killstreak (Aliases: /ks, /rtpks)	rtpq.killstreak	Open the interactive Killstreak GUI
/rtpqadmin reset <player>	rtpq.admin	Reset a player's killstreak statistics
/rtpqadmin resetall	rtpq.admin	Reset all killstreaks across the entire server
/rtpq reload (Alias: /rtpqa reload)	rtpq.admin	Hot-reload configuration and messages

---

🧩 PlaceholderAPI Placeholders

Placeholder	Output	Description
%rtpq_actionbar%	true / false	Actionbar toggle state (ideal for DeluxeMenus requirements)
%rtpq_actionbar_status%	&aON / &cOFF	Colored status indicator
%rtpq_actionbar_formatted%	&a✔ ᴇɴᴀʙʟᴇᴅ / &c✖ ᴅɪꜱᴀʙʟᴇᴅ	Formatted unicode status
%rtpq_killstreak%	8	Current active killstreak
%rtpq_highest_killstreak%	35	All-time personal best killstreak
%rtpq_monthly_killstreak%	18	Current monthly killstreak
%rtpq_wins%	64	Total RTPQ wins
%rtpq_losses%	7	Total RTPQ losses
%rtpq_queue_size%	2	Number of players currently in queue
%rtpq_top_player%	X3vro	Current #1 streak holder
%rtpq_top_streak%	54	Highest streak on the server
%rtpq_in_queue%	true / false	Whether the player is in queue
%rtpq_in_match%	true / false	Whether the player is in an active duel

---

📦 DeluxeMenus Setup Example

Add this interactive ON / OFF toggle button to your DeluxeMenus settings file:

  'rtpq_actionbar_on':
    material: LIME_DYE
    slot: 13
    priority: 1
    display_name: '&#66FCF1&lʀᴛᴘǫᴜᴇᴜᴇ ᴀᴄᴛɪᴏɴʙᴀʀ'
    lore:
      - '&#868E96Toggle visibility of the'
      - '&#868E96RTP Queue actionbar status.'
      - ''
      - '&#495057│ &#868E96Status: &a&lENABLED'
      - ''
      - '&#66FCF1▸ Click to disable'
    view_requirement:
      requirements:
        is_enabled:
          type: string equals
          input: '%rtpq_actionbar%'
          output: 'true'
    left_click_commands:
      - '[player] rtpq toggle actionbar off'
      - '[refresh]'

  'rtpq_actionbar_off':
    material: GRAY_DYE
    slot: 13
    priority: 2
    display_name: '&#66FCF1&lʀᴛᴘǫᴜᴇᴜᴇ ᴀᴄᴛɪᴏɴʙᴀʀ'
    lore:
      - '&#868E96Toggle visibility of the'
      - '&#868E96RTP Queue actionbar status.'
      - ''
      - '&#495057│ &#868E96Status: &c&lDISABLED'
      - ''
      - '&#66FCF1▸ Click to enable'
    view_requirement:
      requirements:
        is_disabled:
          type: string equals
          input: '%rtpq_actionbar%'
          output: 'false'
    left_click_commands:
      - '[player] rtpq toggle actionbar on'
      - '[refresh]'

Developed with ❤️ by X3vro • Compatible with Paper, Purpur & Folia