CQueueSystem

CQueueSystem

This plugin has been tested on 1.8, however, it should theoretically work on newer versions, such as 1.21. Please contact me on discord for support: ch4rles.exe

CQueueSystem is a dynamic queue management and server scaling plugin for BungeeCord (1.8) networks using Pterodactyl. It automatically queues players, starts servers on demand, and gracefully shuts them down when empty. Perfect for minigames, events, or lobbies that need responsive scaling without manual intervention.

Built for Java 8 and Minecraft 1.8 BungeeCord.

✅ Features

• Smart player queue system with FIFO logic
  
  
• Auto-start and shutdown of servers via Pterodactyl Client API
  
  
• Single-server and pool support
  
  
• Live server capacity checks
  
  
• Optional Spigot integration using a dedicated addon
  
  
• Color-coded messages and full config customization
  
  
• Handles full servers with gradual player connection

Requirements

• BungeeCord (1.8+) with plugin support
  
  
• Java 8
  
  
• Pterodactyl panel with Client API keys
  
  
• (Optional) Spigot plugin support via CQueueSystemAddon

Spigot Bridge Addon
To support NPCs, GUIs (e.g. DeluxeHub), or Spigot-side commands that trigger queueing on the BungeeCord proxy, install the Spigot-side addon:

CQueueSystemAddon GitHub Repo

This communicates over a registered plugin messaging channel and allows players to join or leave queues using in-game triggers or GUI actions.

⚙️ Configuration Overview
commands:
join:
name: "queue"
aliases: ["q"]
admin:
name: "queueadmin"
aliases: ["qa", "qsadmin"]

servers:
minigame-01:
panelUrl: " https://panel.example.com"
apiKey: "Bearer <YOUR_CLIENT_API_KEY>"
serverId: "uuid-01"
shutdownTimeout: 10

queues:
minigames:
servers:
- "minigame-01"
threshold: 5
checkInterval: 3
shutdownTimeout: 10
messages:
queued: "&eQueued for &6{queue}&e ({size}/{threshold})"
starting: "&aStarting &6{server}&a..."
connecting: "&aJoining &6{server}&a now!"
leave: "&cYou have left the queue &6{queue}&c."

• threshold – Minimum queued players before starting
  
  
• shutdownTimeout – Time (in minutes) to auto-shutdown an empty server
  
  
• checkInterval – Seconds between ping checks during startup

Commands

Command Description
/queue join <queue> Add player to a queue
/queue leave Remove player from queue
/queueadmin reload Reloads config on the fly
Security Best Practices

• Always use Client API keys (not Application API keys)
  
  
• Make sure to use a very secure key or limit IPs with access