ShamboQ - 高级队列系统

概述
ShamboQ 是一款专为 Minecraft 网络设计的专业队列管理系统,允许服务器管理员在将玩家转移到主服务器之前,为他们创建一个优雅的等待体验。该插件会将玩家冻结在指定的等待区域,显示倒计时消息,并在自动将玩家转移到目标服务器前播放沉浸式音效。插件将持续开发中。
项目历史
ShamboQ 由 Shambonoor Enterpraises 赞助支持。
安装
需求
- 运行 Bukkit/Spigot/Paper 1.19+ 的 Minecraft 服务器(可能兼容 1.16-1.18)
- 代理服务器:BungeeCord、Waterfall 或 Velocity
- Java 8 或更高版本
安装步骤
- 下载 ShamboQ-xxx.jar 文件
- 将 JAR 文件放入大厅服务器的
/plugins/ 目录中
- 重启服务器(或使用插件管理器加载它)
- 编辑生成的配置文件
/plugins/ShamboQ/config.yml 以匹配你的网络设置
- 使用
/shamboq reload 应用配置更改
重要:代理配置
- 确保你的 BungeeCord/Velocity 配置中定义了目标服务器,且名称与 ShamboQ 配置中指定的名称一致
- 在队列服务器的配置文件中启用代理支持
工作原理
队列流程
-
当玩家加入大厅服务器时,ShamboQ 会自动执行以下操作:
- 将玩家固定在原地
- 对其他玩家隐藏当前玩家(反之亦然)
- 将其传送至末地维度的指定出生点(插件默认搜索末地世界)
- 显示带有倒计时信息的欢迎消息
- 播放沉浸式音效
- 在动作栏中显示倒计时
-
当倒计时归零时,玩家将被自动转移到主服务器
队列管理
- 管理员无需重启即可切换队列的开启/关闭状态
- 禁用时,玩家保持冻结状态但不会看到倒计时
- 重新启用时,所有等待中的玩家都会自动加入活动队列流程
- 拥有
shamboq.bypass 权限的玩家将完全跳过队列
配置
config.yml 文件允许你自定义以下内容:
# ShamboQ Configuration
# developed by Shambonoor Ent.
# https://szam.boo/
# https://discord.gg/wUmVUBc7rv
# Queue settings
queue:
# Enable or disable the queue system
enabled: true
# Time in seconds to wait before sending to SMP
time: 10
# Name of the SMP server to connect to
smp-server: "smp"
# Message to show when queue is disabled
disabled-message: "Queue is currently disabled"
# Whether to show the disabled message
show-disabled-message: true
# How often to show the notification in seconds
notification-interval: 5
# Connection settings
connection:
# Maximum number of retry attempts when connection fails
max-retries: 3
# Time in seconds to wait between retry attempts
retry-delay: 5
# Messages for various plugin functions
messages:
queue_enabled: "&aQueue has been enabled!"
queue_disabled: "&cQueue has been disabled!"
no_permission: "&cYou don't have permission to use this command!"
queue_time_set: "&aQueue time set to &e%d &aseconds!"
invalid_number: "&cInvalid number: &e%s"
message_set: "&aQueue disabled message set to: &e%s"
notifications_enabled: "&aQueue disabled notifications have been enabled!"
notifications_disabled: "&cQueue disabled notifications have been disabled!"
player_not_found: "&cPlayer not found: &e%s"
sending_player: "&aSending &e%s &ato &e%s&a!"
config_reloaded: "&aShamboQ configuration reloaded!"
welcome_title: "&6Welcome to the Server!"
welcome_subtitle: "&eYou will be transferred to the SMP server in &6%d &eseconds"
countdown: "&eTransfer in &6%d &eseconds..."
queue_disabled_title: "&cQueue Disabled"
usage_settime: "&cUsage: /shamboq settime <seconds>"
usage_message: "&cUsage: /shamboq message <message>"
usage_send: "&cUsage: /shamboq send <player>"
queue_disabled_player: "&cQueue system has been disabled. You are no longer in queue."
frozen_player: "&cYou are currently frozen in the lobby."
# New connection error messages
connection_failed: "&cConnection to SMP server failed. Retrying..."
connection_error: "&cCould not connect to SMP server. &eError: %s"
connection_timeout: "&cConnection timed out. Retrying in %d seconds..."
max_retries_reached: "&cCould not connect after %d attempts. Please try again later."
back_in_queue: "&eYou've been placed back in the queue due to connection issues."
# Spawn location in the End
spawn:
x: -1.5
y: 64
z: 0.5
# Example of sounds that will be played randomly
sounds:
- "ENTITY_ENDERMAN_DEATH"
- "ENTITY_ENDER_DRAGON_AMBIENT"
- "ENTITY_ENDER_DRAGON_DEATH"
- "BLOCK_END_PORTAL_FRAME_FILL"
- "BLOCK_END_PORTAL_SPAWN"
- "BLOCK_END_GATEWAY_SPAWN"
- "ENTITY_LIGHTNING_BOLT_THUNDER"
- "ENTITY_LIGHTNING_BOLT_IMPACT"
- "ENTITY_GENERIC_EXPLODE"
# Optimization settings for reducing server resource usage
optimization:
# Basic Optimization
chunk-management: true
disable-mobs: true
reduce-view-distance: true
queue-view-distance: 3
no-tick-zone: true
# Advanced
disable-terrain-generation: true
disable-player-ticks: true
spectator-mode: false
dedicated-thread-pool: true
thread-pool-size: 1
aggressive-chunk-management: true
max-loaded-chunks: 5
# Debug mode (enables verbose logging)
debug: false
命令
/shamboq toggle - 开启或关闭队列
/shamboq settime <seconds> - 设置队列等待时间
/shamboq message <text> - 设置队列禁用消息
/shamboq notify - 切换队列禁用通知
/shamboq send <player> - 将特定玩家发送到 SMP 服务器
/shamboq reload - 重新加载配置
/shamboq status - 显示当前队列状态
权限
shamboq.admin - 访问所有 ShamboQ 命令的权限
shamboq.bypass - 完全跳过队列
技术特性
- 支持多版本,具备自动 API 检测功能
- 高级动作栏系统,兼容 Paper 的 Adventure API
- 内存高效的队列管理
- 线程安全的玩家处理机制
- 用于兼容性的自动回退系统
- 优化了队列服务器
支持与反馈
如需技术支持、功能建议或报告错误,请访问 discord.gg/wUmVUBc7rv
由 Shambonoor Ent. 开发
ShamboQ - Advanced Queue System

