LobbyLimbo Manager

插件

· 作者 Hall127

适用于 BungeeCord 和 Velocity 的大厅与空界管理器,具备智能回退、排队系统以及跨服务器的自动玩家路由功能。

0 本站下载 0 关注 更新于 6 个月前

最新 1.1.0 · 26.1.2 · BungeeCord / Velocity

一键开服(送7天)

LobbyLimboManager Banner

LobbyLimboManager

适用于 BungeeCord 和 Velocity 网络的高性能大厅与等待(Limbo)管理插件。

专为可扩展性、可靠性以及在多服务器环境中平滑的玩家路由而设计。

概览

LobbyLimboManager 在代理层面处理玩家分配、回退逻辑和队列管理。

  • 自动将玩家路由到可用大厅
  • 需要时利用 Limbo 服务器保持玩家连接
  • 内置针对已满或不可用大厅的队列系统
  • 行为完全可配置
  • 同时支持 Velocity 和 BungeeCord

功能

智能路由

根据可配置的策略自动将玩家发送到最合适的大厅:

  • 最少玩家数
  • 随机选择
  • 轮询分发

Limbo 与回退系统

在大厅不可用时防止不必要的断开连接。

  • 需要时将玩家发送到 Limbo 服务器
  • 在停机期间保持玩家连接
  • 当大厅恢复可用时平滑地重定向回大厅

队列系统

高效处理已满或不可用的大厅。

  • 自动队列处理
  • 有空位时发送玩家
  • 防止连接泛滥和加入失败

多服务器支持

专为灵活的网络设置打造。

  • 多个大厅服务器
  • 多个 Limbo 服务器
  • 动态路由

完全可配置

自定义行为以适配您的网络。

  • 路由模式
  • 服务器限制
  • 回退行为
  • 队列系统

支持使用以下命令实时重载配置:

/llm reload

命令

  • /lobby, /hub → 将玩家发送到可用大厅
  • /llm reload → 重新加载插件配置

权限

  • lobbylimbomanager.command.lobby → 访问 /lobby 和 /hub 命令
  • lobbylimbomanager.admin → 访问管理命令

安装

  1. 下载最新版本
  2. 将 .jar 文件放入代理插件文件夹
  3. 启动您的代理
  4. 根据需要编辑生成的配置文件

兼容性

  • Velocity
  • BungeeCord
  • Waterfall(未经测试,但预计可以工作)

Config.yaml 示例

剧透
# ============================================================
# LobbyLimboManager 配置
# ============================================================
# 此文件控制玩家在 BungeeCord、Waterfall 和 Velocity 代理之间的大厅和
# Limbo 服务器之间的路由方式。
#
# 重要提示:下面列出的服务器名称必须与您代理配置中定义的名称完全匹配。
# 它们在此文件中不区分大小写,但必须存在。
# ============================================================

# -----------------------------------------------------------
# 配置版本
# -----------------------------------------------------------
# 此值由插件管理。请勿修改它。
# 更改它可能会在下一次重载时重置您的配置。
config-version: 1

# ============================================================
# 大厅服务器
# ============================================================
# 列出玩家可以被发送到的所有大厅服务器。
# 这些是玩家登录或被从踢出状态恢复时加入的主要服务器。
#
# 注意:名称必须与您在代理配置中定义的服务器名称匹配
#       (例如 BungeeCord config.yml 或 Velocity
#       velocity.toml)。插件在运行时通过这些名称查找服务器。
lobbies:
  servers:
    - lobby1
    - lobby2
    - lobby3

# ============================================================
# Limbo 服务器
# ============================================================
# Limbo 服务器是轻量级的暂存服务器,用于没有
# 可用大厅或玩家正在排队时。
#
# 注意:此处列出的服务器不应同时列在
# lobbies 下。插件将在 Limbo 选择中忽略重复的名称。
limbos:
  servers:
    - limbo1
    - limbo2

