Cat Queue

🐱 CatQueue — Smarter Queueing & Seamless Pterodactyl Autoscaling for Velocity

CatQueue is a Pterodactyl 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:

* Automatic autoscaling with Pterodactyl (not just chat spam). * Automatic autoscaling with Pterodactyl (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.

---