Cat Queue

🐱 CatQueue — Smarter Queueing & Seamless Pterodactyl Autoscaling for Velocity

CatQueue is a modern Velocity proxy plugin built to give players a smooth, frustration-free queueing experience while automatically scaling your Minecraft backend servers using Pterodactyl.

Unlike other queue plugins, CatQueue focuses on player clarity, admin safety, and long-term maintainability. It's built with robust config migrations, live queue feedback, and first-class autoscaling — so your network feels professional and future-proof.

Why CatQueue?

Other queue plugins often…

• Spam chat with outdated queue messages.
• Break configs between updates, forcing manual rewrites.
• Ignore scaling, leaving you to manage server capacity by hand.

CatQueue solves these pain points by delivering:

• Continuous action bar updates (not just chat spam).
• Non-destructive config migrations (your comments stay safe).
• Automatic autoscaling with Pterodactyl (grow and shrink capacity based on demand).

It's not just a queue — it's a queue built for modern Minecraft networks.

Features

• Continuous Action Bar Queue Status

  • Live queue position and ETA displayed right in the action bar.
  • Fully configurable format + update interval.
  • Cleaner, more professional than noisy chat spam.

• Pterodactyl Autoscaling Integration

  • Scale backend servers up/down automatically based on queue pressure.
  • Structured config for Pterodactyl API and application settings.
  • Keeps hosting costs down while maintaining great player experience.

• Safe Config Versioning + Migration

  • Every config includes a configVersion.
  • On startup, CatQueue generates a config.migrated.yml with new keys, leaving your original untouched.
  • You'll never lose comments, formatting, or customizations.

• Clean, Extensible Config

  • Organized top-level blocks like pterodactyl and messages.
  • Easy to read, easy to extend.
  • Defaults automatically added during migrations.

Requirements

• Velocity 3.x (tested on 3.4.0)
• Java 17+
• Pterodactyl panel (only if you want autoscaling)

Installation

1. Drop CatQueue.jar into your Velocity plugins/ folder.
2. Start Velocity once to generate config.yml.
3. If upgrading, check the generated config.migrated.yml (your old file stays intact).
4. Merge or replace configs as you prefer.
5. Restart Velocity and you're done.

Configuration Highlights

• configVersion Ensures smooth migration across updates.

• pterodactyl.application Holds Pterodactyl API + app details for autoscaling.

• messages.actionBar

  • enabled: toggle live updates.
  • intervalTicks: update frequency (20 ticks = 1s).
  • text: fully customizable with placeholders (%position%, %eta%).

Placeholders

• %position% → Player's current queue position.
• %eta% → Estimated wait time until entry.

Compatibility

• Works alongside chat-based queue messages (can enable/disable independently).
• Fully Velocity-native — no clunky BungeeCord porting.

Telemetry

• Logs operational info to console for debugging.
• No personal data collected.

Support

• Open issues or feature requests on the repo.
• Please include Velocity version, plugin version, and logs when reporting.

CatQueue is not just another queue plugin — it's the only one designed for modern scaling, painless upgrades, and player-first clarity.