# ============================================================
# 选择模式
# ============================================================
# 控制插件选择将玩家发送到哪个服务器的逻辑。
modes:

  # 大厅选择模式
  # --------------------
  # 确定当玩家需要一个大厅时如何选择大厅。
  #
  # 有效值:
  #   ROUND_ROBIN   - 按顺序循环遍历大厅。
  #                   示例:lobby1 -> lobby2 -> lobby3 -> lobby1
  #   RANDOM        - 随机选择一个可用大厅。
  #   LEAST_PLAYERS - 选择当前玩家数量最少的大厅。
  lobby-mode: ROUND_ROBIN

  # Limbo 选择模式
  # --------------------
  # 确定如何选择 Limbo 服务器。
  #
  # 有效值:
  #   FALLBACK    - 仅在没有大厅可用时才使用 Limbo。这是推荐的默认值。
  #   ROUND_ROBIN - 独立轮换 Limbo 服务器。
  #   STANDALONE  - Limbo 服务器永远不会自动使用。
  #                 必须手动指定目标。
  limbo-mode: FALLBACK

# ============================================================
# 回退设置
# ============================================================
# 控制当玩家被从服务器踢出时会发生什么。
#
# 回退流程(按顺序):
#   1. 如果踢出消息包含 no-fallback 关键字,则
#      玩家断开连接(不尝试恢复)。
#   2. 如果启用了 fallback-to-lobby,插件会尝试
#      找到另一个可用大厅。
#   3. 如果没有可用大厅且启用了 fallback-to-limbo,
#      玩家将被发送到 Limbo 服务器。
#   4. 如果没有任何可用项,则正常执行踢出操作。
fallback:

  # 启用当玩家被踢出时回退到其他大厅。
  # 如果您希望被踢出的玩家断开连接而不是移动到其他大厅,请设置为 false。
  fallback-to-lobby-enabled: true

# 启用在无可用心房时回退至临位。
  # 如果此项与 fallback-to-lobby(回退至心房)均为 false,被踢出的玩家将直接断开连接。
  fallback-to-limbo-enabled: true

  # 服务器回退控制
  # --------------------
  # 控制哪些服务器允许触发回退。
  #
  # 模式:allow(允许)
  #   仅下方列出的服务器加上所有心房可以
  #   触发回退。其他服务器在被踢时将断开
  #   玩家连接。
  #
  # 模式:deny(拒绝)
  #   下方列出的服务器永远不会触发回退。
  #   所有其他服务器(包括心房)将正常触发
  #   回退。
  servers-fallback-disabled:
    mode: deny
    servers:
      - creative

  # 踢出消息不回退关键词
  # ---------------------------------
  # 如果踢出消息包含以下任何关键词(不区分大小写),插件将不会尝试回退。
  # 这对于封禁、手动踢人或反作弊断开连接非常有用,在这些情况下移动玩家是不希望的。
  #
  # 常见关键词示例:
  #   banned      - 防止被封禁的玩家重新加入
  #   kicked by   - 防止工作人员踢人触发回退
  #   timed out   - 连接问题通常不需要回退
  kick-message-nofallback:
    - banned
    - kicked by
    - timed out
    - disconnect.spam
    - flying

# ============================================================
# 队列设置
# ============================================================
# 当所有心房都满员时,玩家会被放入队列。
# 这些设置控制他们如何以及何时被释放。
queue:

  # 分发尝试阈值
  # --------------------------
  # 心房在被视为准备好进行队列分发之前必须连续通过的健康检查次数。
  #
  # 这与 health-check-interval(健康检查间隔)配合工作:
  #   如果 health-check-interval = 30 且此值 = 2,
  #   新启动的心房必须在 60 秒内保持健康状态,
  #   排队的玩家才会被发送过去。
  #
  # 警告:将此值设置过低(例如 1)可能会将玩家发送到
  #          仍在预热的心房,导致加入失败。设置过高则会延迟恢复。
  #
  # 推荐值:1-3 用于快速恢复,3-5 用于稳定性。
  dispatch-attempt-threshold: 1