Overview
ShamboQ is a professional queue management system for Minecraft networks that allows server administrators to create an elegant waiting experience for players before transferring them to the main server. The plugin freezes players in a designated waiting area, displays countdown messages, and plays immersive sound effects before automatically transferring them to the destination server. Plugin will be developed further.
Project History
ShamboQ is sponsored by Shambonoor Enterpraises
Installation
Requirements
- Minecraft server running Bukkit/Spigot/Paper 1.19+ (might work on 1.16-1.18)
- A proxy server: BungeeCord, Waterfall, or Velocity
- Java 8 or higher
Installation Steps
- Download the ShamboQ-xxx.jar file
- Place the JAR file in your lobby server's
/plugins/ directory
- Restart your server (or use a plugin manager to load it)
- Edit the generated configuration file at
/plugins/ShamboQ/config.yml to match your network settings
- Use
/shamboq reload to apply your configuration changes
Important: Proxy Configuration
- Make sure your BungeeCord/Velocity config has the destination server defined with the same name as specified in the ShamboQ configuration
- Enable Proxy support in config files of your Queue Server
How It Works
The Queue Process
-
When a player joins your lobby server, ShamboQ automatically:
- Freezes the player in place
- Hides the player from others (and vice versa)
- Teleports them to the designated spawn point in The End dimension (plugin searches for an End world by default)
- Displays a welcome message with countdown information
- Plays immersive sound effects
- Shows a countdown in the action bar
-
When the countdown reaches zero, the player is automatically transferred to your main server
Queue Management
- Administrators can toggle the queue on/off without restarting
- When disabled, players remain frozen but don't see the countdown
- When re-enabled, all waiting players are automatically added to the active queue process
- Players with the
shamboq.bypass permission skip the queue entirely
Configuration
The config.yml file allows you to customize:
# ShamboQ Configuration
# developed by Shambonoor Ent.
# https://szam.boo/
# https://discord.gg/wUmVUBc7rv
# Queue settings
queue:
# Enable or disable the queue system
enabled: true
# Time in seconds to wait before sending to SMP
time: 10
# Name of the SMP server to connect to
smp-server: "smp"
# Message to show when queue is disabled
disabled-message: "Queue is currently disabled"
# Whether to show the disabled message
show-disabled-message: true
# How often to show the notification in seconds
notification-interval: 5
# Connection settings
connection:
# Maximum number of retry attempts when connection fails
max-retries: 3
# Time in seconds to wait between retry attempts
retry-delay: 5
# Messages for various plugin functions
messages:
queue_enabled: "&aQueue has been enabled!"
queue_disabled: "&cQueue has been disabled!"
no_permission: "&cYou don't have permission to use this command!"
queue_time_set: "&aQueue time set to &e%d &aseconds!"
invalid_number: "&cInvalid number: &e%s"
message_set: "&aQueue disabled message set to: &e%s"
notifications_enabled: "&aQueue disabled notifications have been enabled!"
notifications_disabled: "&cQueue disabled notifications have been disabled!"
player_not_found: "&cPlayer not found: &e%s"
sending_player: "&aSending &e%s &ato &e%s&a!"
config_reloaded: "&aShamboQ configuration reloaded!"
welcome_title: "&6Welcome to the Server!"
welcome_subtitle: "&eYou will be transferred to the SMP server in &6%d &eseconds"
countdown: "&eTransfer in &6%d &eseconds..."
queue_disabled_title: "&cQueue Disabled"
usage_settime: "&cUsage: /shamboq settime <seconds>"
usage_message: "&cUsage: /shamboq message <message>"
usage_send: "&cUsage: /shamboq send <player>"
queue_disabled_player: "&cQueue system has been disabled. You are no longer in queue."
frozen_player: "&cYou are currently frozen in the lobby."
# New connection error messages
connection_failed: "&cConnection to SMP server failed. Retrying..."
connection_error: "&cCould not connect to SMP server. &eError: %s"
connection_timeout: "&cConnection timed out. Retrying in %d seconds..."
max_retries_reached: "&cCould not connect after %d attempts. Please try again later."
back_in_queue: "&eYou've been placed back in the queue due to connection issues."
# Spawn location in the End
spawn:
x: -1.5
y: 64
z: 0.5
# Example of sounds that will be played randomly
sounds:
- "ENTITY_ENDERMAN_DEATH"
- "ENTITY_ENDER_DRAGON_AMBIENT"
- "ENTITY_ENDER_DRAGON_DEATH"
- "BLOCK_END_PORTAL_FRAME_FILL"
- "BLOCK_END_PORTAL_SPAWN"
- "BLOCK_END_GATEWAY_SPAWN"
- "ENTITY_LIGHTNING_BOLT_THUNDER"
- "ENTITY_LIGHTNING_BOLT_IMPACT"
- "ENTITY_GENERIC_EXPLODE"
# Optimization settings for reducing server resource usage
optimization:
# Basic Optimization
chunk-management: true
disable-mobs: true
reduce-view-distance: true
queue-view-distance: 3
no-tick-zone: true
# Advanced
disable-terrain-generation: true
disable-player-ticks: true
spectator-mode: false
dedicated-thread-pool: true
thread-pool-size: 1
aggressive-chunk-management: true
max-loaded-chunks: 5
# Debug mode (enables verbose logging)
debug: false
Commands
/shamboq toggle - Enable or disable the queue
/shamboq settime <seconds> - Set the queue waiting time
/shamboq message <text> - Set the queue disabled message
/shamboq notify - Toggle queue disabled notifications
/shamboq send <player> - Send a specific player to the SMP server
/shamboq reload - Reload the configuration
/shamboq status - Show the current queue status
Permissions
shamboq.admin - Access to all ShamboQ commands
shamboq.bypass - Skip the queue entirely
Technical Features
- Multi-version support with automatic API detection
- Advanced action bar system compatible with Paper's Adventure API
- Memory-efficient queue management
- Thread-safe player handling
- Automatic fallback systems for compatibility
- Optimization of Queue Server
Support and Feedback
For support, feature requests, or to report bugs, please visit discord.gg/wUmVUBc7rv
Developed by Shambonoor Ent.
评论 0
登录后参与评分
还没有评论,来抢沙发吧