-[PASTA'S RTP QUEUE]-

Overview

PastasRTPQ is a lightweight and highly configurable random teleport queue plugin designed for Paper servers. It allows players to join a shared RTP queue where they are paired together and teleported safely into the wilderness once enough players are queued.

The plugin is designed for survival, SMP, lifesteal, practice, and network servers that want a clean and fair RTP system with configurable safety checks, queue handling, sounds, messages, and modern MiniMessage formatting support.

PastasRTPQ focuses on performance, simplicity, and full customization while ensuring all teleport locations are safe and playable.

Prerequisites

Paper or compatible forks (1.20 - 1.21+ recommended)

Table of Contents

Features
Commands
Permission Nodes
Configuration
Installation
Credits
License

━━━━━━━━━━━━━━━━━━━━ FEATURES ━━━━━━━━━━━━━━━━━━━━

RTP Queue System: Players are teleported once enough players join the queue
Safe Teleportation: Ensures safe spawn locations with solid ground and free space
Shared Teleport Locations: Players teleport near each other for cooperative gameplay
Configurable RTP Radius: Define minimum and maximum teleport distances
Queue Broadcast System: Notify the server when players are waiting in queue
Fully Configurable Messages: Customize all plugin messages and formatting
Sound Support: Play configurable sounds on queue join and teleport
MiniMessage Support: Supports MiniMessage, legacy &, and hex colors
Multiple Display Modes: Send messages in chat, actionbar, or both
Config Reload Command: Reload configuration without restarting server
Lightweight Design: Minimal performance impact on servers
Colored Console Messages: Styled startup and shutdown console messages

━━━━━━━━━━━━━━━━━━━━ COMMANDS ━━━━━━━━━━━━━━━━━━━━

/rtpq join - Join the RTP queue
/rtpq leave - Leave the RTP queue
/rtpq reload - Reload the plugin configuration

Aliases:
/rtpqueue

━━━━━━━━━━━━━━━━━━━━ PERMISSION NODES ━━━━━━━━━━━━━━━━━━━━

pastasrtpq.admin - Access to reload command
pastasrtpq.join - Permission to join the RTP queue
pastasrtpq.bypass - Bypass RTP queue restrictions (optional future use)

━━━━━━━━━━━━━━━━━━━━ CONFIGURATION ━━━━━━━━━━━━━━━━━━━━

Queue Settings

world - World used for random teleports
min-distance - Minimum RTP distance from spawn
max-distance - Maximum RTP distance from spawn
queue-wait-broadcast-seconds - Time before waiting queue broadcast is sent

Messages System

messages.prefix - Plugin message prefix
messages.joined - Queue join message
messages.left - Queue leave message
messages.teleported - Successful teleport message
messages.queue-broadcast - Broadcast when waiting for another player
messages.reloaded - Reload confirmation message

Display Settings

display-mode - chat, actionbar, or both

Sound Settings

sounds.enabled - Enable or disable sounds
sounds.joined.sound - Sound played when joining queue
sounds.teleported.sound - Sound played after teleport

Startup Messages

startup.enabled - Console startup message
startup.disabled - Console shutdown message

━━━━━━━━━━━━━━━━━━━━ INSTALLATION ━━━━━━━━━━━━━━━━━━━━

Download the plugin jar
Place it in your plugins folder
Restart your server
Edit config.yml to configure RTP settings
Run /rtpq reload after making changes

━━━━━━━━━━━━━━━━━━━━ CREDITS ━━━━━━━━━━━━━━━━━━━━

Created by pastosjava

━━━━━━━━━━━━━━━━━━━━ LICENSE ━━━━━━━━━━━━━━━━━━━━

All rights reserved unless otherwise stated.