# ============================================================
# 常规设置
# ============================================================
settings:

  # 健康检查间隔(秒)
  # -------------------------------
  # 插件 ping 所有配置服务器的频率,以检查它们是否在线、满员或离线。
  #
  # 权衡:较低的值能更快检测崩溃,但会增加网络负载。较高的值更轻量,但反应较慢。
  #
  # 推荐值:小型网络设为 30,大型网络设为 60。
  health-check-interval: 30

  # 故障服务器重试间隔(秒)
  # --------------------------------------
  # 当服务器未能通过健康检查时,它会被标记为故障,
  # 直到经过此时间段并通过新的健康检查后,才不会被选择用于路由。
  #
  # 这防止了反复将玩家发送到崩溃的服务器。
  failed-server-retry-seconds: 60

  # 尝试过期时间(秒)
  # ------------------------
  # 插件记住它已经尝试将特定玩家发送到特定服务器的时长。
  #
  # 这防止了无限循环:如果玩家无法连接到 lobby1,插件在此
  # 持续时间内不会再次尝试 lobby1。过期后可以重试。
  attempt-expiry-seconds: 30

  # 队列分发间隔(毫秒)
  # --------------------------------------
  # 队列处理周期之间的最小时间间隔。
  #
  # 较低的值让玩家移动得更快,但会增加 CPU 使用率。
  # 插件仍会尊重服务器容量和就绪状态。
  queue-dispatch-interval: 2000

  # 队列等待消息间隔(毫秒)
  # -----------------------------------------------
  # 排队玩家接收等待消息的频率。
  # 设置为 0 以完全禁用等待消息。
  queue-waiting-interval: 5000

  # 调试模式
  # ----------
  # 启用时,插件会在控制台中打印详细的状态转换、
  # 路由决策和队列活动日志。
  #
  # 警告:这将产生大量输出。仅在故障排除时启用。生产环境请禁用。
  debug: false

  # 服务器玩家上限
  # --------------------
  # 定义每个服务器可容纳的最大玩家数量。
  # 这用于确定心房是否已满,并决定可以分发多少排队玩家。
  #
  # 每个服务器的有效值:
  #   -1  = 无限制。服务器永远不会标记为已满。
  #    0  = 自动检测。插件 ping 服务器以读取
  #         其 max-player 值(来自 server.properties 或
  #         服务器自身的配置)。
  #   >0  = 固定限制。当服务器的在线玩家数达到此数字时,
  #         服务器被标记为已满。
  #
  # 示例:拥有 50 个槽位的生存服应设置为
  #          50,以便插件知道何时已满。
  server-limits:
    lobby1: 100
    lobby2: 100
    lobby3: 100

# ============================================================
# 消息
# ============================================================
# 所有显示给玩家的消息均支持使用 '&' 符号的 Minecraft 颜色代码
# (例如 &a = 绿色,&c = 红色)。
#
# 可用占位符:
#   %server%   - 替换为目标服务器名称
#   %player%   - 替换为玩家名称
#   %position% - 玩家在队列中的位置
#   %total%    - 队列中玩家的总数
#
# 注意:占位符仅在引用它们的消息中生效。
#       使用不支持的占位符将在消息中保留原始文本。
messages:

  # 当玩家成功连接至心房时显示。
  connect-lobby: "&a正在连接您到心房 &e%server%&a..."

# 当玩家被发送至临时服务器时显示。
  connect-limbo: "&e正在将你连接至临时服务器 &7%server%&e..."

  # 当玩家被踢出并转移至备用大厅时显示。
  fallback-lobby: "&e你所在的服务器已不可用。正在将你转移至 &a%server%&e..."

  # 当玩家被踢出并转移至备用临时服务器时显示。
  fallback-limbo: "&c所有大厅已满或不可用。正在将你转移至临时服务器 &7%server%&c..."

  # -----------------------------------------------------------
  # 错误 / 状态消息
  # -----------------------------------------------------------
  no-lobby-available: "&c当前没有可用的大厅服务器。请稍后再试。"
  no-limbo-available: "&c当前没有可用的临时服务器。请稍后再试。"
  no-server-available: "&c当前没有可用的服务器。请稍后再试。"
  server-not-found: "&c未找到目标服务器。"
  already-connecting: "&c你正在被连接至某个服务器。"
  command-player-only: "&c此命令仅可由玩家使用。"
  already-in-lobby: "&c你已连接至大厅服务器。"

  # -----------------------------------------------------------
  # 队列消息
  # -----------------------------------------------------------
  # 这些消息由队列系统自动发送。
  queue-position: "&e你在队列中的位置为 &c%position% &e/ &c%total%&e。"
  queue-join: "&c所有大厅已满。你已被加入队列。"
  queue-waiting: "&e你正在队列中等待。当前位置:&c%position%&e / &c%total%&e。请稍候..."
  lobby-available: "&a现在有一个大厅可用!正在将你连接至 &e%server%&a..."

注意事项

  • 专为稳定性和长期使用而设计
  • 适用于小型和大型网络
  • 专注于可靠的路由和整洁的行为

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源