资源图标

原创 闭源 XYLogin-BedrockGUI —— 为XYLogin添加基岩版登录 1.0.0

完成注册/登录后下载
版权类型
原创
插件中文名称
小雨登录-基岩UI
插件英文名称
XYLogin-BedrockGUI
原帖地址
#
支持的核心(服务端)
  1. Spigot
  2. Paper
  3. Purpur
  4. PufferFish
  5. 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. 1.21
  2. 1.20
  3. 1.19
  4. 1.18
  5. 1.17
  6. 1.16
  7. 1.15
  8. 1.14
  9. 1.13
  10. 1.12
XYLogin-BedrockGUI

为 XYLogin 提供基岩版表单登录界面​



插件简介

XYLogin-BedrockGUI 是一款专为 XYLogin 登录插件设计的基岩版扩展,通过 Floodgate 为基岩版玩家提供原生的表单界面(GUI)登录体验,告别传统的聊天栏输入方式!



核心特性

  • 原生表单界面 - 使用基岩版原生表单系统,界面美观易用
  • 自动识别 - 自动检测基岩版玩家,无需手动配置
  • 双模式支持 - 智能区分注册和登录表单
  • 密码二次确认 - 注册时需要确认密码,防止输入错误
  • 密码长度验证 - 可自定义密码长度限制,提高安全性
  • 异步处理 - 完全异步操作,不影响服务器性能
  • 会话检测 - 智能检测玩家登录状态,避免重复弹窗
  • 调试模式 - 详细的日志输出,方便排查问题
  • 高度可配置 - 延迟时间、提示信息、密码规则等均可自定义



依赖要求

Minecraft 版本:1.16+ (建议 1.19.4+)

必需插件:
• XYLogin - 登录系统核心
• Floodgate - 基岩版互通支持
• Geyser - 跨平台连接(通常与 Floodgate 配套使用)

服务端支持:
• Paper / Spigot / Purpur

API 依赖:
• Cumulus API(Floodgate 表单库)
• XYLogin API



功能展示

登录流程:
代码:
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: 表单没有弹出怎么办?
代码:
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. 未认证玩家可能绕过登录系统



使用建议

  1. 延迟时间设置:建议设置 3-5 秒,给玩家足够的加载时间
  2. 密码长度:最小长度建议不少于 4 位,最大长度不超过 32 位
  3. 调试模式:出现问题时开启 debug,查看详细日志
  4. 表单关闭:建议保持 close-kick 为 true,确保安全性
  5. 消息自定义:根据服务器风格自定义提示消息
  6. 定期测试:更新插件后务必测试基岩版登录功能



安全特性

  • 密码验证:前后端双重验证,防止恶意输入
  • 会话检测:避免已登录玩家重复认证
  • 异步处理:所有敏感操作均在异步线程执行
  • 任务管理:自动清理过期任务,防止内存泄漏
  • 错误处理:完善的异常捕获和错误提示
  • 状态同步:与 XYLogin 主插件状态实时同步



技术特性

代码架构:
  • 完全异步的认证流程(CompletableFuture)
  • 线程安全的任务跟踪(ConcurrentHashMap)
  • 优雅的生命周期管理
  • 完善的错误处理机制
  • 高效的内存管理

兼容性:
  • Floodgate API 集成
  • Cumulus Forms API 支持
  • XYLogin API 深度集成
  • Paper 异步调度优化

让基岩版玩家也能享受便捷的 GUI 登录体验!
感谢您选择 XYLogin-BedrockGUI
​
后退
顶部 底部