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+
安装
- 下载 LimboAPI 并将其放入你的 Velocity 插件文件夹中
- 下载 SimpleLimbo 并将其放入你的 Velocity 插件文件夹中
- 重启 Velocity
- 配置
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() 的身份验证插件的兼容功能:
- 在你的 limbo 配置中设置
fake-server-name为有效的 Velocity 服务器名称 - 启用 velocity-bridge 并匹配相应的别名
- 配置你的认证插件使用该服务器名称作为 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
鸣谢
你是这个资源的作者?登录后可认领此资源。
相似资源
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
ExyliaPlugins 的库。
通过对话框或铁砧界面帮助你的 Anthme
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