RealLogin
支持 PIN 码与 GUI 交互的登录插件
一款轻量级登录插件,玩家需在数字键盘上输入 PIN 码,而非在聊天栏中输入密码。
Discord | 源代码 | 报告 Bug
RealLogin 是什么?
RealLogin 会在玩家加入时要求输入 PIN 码。新玩家在图形界面(GUI)的数字键盘上设置 PIN 码,老玩家点击 PIN 码进行登录。在登录完成前,玩家无法移动、聊天或使用命令;关闭数字键盘后,它会再次打开。
功能特性
- PIN 码键盘 GUI:用于注册和登录,支持使用数字头像或纯色面板
- PIN 码哈希存储:使用加盐 PBKDF2 算法哈希存储,绝不以明文形式保存
- 会话机制:登录后不久重新加入的玩家无需再次输入 PIN 码
- PIN 重置:玩家可以自行重置 PIN 码,管理员可以删除任何玩家的 PIN 码
- 管理员绕过:允许在不输入 PIN 码的情况下让等待中的玩家进入服务器
- 登录历史:通过
/rl info 显示每次加入的日期和 IP 地址
- 传送点设置:可设置登录前和登录后的传送位置
- 隐藏背包:可选功能,在玩家登录前隐藏其物品栏
- BungeeCord 支持:登录后可将玩家传送到大厅服务器(可选)
- 1.21.6+ 版本中,提供设置编辑器以及原生对话框确认。数字键盘始终保持为物品栏形式,因此输入 PIN 码时不会在文本框中显示明文
- 支持 SQLite(默认)或 MySQL 存储
- 支持 RealPermissions 权限插件
- 完全可配置且支持翻译的 YAML 配置文件
登录前状态
在玩家输入 PIN 码之前:
- 他们无法移动、交互、丢弃物品、聊天或执行命令。
- 当数字键盘打开时,他们不会受到伤害。
- 关闭数字键盘会使其重新打开。按门铃按钮则会将其踢出服务器。
- 如果启用了
Hide-Inventories(隐藏背包),他们的背包会被清空,并在登录或离开时恢复。
会话机制
玩家登录后,会获得一个持续 Max-Session-Time 秒(默认为 120 秒)的会话时间。如果在超时前重新加入,他们将跳过数字键盘步骤。倒计时从登录那一刻开始,而非从退出服务器时开始。
会话数据保存在内存中,因此服务器重启会导致会话失效。执行 /rl logout 会结束当前会话并再次显示数字键盘。将 Max-Session-Time 设置为 0 可禁用会话功能。
从旧版本升级
旧版本在 players.yml 中保存的 PIN 码会在下次玩家加入时自动迁移至数据库并进行哈希处理。
截图



