RptLogin —— 离线服进服密码验证，双登录界面（原生弹窗 / 铁砧输入） [1.21 ~ 26.2]

原创 工具 RptLogin —— 离线服进服密码验证，双登录界面（原生弹窗 / 铁砧输入） [1.21 ~ 26.2] 1.0.0

完成注册/登录后下载
概述 更新 （1） 历史版本 讨论区
版权类型
原创
插件中文名称
RPT登录
插件英文名称
RptLogin
原帖地址
#
支持的核心（服务端）
  1. Paper
  2. Folia
语言支持
中文（简体）
适配版本（Java）
  1. 26.x
  2. 1.21

关于这个插件​

RptLogin 给离线模式服务器（online-mode=false）补上「账号 = 密码」这一层。
离线服里任何人都能用你的游戏名直接进服。RptLogin 让每个账号在第一次进服时设置本地密码，之后每次进服都必须先验证身份，验证通过前无法移动、交互、聊天或使用指令 —— 冒名者即使顶着你的名字进来，也只是一个动不了的雕像。
全插件零外部依赖：不连数据库、不发 HTTP、不需要面板或机器人，数据就是一个本地文件。

功能说明​

1. 密码验证流程​

环节行为
第一次进服提示 /register <密码> <确认密码>（6-32 位，两次需一致）
之后每次进服提示 /login <密码>
验证完成前完全冻结：不能移动 / 交互 / 放置 / 破坏 / 丢弃 / 拾取 / 开背包 / 聊天 / 使用其它指令
超时默认 60 秒未通过验证则自动踢出

2. 两套登录界面，自动选择​

插件启动时自动探测服务端核心能力，不需要手动配置，控制台会明确打印走的是哪条路径：

登录界面触发条件玩家体验
进服前原生弹窗服务端核心带 Dialog API（Paper / Folia 1.21.11 及 26.x），且玩家客户端 ≥ 1.21.11还停在「连接服务器 / 配置」界面时就弹出登录或注册窗口，输入密码通过后才真正进入服务器
进服后铁砧界面其它情况（1.21.x 核心，或玩家客户端低于 1.21.11）进服后立刻弹出不可关闭的铁砧界面，在命名框输入密码，点击右侧命名牌提交
  • 密码错误 / 两次不一致 / 长度不足时，会带红色错误提示自动重新弹出，可无限重试。
  • 铁砧界面被 ESC 关闭会自动重开；未登录期间不会因为死亡卡住界面（未登录免伤免死，万一死亡也会保住背包、立即复活并重新开窗）。
  • 两条路径的文案、超时、冻结与踢出规则完全一致，可在 config.yml 里统一修改。

3. 同 IP 免登录会话（AuthMe Session Login 同款）​

  • 登录成功后，同一 IP + 同一游戏名在有效期（默认 10 分钟）内再次进服可免登录。
  • 换 IP、或同一 IP 下的其它账号都无法借用这个会话，避免网吧 / 校园网环境下被冒名。
  • 会话只存在内存里，服务端重启即失效；管理员重置密码时同步清除。

4. 每日首次登录提醒​

  • 玩家当天第一次完成登录时收到提醒（默认提示可以改密码）。
  • 默认强制重新登录：当天首次进服即使命中免登录会话，也必须输入一次密码。
  • 每日记录持久化保存，服务端重启不丢。

5. 安全实现​

  • 密码使用 PBKDF2WithHmacSHA256 + 随机盐 + 120000 次迭代哈希后存储于 plugins/RptLogin/passwords.yml，明文不落盘。
  • 插件日志不会打印密码，调试模式下也只看得到长度。
  • 全插件不含任何网络通信、遥测、后门逻辑，未做任何代码混淆，可自行反编译审阅。

支持版本与环境​

项目说明
Minecraft 版本1.21 ~ 26.2（实测通过：1.21 / 1.21.4 / 1.21.11 / 26.1.2 / 26.2）
服务端核心Paper、Folia（已声明 folia-supported: true），1.21.x 与 26.x 均可
Java 运行环境Java 21 及以上
不支持1.20.x 及以下（插件 api-version 为 1.21，低版本核心会拒绝加载）

