ShamboQ

插件

· 作者 gazio444

轻量级队列插件

0 本站下载 0 关注 更新于 1 年前

最新 2.0.0 · 1.21.5 · Bukkit / Paper

一键开服(送7天)

ShamboQ - 高级队列系统

sq

概述

ShamboQ 是一款专为 Minecraft 网络设计的专业队列管理系统,允许服务器管理员在将玩家转移到主服务器之前,为他们创建一个优雅的等待体验。该插件会将玩家冻结在指定的等待区域,显示倒计时消息,并在自动将玩家转移到目标服务器前播放沉浸式音效。插件将持续开发中。

项目历史

ShamboQ 由 Shambonoor Enterpraises 赞助支持。

安装

需求

  • 运行 Bukkit/Spigot/Paper 1.19+ 的 Minecraft 服务器(可能兼容 1.16-1.18)
  • 代理服务器:BungeeCord、Waterfall 或 Velocity
  • Java 8 或更高版本

安装步骤

  1. 下载 ShamboQ-xxx.jar 文件
  2. 将 JAR 文件放入大厅服务器的 /plugins/ 目录中
  3. 重启服务器(或使用插件管理器加载它)
  4. 编辑生成的配置文件 /plugins/ShamboQ/config.yml 以匹配你的网络设置
  5. 使用 /shamboq reload 应用配置更改

重要:代理配置

  1. 确保你的 BungeeCord/Velocity 配置中定义了目标服务器,且名称与 ShamboQ 配置中指定的名称一致
  2. 在队列服务器的配置文件中启用代理支持

工作原理

队列流程

  1. 当玩家加入大厅服务器时,ShamboQ 会自动执行以下操作:

    • 将玩家固定在原地
    • 对其他玩家隐藏当前玩家(反之亦然)
    • 将其传送至末地维度的指定出生点(插件默认搜索末地世界)
    • 显示带有倒计时信息的欢迎消息
    • 播放沉浸式音效
    • 在动作栏中显示倒计时
  2. 当倒计时归零时,玩家将被自动转移到主服务器

队列管理

  • 管理员无需重启即可切换队列的开启/关闭状态
  • 禁用时,玩家保持冻结状态但不会看到倒计时
  • 重新启用时,所有等待中的玩家都会自动加入活动队列流程
  • 拥有 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. 开发

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源