Folia RTP Queue PvP System v2.0

Folia RTP Queue v2.0 ➤ The Ultimate PvP System [Stats, Rewards, Leaderboards]



Folia RTP Queue PvP System is a lightweight, modern, and highly optimized PvP matchmaking plugin built exclusively for Folia servers.



It allows players to queue for PvP fights and automatically matches them into fair 1v1 battles using Random Teleport (RTP) mechanics. Version 2.0 introduces a massive overhaul with a full Statistics System, Leaderboards, Automated Rewards, and Anti-Spam Cooldowns.



This plugin handles Folia's region-based threading model natively, ensuring safe teleportation, smooth performance, and zero async-related crashes.



---



v2.0 MAJOR UPDATE



The v2.0 Update transforms this plugin from a simple random teleporter into a full-fledged Competitive PvP System:



Statistics System: Tracks Wins, Losses, Kills, Deaths, and Win Rates for every player.

Rewards System: Automatically give items, money (Vault), or execute commands for match winners.

Leaderboards: Display top players by Wins, Kills, or Win Rate via commands (/rtpqlb).

Cooldown System: Prevent queue spamming with configurable post-match cooldowns.

Smart Death Tracking: Auto-detects match results when a player dies and announces the winner.

Enhanced GUI: Now shows your specific Queue Position and personal Stats inside the menu.



---



Key Features



Competitive Features

Automatic 1v1 Matchmaking: Fair and fast player pairing.

Real-time Leaderboards: See who rules the server.

Player Statistics: View your own or others' PvP stats (/rtpq stats).

Win Rewards: Configurable rewards (Items, Money, Custom Commands).

Data Persistence: All stats are saved safely to stats.yml.



Core Mechanics

Random Teleport (RTP): Teleports players to a random location within a configurable radius.

Region Safety: Checks for safe blocks (avoiding lava/void/oceans) before teleporting.

Countdown System: Visual BossBar, ActionBar, and Titles before the fight begins.

PvP Protection: Optional invincibility period after teleport.

Inventory Management: Option to clear inventory before fights.



---



Commands & Permissions



| Command | Alias | Description | Permission |

| :--- | :--- | :--- | :--- |

| /rtpq | /rtpqueue | Open the Queue GUI | foliartpqueue.use |

| /rtpq stats [player] | - | View stats (Wins, Kills, etc.) | foliartpqueue.use<br>foliartpqueue.stats.others |

| /rtpqlb [type] | /rtpql | View the Leaderboard | foliartpqueue.leaderboard |

| /rtpq reload | - | Reload config and messages | op |



Leaderboard Usage

/rtpqlb (Default: Top Wins)

/rtpqlb kills (Top Kills)

/rtpqlb winrate (Top Win %)



---



Configuration



The config.yml is 100% customizable. You can translate every message and tweak every setting.



New Configurable Messages (v2.0)

You can now customize the win/loss and cooldown messages:

```yaml

messages:

prefix: "&8[&6RTPQueue&8] "

... existing messages ...



NEW in v2.0

match-win: "&6&lVICTORY! &eYou have defeated {loser}!"

match-lose: "&c&lDEFEAT! &7You were eliminated by {killer}."

cooldown-message: "&cYou must wait &e{time}s &cbefore joining the queue again."

Rewards Configuration

YAML

rewards:

enable: true

Commands to run when a player wins ({player} placeholder)

commands:

- "eco give {player} 1000"

- "broadcast &a{player} just won a 1v1 RTP match!"



Give physical items

give-items: true

items:

- "DIAMOND:1"

- "GOLDEN_APPLE:2"

Cooldown Configuration

YAML

cooldown:

enabled: true

Time in seconds players must wait after a match

time: 30​

​

Statistics System

We have implemented a robust StatisticsManager that tracks:​

• Wins & Losses
• Kills & Deaths
• Win Rate % (Calculated automatically)

Data is stored in stats.yml and is protected against data loss during server restarts.​

​

Installation​

1. Download FoliaRtpQueue-2.0.jar.
2. Drop it into your Folia server's plugins folder.
3. Restart the server.
4. (Optional) Edit config.yml to set your RTP world, Rewards, and Messages.
5. (Optional) Assign permissions foliartpqueue.use and foliartpqueue.leaderboard to players.

​

Compatibility​

• Server Software: Folia (1.20.x, 1.21.x+)
• Java: Java 21+
• Dependencies: None.

​

Support & Issues: If you find a bug or have a suggestion, please post in the Discussion tab or join our support Discord.​

All reported issues related to missing boss bars, empty messages, and incorrect queue behavior have been resolved.
The plugin has been fully tested on Folia 1.21.4 with Java 21 to ensure correct behavior under real gameplay conditions.

Fixed​

• Fixed boss bar not displaying or disappearing during countdown
• Fixed empty or blank chat messages when the first player joins the queue
• Fixed incorrect queue logic causing messages to appear for the second player
• Fixed title display timing after teleport
• Improved overall queue flow and state handling

Tested​

• Tested with multiple players joining and leaving the queue
• Verified countdown, boss bar, action bar, sounds, and titles
• Verified teleport safety using Folia region and entity schedulers

No configuration changes are required. Existing configs remain compatible.