- 版权类型
- 原创
- 插件中文名称
- 小雨登录-基岩UI
- 插件英文名称
- XYLogin-BedrockGUI
- 原帖地址
- #
- 支持的核心(服务端)
- Spigot
- Paper
- Purpur
- PufferFish
- Leaves
- 语言支持
- 中文(简体)
- 前置组件
- [必须]XYLogin https://www.minebbs.com/resources/xylogin.13974/
[必须]Floodgate https://geysermc.org/download?project=floodgate
[必须]Geyser https://geysermc.org/download?project=geyser
- 适配版本(Java)
- 1.21
- 1.20
- 1.19
- 1.18
- 1.17
- 1.16
- 1.15
- 1.14
- 1.13
- 1.12
XYLogin-BedrockGUI
为 XYLogin 提供基岩版表单登录界面
为 XYLogin 提供基岩版表单登录界面
插件简介
XYLogin-BedrockGUI 是一款专为 XYLogin 登录插件设计的基岩版扩展,通过 Floodgate 为基岩版玩家提供原生的表单界面(GUI)登录体验,告别传统的聊天栏输入方式!
核心特性
- 原生表单界面 - 使用基岩版原生表单系统,界面美观易用
- 自动识别 - 自动检测基岩版玩家,无需手动配置
- 双模式支持 - 智能区分注册和登录表单
- 密码二次确认 - 注册时需要确认密码,防止输入错误
- 密码长度验证 - 可自定义密码长度限制,提高安全性
- 异步处理 - 完全异步操作,不影响服务器性能
- 会话检测 - 智能检测玩家登录状态,避免重复弹窗
- 调试模式 - 详细的日志输出,方便排查问题
- 高度可配置 - 延迟时间、提示信息、密码规则等均可自定义
依赖要求
功能展示
登录流程:
代码:
1. 基岩版玩家进入服务器
2. 插件自动检测基岩版身份
3. 延迟指定时间后弹出表单
4. 已注册玩家:显示登录表单(输入密码)
5. 未注册玩家:显示注册表单(输入密码 + 确认密码)
6. 验证成功后自动完成登录/注册
安全特性:
- 密码长度验证(默认 4-32 位)
- 注册时密码二次确认
- 会话状态检测,防止重复认证
- 关闭表单可踢出玩家(可配置)
- 异步密码验证,防止阻塞主线程
YAML:
# XYLogin-BedrockGui 配置文件
# 发送表单的延迟时间(秒)
# 建议设置为 1-5 秒,给玩家足够的加载时间
delay-time: 3
# 调试模式,开启后会在控制台输出详细日志
debug: false
# 当玩家关闭表单时是否踢出玩家
# true: 关闭表单后踢出玩家
# false: 允许玩家关闭表单而不被踢出
close-kick: true
# 密码长度限制
min-password-length: 3
max-password-length: 32
# 消息配置
# 支持 Minecraft 颜色代码,使用 & 符号
# 颜色代码:&0-&9, &a-&f, &k-&r
messages:
# 登录表单
login-title: "&6欢迎回来!"
login-password-title: "密码"
login-password-placeholder: "请输入您的密码"
# 注册表单
register-title: "&a欢迎注册!"
register-password-title: "密码"
register-password-placeholder: "请输入密码(4-32个字符)"
register-confirm-password-title: "确认密码"
register-confirm-password-placeholder: "请再次输入密码"
# 错误消息
invalid-password-format: "&c密码格式无效!密码长度必须在4-32个字符之间。"
passwords-not-match: "&c两次输入的密码不匹配!"
wrong-password: "&c密码错误,请重新尝试!"
authentication-error: "&c认证过程中发生错误,请重新连接!"
login-error: "&c登录失败,请重新尝试!"
registration-error: "&c注册过程中发生错误,请重新连接!"
registration-failed: "&c注册失败,请重新尝试!"
already-registered: "&c您已经注册过了!"
form-closed: "&c您必须完成认证才能游戏!"
invalid-form-response: "&c表单响应无效,请重新连接!"
步骤 1:安装依赖
代码:
1. 确保已安装 XYLogin 插件
2. 安装 Geyser 和 Floodgate(用于基岩版互通)
3. 重启服务器确保依赖加载正常
步骤 2:安装本插件
代码:
1. 将 XYLogin-BedrockGUI.jar 放入 plugins 文件夹
2. 重启服务器(不要用 /reload)
3. 检查插件是否成功加载
步骤 3:配置插件
代码:
1. 打开 plugins/XYLogin-BedrockGUI/config.yml
2. 根据需要调整延迟时间、密码规则等
3. 自定义提示消息(可选)
4. 使用 /reload confirm 重载配置(或重启服务器)
步骤 4:测试
代码:
1. 使用基岩版客户端连接服务器
2. 观察是否正常弹出登录/注册表单
3. 测试登录和注册功能
4. 检查控制台是否有错误信息
常见问题
Q1: 表单没有弹出怎么办?
Q2: 表单弹出后立即消失?
Q3: 密码验证失败但密码正确?
Q4: 插件与 XYLogin 不兼容?
Q5: 如何在 Folia 上使用?
Q6: 关闭表单后能不能不踢出玩家?
代码:
A: 检查以下几点:
1. 确认 Floodgate 正常工作
2. 检查是否为基岩版玩家(Java 版不会弹出)
3. 查看控制台是否有错误信息
4. 尝试增加 delay-time 的值
5. 开启 debug 模式查看详细日志
Q2: 表单弹出后立即消失?
代码:
A: 可能原因:
1. 玩家已经有活跃会话
2. 网络延迟导致的时序问题
3. 尝试增加延迟时间到 5-10 秒
Q3: 密码验证失败但密码正确?
代码:
A: 检查:
1. 密码是否包含空格(会被自动去除)
2. 密码长度是否符合配置要求
3. XYLogin 的密码加密方式
Q4: 插件与 XYLogin 不兼容?
代码:
A: 确保:
1. XYLogin 版本为最新版本
2. 检查 XYLogin API 是否可用
3. 查看启动日志中的 API 初始化信息
Q5: 如何在 Folia 上使用?
代码:
A:
1. 确保使用支持 Folia 的 XYLogin 版本
2. 使用支持 Folia 的 Floodgate 版本
3. 本插件已完美支持 Folia,无需额外配置
Q6: 关闭表单后能不能不踢出玩家?
代码:
A:
1. 将 close-kick 设置为 false
2. 但不推荐这样做,可能导致安全问题
3. 未认证玩家可能绕过登录系统
使用建议
- 延迟时间设置:建议设置 3-5 秒,给玩家足够的加载时间
- 密码长度:最小长度建议不少于 4 位,最大长度不超过 32 位
- 调试模式:出现问题时开启 debug,查看详细日志
- 表单关闭:建议保持 close-kick 为 true,确保安全性
- 消息自定义:根据服务器风格自定义提示消息
- 定期测试:更新插件后务必测试基岩版登录功能
安全特性
- 密码验证:前后端双重验证,防止恶意输入
- 会话检测:避免已登录玩家重复认证
- 异步处理:所有敏感操作均在异步线程执行
- 任务管理:自动清理过期任务,防止内存泄漏
- 错误处理:完善的异常捕获和错误提示
- 状态同步:与 XYLogin 主插件状态实时同步
技术特性
代码架构:
- 完全异步的认证流程(CompletableFuture)
- 线程安全的任务跟踪(ConcurrentHashMap)
- 优雅的生命周期管理
- 完善的错误处理机制
- 高效的内存管理
兼容性:
- Floodgate API 集成
- Cumulus Forms API 支持
- XYLogin API 深度集成
- Paper 异步调度优化
让基岩版玩家也能享受便捷的 GUI 登录体验!
感谢您选择 XYLogin-BedrockGUI
感谢您选择 XYLogin-BedrockGUI