快速上手
- 加入服务器。注册键盘将会打开。
- 点击你 PIN 码的数字(至少 2 位,且不超过
Max-Pin-Length,默认为 4)。若要删除最后一位数字,可点击任意数字的删除键或右键点击绿宝石。
- 点击绿宝石以确认。
- 下次加入时,输入你的 PIN 码即可。一旦正确,你将立即登录成功。使用熔岩桶可以删除最后一位数字。
- (可选)站在玩家等待的位置并运行
/rl settplogin,然后站在他们登录后应前往的位置并运行 /rl settpafterlogin。
命令
基础命令:/reallogin、/rl
| 命令 |
描述 |
权限 |
/rl |
显示插件版本和构建信息 |
无 |
/rl logout |
结束当前会话并要求重新输入 PIN 码 |
无 |
/rl resetpin |
删除你的 PIN 码以便立即选择新的 PIN 码 |
reallogin.resetpin |
/rl reload |
重载配置文件 |
reallogin.admin |
/rl settings |
打开设置编辑器(需要 1.21.6+) |
reallogin.admin |
/rl info <player> |
显示玩家的区域设置、会话状态、登录次数、最近登录记录及最后 10 个 IP 地址 |
reallogin.admin |
/rl bypass <player> |
为正在键盘前等待的在线玩家执行登录操作 |
reallogin.admin |
/rl deletepin <player> |
删除玩家的 PIN 码;该玩家下次加入时将重新注册新 PIN 码 |
reallogin.admin |
/rl settplogin / /rl settpafterlogin |
将登录位置或登录后位置设置为当前站立的位置 |
reallogin.admin |
/rl tplogin / /rl tpafterlogin |
传送至上述位置 |
reallogin.admin |
/rl deltplogin / /rl deltpafterlogin |
删除上述位置 |
reallogin.admin |
权限
| 权限 |
描述 |
reallogin.admin |
所有管理员命令 |
reallogin.resetpin |
可以使用 /rl resetpin 重置自己的 PIN 码 |
要求
安装
- 将 jar 文件放入
plugins 文件夹。
- 重启服务器。
- 若需使用 MySQL,请在
plugins/RealLogin/sql.yml 中设置连接详情并重启。
- 编辑
plugins/RealLogin/config.yml 并运行 /rl reload,或在 1.21.6+ 版本中使用 /rl settings。
需要帮助或发现 Bug?
请勿在评论区提交 Bug 报告。请通过以下方式联系我们:
Discord | GitHub Issues
本插件使用 bStats 收集匿名使用统计数据。你可以在 plugins/bStats/config.yml 中关闭此功能。
RealLogin
Login plugin with PIN & GUI interaction
A lightweight login plugin where players type a PIN on a keypad instead of a password in chat.
Discord | Source Code | Report a Bug
What is RealLogin?
RealLogin asks every player for a PIN when they join. New players pick a PIN on a keypad GUI, and returning players click their PIN in to log in. Until they do, they can't move, chat or use commands, and closing the keypad just opens it again.
Features
- PIN keypad GUI for registering and logging in, with number heads or plain panes
- PINs are stored hashed (salted PBKDF2), never as plain text
- Sessions: a player who rejoins shortly after logging in doesn't need to type the PIN again
- PIN reset: players can reset their own PIN, and admins can delete anyone's
- Admin bypass to let a waiting player in without their PIN
- Login history: the date and IP of each join, shown with
/rl info
- Login and after-login locations to teleport players to
- Hide inventories until the player logs in (optional)
- BungeeCord: send players to a lobby server after they log in (optional)
- On 1.21.6+, a settings editor and confirmations in native dialogs. The keypad always stays an inventory, so a PIN is never shown in a text box as it's typed
- SQLite (default) or MySQL storage
- RealPermissions support
- Fully configurable and translatable YAML config
Before Logging In
While a player hasn't entered their PIN:
- They can't move, interact, drop items, chat or run commands.
- They can't be hurt while the keypad is open.
- Closing the keypad opens it again. The door button kicks them from the server instead.
- If
Hide-Inventories is on, their inventory is emptied and given back when they log in or leave.
Sessions
After a player logs in, they have a session for Max-Session-Time seconds (120 by default). If they rejoin before it runs out, they skip the keypad. The countdown starts when they log in, not when they leave.
Sessions are kept in memory, so a restart ends them. /rl logout ends your own session and shows the keypad again. Set Max-Session-Time to 0 to turn sessions off.
Updating from an older version
PINs saved by older versions in players.yml are moved to the database, hashed, the next time each player joins.
Photos



Getting Started
- Join the server. The register keypad opens.
- Click the numbers of your PIN (at least 2 digits, and no more than
Max-Pin-Length, 4 by default). To remove the last digit, press the drop key on any number or right-click the emerald.
- Click the emerald to confirm.
- Next time you join, click your PIN in. You're logged in as soon as it's right. The lava bucket removes the last digit.
- (Optional) Stand where players should wait and run
/rl settplogin, then stand where they should go after logging in and run /rl settpafterlogin.
Commands
Base commands: /reallogin, /rl
| Command |
Description |
Permission |
/rl |
Shows the plugin version and build |
None |
/rl logout |
Ends your session and asks for your PIN again |
None |
/rl resetpin |
Deletes your PIN so you can choose a new one straight away |
reallogin.resetpin |
/rl reload |
Reloads the config |
reallogin.admin |
/rl settings |
Opens the settings editor (needs 1.21.6+) |
reallogin.admin |
/rl info <player> |
Shows a player's locale, session, login count, latest logins and last 10 IPs |
reallogin.admin |
/rl bypass <player> |
Logs in an online player who is waiting at the keypad |
reallogin.admin |
/rl deletepin <player> |
Deletes a player's PIN; they register a new one when they next join |
reallogin.admin |
/rl settplogin / /rl settpafterlogin |
Sets the login or after-login location to where you stand |
reallogin.admin |
/rl tplogin / /rl tpafterlogin |
Teleports you to that location |
reallogin.admin |
/rl deltplogin / /rl deltpafterlogin |
Deletes that location |
reallogin.admin |
Permissions
| Permission |
Description |
reallogin.admin |
All admin commands |
reallogin.resetpin |
Can reset their own PIN with /rl resetpin |
Requirements
Installation
- Put the jar in your
plugins folder.
- Restart the server.
- To use MySQL, set the connection details in
plugins/RealLogin/sql.yml and restart.
- Edit
plugins/RealLogin/config.yml and run /rl reload, or use /rl settings on 1.21.6+.
Need help or found a bug?
Please don't use the comments for bug reports. Get in touch through:
Discord | GitHub Issues
This plugin uses bStats to collect anonymous usage statistics. You can turn this off in plugins/bStats/config.yml.
评论 0
登录后参与评分
还没有评论,来抢沙发吧