⏳ Standalone-Queue

A lightweight, highly configurable, and standalone queue management system for Minecraft servers & proxies.

---

🌟 Overview

Standalone-Queue is designed to seamlessly manage player traffic when your server reaches peak capacity. Unlike bloated network suites, this plugin provides a rock-solid, zero-dependency, and lightweight queue system that works right out of the box.

Whether you run a single dedicated server or a high-traffic network, Standalone-Queue ensures fair player handling, smooth connections, and complete control over priority routing.

---

✨ Features

• ⚡ High Performance & Lightweight: Minimal TPS impact and zero memory overhead, optimized for large spikes in join requests.
• 👑 Priority & Tiered Queuing: Configure priority weights for VIPs, donors, and staff members (bypass or jump places).
• 🔄 Grace Period / Reconnect Protection: Disconnected players have a configurable grace window to reclaim their queue position.
• 🎨 Rich Visual Feedback: Live queue status with action-bar countdowns, titles, and boss bars.
• 💬 Customizable Messaging: Full MiniMessage / RGB color formatting support for all player-facing notices.
• 🔌 PlaceholderAPI Support: Easily hook queue numbers, positions, and ETAs into your scoreboards and tablists.
• ⚙️ Fully Standalone: No mandatory external database or proxy configuration required—simple drop-and-play.

---

📥 Installation

1. Download the latest release from the Versions tab or GitHub Releases.
2. Drop the .jar file into your server's plugins/ directory.
3. Restart your server to generate the default configuration files.
4. Edit plugins/Standalone-Queue/config.yml to fit your network needs.
5. Run /queue reload to apply your changes!

---

💻 Commands & Permissions

Command	Permission	Description
/queue status	queue.command.status	Check your current position and estimated wait time.
/queue leave	queue.command.leave	Leave the queue voluntarily.
/queue pause	queue.admin.pause	Pause/unpause the queue system.
/queue reload	queue.admin.reload	Reload the plugin configuration files.
/queue kick <player>	queue.admin.kick	Remove a specific player from the queue.

🔑 Additional Permissions

• queue.bypass — Completely bypass the queue and connect instantly.
• queue.priority.<tier> — Assign priority queue placement (e.g., queue.priority.donator, queue.priority.vip).

---

⚙️ Configuration Preview

# Standalone-Queue Main Configuration

queue:
  # Enable or disable queue system
  enabled: true
  # Maximum allowed players before queue activates
  max-players: 100
  # Rate limit: player connection interval in seconds
  send-interval: 2
  # Time in seconds for reconnect grace period
  grace-period: 60

priority-tiers:
  owner: 100
  admin: 75
  donator: 50
  default: 0

messages:
  in-queue: "<yellow>You are currently in position <gold>#%position%</gold> of <gold>%total%</gold>."
  connecting: "<green>A slot is ready! Connecting you to the server..."
  queue-paused: "<red>The queue is currently paused by an administrator."