# 🐱 CatQueue — 更智能的排队与无缝 Pterodactyl 自动扩展，适用于 Velocity
CatQueue 是一个 **现代 Velocity 代理插件**，旨在为玩家提供流畅、无烦恼的排队体验，并使用 **Pterodactyl** 自动扩展您的 Minecraft 后端服务器。
与其他排队插件不同，CatQueue 专注于 **玩家的清晰度、管理员的安全性和长期的可维护性**。它采用强大的配置迁移、实时排队反馈和一流的自动扩展构建而成，从而让您的网络感觉专业且面向未来。
---
## 为什么选择 CatQueue？
其他排队插件通常…
* 用过时的排队消息刷屏聊天。
* 在更新之间破坏配置，迫使手动重写。
* 忽略扩展，让您手动管理服务器容量。
CatQueue 通过提供以下内容来解决这些痛点：
* **连续的操作栏更新**（而不仅仅是聊天垃圾信息）。
* **非破坏性的配置迁移** (您的评论安全无虞)。
* **Pterodactyl 的自动扩展**（根据需求扩展和缩小容量）。
它不仅仅是一个排队系统——它是一个 **专为现代 Minecraft 网络打造的排队系统**。
---
## 功能
* **连续的操作栏排队状态**
* 实时排队位置和 ETA 显示在操作栏中。
* 完全可配置的格式 + 更新间隔。
* 比嘈杂的聊天垃圾信息更干净、更专业。
* **Pterodactyl 自动扩展集成**
* 根据排队压力自动扩展/缩小后端服务器。
* 结构化的配置用于 Pterodactyl API 和应用设置。
* 在保持良好玩家体验的同时，降低托管成本。
* **安全配置版本控制 + 迁移**
* 每个配置都包含一个 `configVersion`。
* 启动时，CatQueue 会生成一个 **`config.migrated.yml`**，其中包含新的键，而您的原始文件保持不变。
* 您永远不会丢失注释、格式或自定义设置。
* **干净、可扩展的配置**
* 组织顶层块，如 `pterodactyl` 和 `messages`。
* 易于阅读，易于扩展。
* 迁移期间自动添加默认值。
---
## 要求
* Velocity 3.x (在 3.4.0 上测试)
* Java 17+
* Pterodactyl 面板（如果您想要自动扩展）
---
## 安装
1. 将 `CatQueue.jar` 放入您的 Velocity `plugins/` 文件夹中。
2. 启动 Velocity 一次以生成 `config.yml`。
3. 如果是升级，请检查生成的 `config.migrated.yml` (您的旧文件保持不变)。
4. 根据您的喜好合并或替换配置。
5. 重新启动 Velocity，您就完成了。
---
## 配置亮点
* **configVersion**
确保更新之间的平稳迁移。
* **pterodactyl.application**
存储用于自动扩展的 Pterodactyl API + 应用详细信息。
* **messages.actionBar**
* `enabled`: 启用实时更新。
* `intervalTicks`: 更新频率 (20 滴答 = 1 秒)。
* `text`: 具有占位符 (`%position%`, `%eta%`) 的完全可定制文本。
---
## 占位符
* `%position%` → 玩家当前排队位置。
* `%eta%` → 进入前的预计等待时间。
---
## 兼容性
* 与基于聊天的排队消息配合良好（可以独立启用/禁用）。
* 完全 Velocity 原生 —— 没有笨拙的 BungeeCord 移植。
---
## 遥测
* 将操作信息记录到控制台以进行调试。
* 不收集任何个人数据。
---
## 支持
* 在存储库上提出问题或功能请求。
* 报告问题时，请包括 Velocity 版本、插件版本和日志。
---
**CatQueue 不仅仅是另一个排队插件 —— 它是唯一一个专为现代扩展、无痛升级和以玩家为中心的清晰度而设计的插件。**
---