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.

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.