? SleepyAuth
安心入睡,服务器安全无忧。
专为 Paper 服务器打造的先进认证与账户保护插件
? 简介
SleepyAuth 是一款面向 Paper 服务器的认证与账户保护插件。它要求玩家注册或登录,限制未认证玩家的访问,并提供账户安全、会话管理、管理工具、维护模式、日志记录以及可选的 Discord/Floodgate 功能。
离线模式(盗版)服务器没有 Mojang 身份验证——任何人都可以以任何用户名加入。SleepyAuth 通过将用户名锁定给真实所有者、保护玩家进度并增加多层安全性来解决这一问题。
兼容性: Paper 1.20.x 及更高版本(Java 17 字节码;Paper 1.21+ 需要 Java 21)
可选集成: Floodgate 用于基岩版检测 • Discord Webhook 用于事件通知
✨ 特性
? 注册与登录
玩家通过 /register <password> <password> [true|false] 进行注册,并通过 /login <password> 登录。密码经过哈希处理——默认为 PBKDF2,支持加盐 SHA256。绝不存储或记录明文密码。
?️ 登录保护
未认证的玩家会收到提示和操作栏提醒。在认证成功之前,禁止发送加入/离开公告。可配置的限制包括阻止移动、聊天、命令、交互、伤害、饥饿、拾取/丢弃物品以及访问背包。
? 虚空世界保护
可选生成的虚空世界将未认证玩家隔离在一个小型的保护平台上。防止基地被偷、坐标泄露、破坏行为以及玩家追踪。
⏱️ 保护倒计时
登录后,玩家头顶会出现一个可配置的 TextDisplay 倒计时,并在倒计时结束前阻止受到伤害。此功能可仅应用于首次注册。
? 记住我与会话
可选的“记住我”令牌提供更长的自动登录时间(可配置有效期,可选强制同一 IP)。短寿命会话可在断开连接后恢复登录状态。登出或更改密码时清除。
? 基岩版 / Floodgate 支持
可选的 Floodgate 检测可识别基岩版玩家。默认情况下,已验证的基岩版玩家跳过认证;强制认证可要求他们注册或登录。
? 小号检测
跟踪共享同一 IP 的已注册账户。自动创建小号记录(不含密码哈希),并可向管理员在游戏内或通过 Discord 发出警报。
? 账户安全
每个账户的暴力破解锁定、每个 IP 的失败登录速率限制、每个 IP 的账户数量限制(含绕过权限)以及同名不同 IP 的连接检查。锁定状态保存在 bans.yml 中,重启后依然有效。
?️ 管理工具
完整的管理命令套件:/sa reload、/forcelogin、/forcelogout、/resetpassword、/unban、/sessions、/info、/stats、/void 等。Java 管理员默认必须通过认证。
? 维护模式
/maintenance on [reason] [| estimated time] 宣布踢人倒计时,拒绝新的非工作人员连接,并踢出当前非工作人员玩家。除非另有配置,否则操作员不受影响。
? Discord Webhook 日志记录
为首次注册、小号检测、管理员强制登录、私聊(/msg、/tell、/whisper)、告示牌放置/编辑以及维护开始/结束提供彩色嵌入消息。
? 出生点系统
在登录前将玩家传送至出生点,认证成功后将其返回至最后保存或配置的位置。
? 命令
? 玩家命令
| 命令 |
描述 |
/register <password> <password> [true|false] |
创建账户(可选切换“记住我”) |
/login <password> |
登录你的账户 |
/logout |
登出并清除“记住我”令牌 |
/changepassword <old> <new> |
更改密码 |
/unregister <password> |
删除你的账户 |
/rememberme <true|false> |
切换“记住我”功能 |
?️ 管理员命令
| 命令 |
描述 |
/sa help |
显示管理员命令列表 |
/sa reload |
重新加载配置和消息文件 |
/sa forcelogin <player> |
对在线玩家执行认证 |
/sa forcelogout <player> |
将玩家恢复到未认证状态 |
/sa resetpassword <player> <new> |
重置玩家密码 |
/sa unban <player|ip> |
解除锁定或速率限制状态 |
/sa sessions |
列出活动的“记住我”会话 |
/sa info <player> |
显示玩家账户详情 |
/sa stats |
显示插件统计数据 |
/sa void |
在虚空世界和出生点之间切换 |
/maintenance on/off [reason] [| time] |
切换维护模式 |
? 权限
| 权限 |
描述 |
默认值 |
sleepyauth.admin |
所有管理员权限 |
OP |
sleepyauth.reload |
/sa reload |
OP |
sleepyauth.forcelogin |
/sa forcelogin |
OP |
sleepyauth.forcelogout |
/sa forcelogout |
OP |
sleepyauth.resetpassword |
/sa resetpassword |
OP |
sleepyauth.unban |
/sa unban |
OP |
sleepyauth.sessions |
/sa sessions |
OP |
sleepyauth.info |
/sa info |
OP |
sleepyauth.stats |
/sa stats |
OP |
sleepyauth.void |
/sa void |
OP |
sleepyauth.maintenance |
/maintenance |
OP |
sleepyauth.bypass |
Java 管理员登录绕过 |
— |
sleepyauth.bypass.iplimit |
绕过 IP 账号限制 |
OP |
? 更新日志
V4.0.0 — 稳定认证与安全更新
✨ 新增
- 未认证玩家的虚空世界保护
- 倒计时保护(使用 TextDisplay 并阻止伤害)
- 基于 IP 的账号数量限制及绕过权限
- 备用账号追踪(不复制密码哈希)
- “记住我”开关(
/register ... [true|false]、/rememberme)
- Floodgate / Bedrock 自动登录支持
- 维护模式,支持设置原因与预计时间
- Discord Webhook:注册、备用账号、强制登录、私信、告示牌、维护通知
- 重生系统 — 登录后返回最后保存或配置的位置
- 管理工具:
/sa forcelogin、/sa forcelogout、/sa resetpassword、/sa unban、/sa sessions、/sa info、/sa stats、/sa void
? 更改
- 支持 Paper 1.20.x+(Java 17 字节码)
- 默认使用 PBKDF2 哈希(SHA256 作为回退);BCrypt/Argon2 回退至 PBKDF2
- 异步密码哈希与验证
- 暴力破解锁定 + IP 速率限制,数据持久化存储于
bans.yml
- 可配置的限制项:移动、聊天、命令、交互、伤害、饥饿、物品、背包
- Java 管理员默认必须通过身份验证
⚠️ 注意事项
- 无标签或等级系统
- 密码永远不会以明文形式记录
- Paper 1.21 服务器需 Java 21+
? 为什么选择 SleepyAuth?
SleepyAuth 旨在提供超越基本 /login 命令的功能。
它将身份验证、安全性、会话管理、管理工具和服务器实用功能整合到一个结构清晰的插件中。
目标很简单:
«在保障玩家安全的同时,简化服务器管理。»
安装 SleepyAuth,为您的服务器进行配置,让您的玩家享受更安全的 Minecraft 体验。
? 安装方法
- 使用 Paper 服务器(如果需要检测 Bedrock 玩家,请单独安装 Floodgate)
- 将
SleepyAuth-4.0.0.jar 放入服务器的 plugins 文件夹
- 启动一次服务器以创建配置文件和数据文件夹
- 查看
config.yml — 重点关注认证、账号限制、虚空世界、维护和 Discord 设置
- 完成!?
从源代码构建:
mvn clean package
# 输出:target/SleepyAuth-4.0.0.jar
? Etherno Project — 社区与支持
SleepyAuth 专为 Etherno Project Minecraft 服务器开发。
加入我们的 Discord 以:
- ? 加入 Etherno Project Minecraft 服务器
- ? 获取 SleepyAuth 的帮助与支持
- ? 报告错误
- ? 建议新功能
- ? 查看最新更新与公告
- ? 与我们的社区成员交流
? SleepyAuth
简单。安全。可靠。
«安心入睡。您的服务器已受保护。»
由 Etherno Project 团队 ❤️ 制作
加入 Etherno Project • 报告错误 • 请求功能
? SleepyAuth
Sleep peacefully. Your server is protected.
Advanced authentication & account protection for Paper servers
? About
SleepyAuth is an authentication and account-protection plugin for Paper servers. It asks players to register or log in, restricts unauthenticated players, and provides account security, session management, moderation tools, maintenance mode, logging, and optional Discord/Floodgate features.
Offline-mode (cracked) servers have no Mojang authentication — anyone can join as any username. SleepyAuth fixes this by locking usernames to real owners, protecting player progress, and adding layered security.
Compatibility: Paper 1.20.x and newer (Java 17 bytecode; Paper 1.21+ needs Java 21)
Optional Integrations: Floodgate for Bedrock detection • Discord webhooks for event notifications
✨ Features
? Registration & Login
Players register with /register <password> <password> [true|false] and log in with /login <password>. Passwords are hashed — PBKDF2 by default, with salted SHA256 support. Plaintext passwords are never stored or logged.
?️ Login Protection
Unauthenticated players receive prompts and action-bar reminders. Join/quit announcements are suppressed until authentication. Configurable restrictions block movement, chat, commands, interactions, damage, hunger, item pickup/drop, and inventory access.
? Void World Protection
An optional generated void world isolates unauthenticated players on a small protected platform. Prevents base stealing, coordinate leaking, griefing, and player tracking.
⏱️ Protection Countdown
After login, a configurable countdown shows a TextDisplay above the player and blocks damage until it expires. Can apply only to first-time registrations.
? Remember Me & Sessions
Optional Remember Me tokens provide longer auto-login (configurable lifetime, optional same-IP enforcement). Short-lived sessions restore login after disconnects. Cleared on logout or password change.
? Bedrock / Floodgate Support
Optional Floodgate detection recognizes Bedrock players. By default, verified Bedrock players skip authentication; force-auth can require them to register or log in instead.
? Alt Detection
Tracks registered accounts that share the same IP. Auto-creates alternate-account records (without password hashes) and can alert admins in-game or via Discord.
? Account Security
Per-account brute-force lockouts, per-IP failed-login rate limiting, account-per-IP limits (with bypass permission), and same-name/different-IP connection checks. Lockouts persist in bans.yml across restarts.
?️ Admin Tools
Full admin command suite: /sa reload, /forcelogin, /forcelogout, /resetpassword, /unban, /sessions, /info, /stats, /void, and more. Java admins must authenticate by default.
? Maintenance Mode
/maintenance on [reason] [| estimated time] announces a kick countdown, rejects new non-staff connections, and kicks current non-staff players. Operators are exempt unless configured otherwise.
? Discord Webhook Logging
Colored embeds for first-time registrations, alt detections, admin force-logins, private messages (/msg, /tell, /whisper), sign placement/edits, and maintenance start/end.
? Spawn System
Teleport players to spawn before login, then return them to their last saved or configured location after authentication.
? Commands
? Player Commands
| Command |
Description |
/register <password> <password> [true|false] |
Create an account (optional Remember Me toggle) |
/login <password> |
Log into your account |
/logout |
Log out and clear Remember Me token |
/changepassword <old> <new> |
Change your password |
/unregister <password> |
Delete your account |
/rememberme <true|false> |
Toggle Remember Me |
?️ Admin Commands
| Command |
Description |
/sa help |
Show admin command list |
/sa reload |
Reload config & messages |
/sa forcelogin <player> |
Authenticate an online player |
/sa forcelogout <player> |
Return player to unauthenticated state |
/sa resetpassword <player> <new> |
Reset a player's password |
/sa unban <player|ip> |
Remove lockout or rate-limit state |
/sa sessions |
List active remembered sessions |
/sa info <player> |
Show player account details |
/sa stats |
Show plugin statistics |
/sa void |
Toggle between void world and spawn |
/maintenance on/off [reason] [| time] |
Toggle maintenance mode |
? Permissions
| Permission |
Description |
Default |
sleepyauth.admin |
All admin permissions |
OP |
sleepyauth.reload |
/sa reload |
OP |
sleepyauth.forcelogin |
/sa forcelogin |
OP |
sleepyauth.forcelogout |
/sa forcelogout |
OP |
sleepyauth.resetpassword |
/sa resetpassword |
OP |
sleepyauth.unban |
/sa unban |
OP |
sleepyauth.sessions |
/sa sessions |
OP |
sleepyauth.info |
/sa info |
OP |
sleepyauth.stats |
/sa stats |
OP |
sleepyauth.void |
/sa void |
OP |
sleepyauth.maintenance |
/maintenance |
OP |
sleepyauth.bypass |
Java admin login bypass |
— |
sleepyauth.bypass.iplimit |
Bypass IP account limit |
OP |
? Changelog
V4.0.0 — Stable Authentication & Security Update
✨ New
- Void World Protection for unauthenticated players
- Protection Countdown with TextDisplay & damage blocking
- Account-per-IP limit with bypass permission
- Alternate-account tracking (no password hashes copied)
- Remember Me toggle (
/register ... [true|false], /rememberme)
- Floodgate/Bedrock auto-login support
- Maintenance Mode with reason & estimated time
- Discord webhooks: registrations, alts, force-logins, PMs, signs, maintenance
- Spawn system — return to last saved or configured location after login
- Admin tools:
/sa forcelogin, /sa forcelogout, /sa resetpassword, /sa unban, /sa sessions, /sa info, /sa stats, /sa void
? Changed
- Paper 1.20.x+ support (Java 17 bytecode)
- PBKDF2 default hashing (SHA256 fallback); BCrypt/Argon2 fall back to PBKDF2
- Async password hashing & verification
- Brute-force lockouts + IP rate limiting with persistence in
bans.yml
- Configurable restrictions: movement, chat, commands, interaction, damage, hunger, items, inventory
- Java admins must authenticate by default
⚠️ Notes
- No tags or rank system
- Passwords never logged in plaintext
- Requires Java 21+ on Paper 1.21 servers
? Why SleepyAuth?
SleepyAuth is designed to provide more than just a basic /login command.
It combines authentication, security, session management, moderation tools, and server utilities into one organized plugin.
The goal is simple:
«Keep players protected while making server management easier.»
Install SleepyAuth, configure it for your server, and let your players enjoy a safer Minecraft experience.
? Installation
- Use a Paper server (install Floodgate separately if Bedrock detection is needed)
- Place
SleepyAuth-4.0.0.jar in your server's plugins folder
- Start the server once to create config and data folders
- Review
config.yml — especially authentication, account limits, void-world, maintenance, and Discord settings
- You're done! ?
Building from source:
mvn clean package
# Output: target/SleepyAuth-4.0.0.jar
? Etherno Project — Community & Support
SleepyAuth is developed for the Etherno Project Minecraft server.
Join our Discord to:
- ? Join the Etherno Project Minecraft server
- ? Get help & support with SleepyAuth
- ? Report bugs
- ? Suggest features
- ? See the latest updates & announcements
- ? Hang out with our community
? SleepyAuth
Simple. Secure. Reliable.
«Sleep peacefully. Your server is protected.»
Made with ❤️ by the Etherno Project team
Join Etherno Project • Report Bug • Request Feature
评论 0
登录后参与评分
还没有评论,来抢沙发吧