目标用户​

  • 离线模式服务器的服主 —— 让玩家账号有密码保护，避免被冒名上号拆家、洗背包。
  • 不想引入大型登录插件、也不想额外维护 MySQL 的服主 —— 本插件纯本地文件存储、开箱即用。
  • 正在用 Folia 核心的服主 —— 市面上不少登录插件不支持 Folia，本插件从设计之初就双端兼容。
  • 需要给管理员号 / 测试号放行的运维 —— bypass-names 配置项一键跳过验证。

是否付费​

完全免费。 不需要授权、不需要联网校验，下载即用。

获取作者帮助​

途径内容
交流群QQ 群 1124248111
作者 QQ2221899680
游戏内输入 /rptl help 查看全部指令与说明

使用教程​

安装​

  1. 将 RptLogin-1.0.0.jar 放入服务端 plugins/ 目录。
  2. 重启服务端（首次启动会生成 plugins/RptLogin/config.yml）。
  3. 启动完成后确认控制台出现 RptLogin 已启用 | ... 一行，其中会标注当前走的是「原生弹窗」还是「铁砧界面」。

指令列表​

指令权限说明
/rptl help默认查看指令帮助
/rptl reloadrptl.admin热重载配置文件
/rptl info [玩家名]rptl.use查看密码注册状态（查他人需管理员）
/rptl reset <玩家名> [新密码]rptl.admin重置密码：不带密码=清除（下次进服重新注册）；带密码=直接设为新密码
/rptl debug [on|off]rptl.admin开关调试日志
/login <密码>默认密码登录（别名 /l）
/register <密码> <确认密码>默认注册或修改密码（别名 /reg、/r）
主指令为 /rptl，/rptlogin 保留为别名。
点击展开...

权限节点​

权限默认值说明
rptl.use所有玩家查看自己的密码状态
rptl.admin仅 OP重载配置、重置密码、调试日志

主要配置项（config.yml）​

配置项默认值说明
enforcetrue登录验证总开关
password.min-length / max-length6 / 32密码长度限制
password.login-timeout-seconds60冻结超时（超时踢出）
dialog.enabledtrue是否启用进服前原生弹窗（核心/客户端不支持时自动改用铁砧界面）
dialog.timeout-actionjoin弹窗超时策略：join 放行进服走后续流程 / kick 直接断开
gui.enabledtrue是否启用进服后铁砧界面
session-login.enabledtrue同 IP 免登录开关
session-login.timeout-minutes10免登录有效时长（分钟）
notify.daily-force-logintrue每天首次登录是否强制重新验证
bypass-names[]跳过验证的玩家名（小写），用于管理员号 / 测试号
debugfalse调试日志

所有界面文案（标题、按钮、错误提示）均可直接修改，支持 § 颜色代码。

常见问题​

  • 玩家说进服后动不了？ 这是正常的冻结状态，需要输入 /login <密码> 或 /register <密码> <确认密码>，超时会自动踢出。
  • 玩家忘密码？ 管理员执行 /rptl reset <玩家名> 清除密码，玩家下次进服重新注册。
  • 为什么没有进服前弹窗？ 请查看启动日志的判定行：核心是 1.21.x（无 Dialog API）或客户端低于 1.21.11 时，本来就会走「进服后铁砧界面」，属于预期行为。
  • 铁砧界面没弹出来 / 点了没反应？ 把 debug 改为 true 后复现，日志会打印进服判定、开窗结果、界面被点击的槽位等完整信息（不会打印密码）。

声明​

  • 本插件为原创作品，保留所有权利，默认不允许转载与整合。如需转载或整合到服务端整合包，请先通过上方交流群或作者 QQ 联系获取授权。
  • 本插件未使用任何混淆手段，字符串、方法体、主类名均未混淆，欢迎安全审查。
  • 本插件不含任何后门、病毒或远程控制代码，所有数据仅保存在服务器本地 plugins/RptLogin/ 目录中。
PixelCloud 一键开服
作者
RPT
下载
33
查看
312
首次发布
最后更新

评分

0.00 星 0 次评分
参与讨论

RPT 的其他资源

分享资源

最新更新

  1. 1.1.0版本

    新增防顶号，A 在线时 B 连不进来。
查看更多…
旋律云高性能云服务器
后退
顶部 底部