SimpleLimbo

插件

· 作者 ItsAzni

一个基于 LimboAPI 的轻量级虚拟 limbo 服务器插件,适用于 Velocity 代理。

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

需要前置:LimboAPI

最新 1.0.0 · 1.21.11 · Velocity

一键开服(送7天)

SimpleLimbo

一个基于 LimboAPI 的轻量级 Velocity 代理虚拟 limbo 服务端插件。

功能特性

  • 多个 Limbo 服务器 - 创建具有不同配置的无限个虚拟 limbo 实例
  • 认证插件支持 - 兼容 JPremium 及其他身份验证插件
  • 故障转移系统 (Fallback System) - 当后端服务器宕机时自动拦截玩家
  • AFK 检测 - 将空闲玩家移动至专用的 limbo 服务器
  • 自定义世界 - 加载 Schematic 文件作为 limbo 环境
  • 丰富的显示效果 - 支持标题、动作栏、Boss 栏和聊天消息
  • 自动重连 - 自动尝试让玩家重新连接回后端服务器
  • Velocity 桥接 - 注册重定向到 limbos 的虚拟服务器

要求

  • Velocity 3.3.0+
  • LimboAPI 1.1.27+
  • Java 17+

安装

  1. 下载 LimboAPI 并将其放入你的 Velocity 插件文件夹中
  2. 下载 SimpleLimbo 并将其放入你的 Velocity 插件文件夹中
  3. 重启 Velocity
  4. 配置 plugins/simplelimbo/config.yml

配置

基础 Limbo 设置

limbos:
  auth:
    enabled: true
    dimension: "OVERWORLD"
    gamemode: "ADVENTURE"
    world-time: 6000

    spawn:
      x: 0.0
      y: 100.0
      z: 0.0
      yaw: 0.0
      pitch: 0.0

    settings:
      read-timeout: 30000
      should-rejoin: true
      should-respawn: false
      disable-falling: true
      disable-falling-delay-ms: 5000

    commands:
      - "login"
      - "register"

    display:
      on-join:
        chat: "&eUse /login or /register"
        title:
          enabled: true
          title: "&eAuthentication"
          subtitle: "&7Please authenticate"

Velocity 桥接(认证插件兼容性)

对于期望玩家位于命名服务器上的插件(如 JPremium):

velocity-bridge:
  enabled: true
  register-aliases: true
  aliases:
    auth: "auth" # 将服务器名称 "auth" 映射到 limbo "auth"

然后在你的认证插件配置中,将 limbo 服务器设置为 auth。

防掉落调整

  • disable-falling 防止玩家在加入后掉落(Y 轴锁定模式)。
  • disable-falling-delay-ms 控制防掉落机制启动的时间。
  • 如果玩家加入缓慢或出现“正在加载地形”的延迟,请增加 disable-falling-delay-ms(例如:1200、1500、2000)。

设置说明

  • should-rejoin: true 保持 LimboAPI 的重连流程启用(推荐以保持稳定性)。
  • should-respawn: false 避免在加入时发送额外的重生数据包。

故障转移系统

当后端服务器崩溃时自动拦截玩家:

auto-triggers:
  fallback:
    enabled: true
    limbo: "fallback"
    kick-patterns:
      - ".*server.*closed.*"
      - ".*timed out.*"
    message: "&cServer offline. Moved to fallback."

AFK 系统

将空闲玩家移动至专用的 limbo:

auto-triggers:
  afk:
    enabled: true
    limbo: "afk"
    idle-time: 300
    check-interval: 30
    exempt-permission: "simplelimbo.afk.exempt"

自定义世界文件

加载 Schematic 文件以构建 limbo 环境:

limbos:
  lobby:
    world-file:
      enabled: true
      type: "SCHEMATIC"
      path: "plugins/simplelimbo/worlds/lobby.schem"
      offset:
        x: 0
        y: 64
        z: 0
      light-level: 15

命令

命令 权限 描述
/simplelimbo send <player> <limbo> simplelimbo.admin 将玩家发送至某个 limbo
/simplelimbo list simplelimbo.admin 列出所有 limbo 服务器
/simplelimbo reload simplelimbo.admin 重载配置文件

权限

权限 描述
simplelimbo.admin 访问管理命令
simplelimbo.afk.exempt 豁免 AFK 触发条件

认证插件兼容性

SimpleLimbo 包含针对调用 player.getCurrentServer() 的身份验证插件的兼容功能:

  1. 在你的 limbo 配置中设置 fake-server-name 为有效的 Velocity 服务器名称
  2. 启用 velocity-bridge 并匹配相应的别名
  3. 配置你的认证插件使用该服务器名称作为 limbo 服务器

JPremium 示例:

# SimpleLimbo config.yml
velocity-bridge:
  aliases:
    auth: "auth"

limbos:
  auth:
    fake-server-name: "auth"
    # ... 其他设置
# JPremium configuration.yml
limboServerNames: [auth]
mainServerNames: [lobby]

从源代码构建

git clone https://github.com/ItsAzni/SimpleLimbo.git
cd SimpleLimbo
./gradlew shadowJar

编译后的 JAR 文件将位于 build/libs/ 中。

许可证

MIT License

鸣谢

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源