# \ud83d\udc31 CatQueue \u2014 Smarter Queueing & Seamless Pterodactyl Autoscaling for Velocity<\/p>\n
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**.<\/p>\n
Unlike other queue plugins, CatQueue focuses on **player clarity, admin safety, and long-term maintainability**. It\u2019s built with robust config migrations, live queue feedback, and first-class autoscaling \u2014 so your network feels professional and future-proof.<\/p>\n
—<\/p>\n
## Why CatQueue?<\/p>\n
Other queue plugins often\u2026<\/p>\n
* Spam chat with outdated queue messages.
\n* Break configs between updates, forcing manual rewrites.
\n* Ignore scaling, leaving you to manage server capacity by hand.<\/p>\n
CatQueue solves these pain points by delivering:<\/p>\n
* **Continuous action bar updates** (not just chat spam).
\n* **Non-destructive config migrations** (your comments stay safe).
\n* **Automatic autoscaling with Pterodactyl** (grow and shrink capacity based on demand).<\/p>\n
It\u2019s not just a queue \u2014 it\u2019s a **queue built for modern Minecraft networks**.<\/p>\n
—<\/p>\n
## Features<\/p>\n
* **Continuous Action Bar Queue Status**<\/p>\n
* Live queue position and ETA displayed right in the action bar.
\n * Fully configurable format + update interval.
\n * Cleaner, more professional than noisy chat spam.<\/p>\n
* **Pterodactyl Autoscaling Integration**<\/p>\n
* Scale backend servers up\/down automatically based on queue pressure.
\n * Structured config for Pterodactyl API and application settings.
\n * Keeps hosting costs down while maintaining great player experience.<\/p>\n
* **Safe Config Versioning + Migration**<\/p>\n
* Every config includes a `configVersion`.
\n * On startup, CatQueue generates a **`config.migrated.yml`** with new keys, leaving your original untouched.
\n * You\u2019ll never lose comments, formatting, or customizations.<\/p>\n
* **Clean, Extensible Config**<\/p>\n
* Organized top-level blocks like `pterodactyl` and `messages`.
\n * Easy to read, easy to extend.
\n * Defaults automatically added during migrations.<\/p>\n
—<\/p>\n
## Requirements<\/p>\n
* Velocity 3.x (tested on 3.4.0)
\n* Java 17+
\n* Pterodactyl panel (only if you want autoscaling)<\/p>\n
—<\/p>\n
## Installation<\/p>\n
1. Drop `CatQueue.jar` into your Velocity `plugins\/` folder.
\n2. Start Velocity once to generate `config.yml`.
\n3. If upgrading, check the generated `config.migrated.yml` (your old file stays intact).
\n4. Merge or replace configs as you prefer.
\n5. Restart Velocity and you\u2019re done.<\/p>\n
—<\/p>\n
## Configuration Highlights<\/p>\n
* **configVersion**
\n Ensures smooth migration across updates.<\/p>\n
* **pterodactyl.application**
\n Holds Pterodactyl API + app details for autoscaling.<\/p>\n
* **messages.actionBar**<\/p>\n
* `enabled`: toggle live updates.
\n * `intervalTicks`: update frequency (20 ticks = 1s).
\n * `text`: fully customizable with placeholders (`%position%`, `%eta%`).<\/p>\n
—<\/p>\n
## Placeholders<\/p>\n
* `%position%` \u2192 Player\u2019s current queue position.
\n* `%eta%` \u2192 Estimated wait time until entry.<\/p>\n
—<\/p>\n
## Compatibility<\/p>\n
* Works alongside chat-based queue messages (can enable\/disable independently).
\n* Fully Velocity-native \u2014 no clunky BungeeCord porting.<\/p>\n
—<\/p>\n
## Telemetry<\/p>\n
* Logs operational info to console for debugging.
\n* No personal data collected.<\/p>\n
—<\/p>\n
## Support<\/p>\n
* Open issues or feature requests on the repo.
\n* Please include Velocity version, plugin version, and logs when reporting.<\/p>\n
—<\/p>\n
**CatQueue is not just another queue plugin \u2014 it\u2019s the only one designed for modern scaling, painless upgrades, and player-first clarity.**<\/p>\n
—<\/p>\n","protected":false},"excerpt":{"rendered":"
Modern Queueing for Velocity<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"cat-queue","_minecraft_project_id":"3dbEGxGa","_minecraft_author":"Bobcat","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":106,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"cat-queue.zip","_minecraft_size_bytes":2834604,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T19:35:37.282590Z","_minecraft_date_created":"2025-08-27T05:30:28.677822Z","_minecraft_date_modified":"2025-08-26T16:17:34.924862Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/cat-queue","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-01T19:01:20+00:00","_minecraft_import_hash":"151833361b2aea3791c76ce2d14c29dd","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,866,123,869,92,985],"mod_loader":[986],"minecraft_version":[357,360,379,382,385,438,446,449,110,111,112,113,114,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,73,74,38,78,79,80,81],"class_list":["post-37452","mod","type-mod","status-publish","hentry","mod_category-management","mod_category-minigame","mod_category-technology","mod_category-transportation","mod_category-utility","mod_category-velocity","mod_loader-velocity","minecraft_version-1-11","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8"],"yoast_head":"\n