CoolAuth
CoolAuth 是一款轻量级、高性能的身份验证插件,专为现代 Minecraft 1.21+ 服务器设计。它为离线模式服务器提供必要的安全保障,且没有大型插件那样的臃肿负担。
功能特性
- 性能优化: 构建目标为快速且精简,资源占用极低。
- 灵活存储: 开箱即用,支持 MySQL、MariaDB、SQLite 和 YAML 数据存储。
- 强安全性: 默认使用 AES 加密密码,确保用户安全。
- 玩家保护: 在玩家登录前,禁止移动、破坏/放置方块、聊天及交互行为。
- 用户友好: 使用现代化的标题(Title)和副标题(Subtitle)消息引导玩家加入游戏。
- 超时系统: 自动踢出未在配置时限内完成身份验证的玩家。
命令
/register <password>— 注册新账号。/login <password>— 登录已有账号。/coolauth reload— 重新加载配置文件和数据库连接。
权限
coolauth.admin— 用于执行重载命令所需的权限。
配置
config.yml 完全可自定义。您可以轻松切换加密开关、修改身份验证超时时间、编辑所有提示信息,并在不同数据库类型之间切换。
CoolAuth
CoolAuth is a lightweight, high-performance authentication plugin designed specifically for modern Minecraft 1.21+ servers. It provides essential security for offline-mode servers without the bloat of larger plugins.
Features
- Optimized Performance: Built to be fast and minimal with very low resource usage.
- Flexible Storage: Supports MySQL, MariaDB, SQLite, and YAML data storage out of the box.
- Strong Security: Passwords are AES encrypted by default to ensure user safety.
- Player Protection: Blocks movement, block breaking/placing, chat, and interactions until the player logs in.
- User Friendly: Uses modern Title and Subtitle messages to guide players on join.
- Timeout System: Automatically kicks players who do not authenticate within the configured time limit.
Commands
/register <password>— Register a new account./login <password>— Login to an existing account./coolauth reload— Reload the configuration and database connection.
Permissions
coolauth.admin— Required to use the reload command.
Configuration
The config.yml is fully customizable. You can toggle encryption, change the authentication timeout, edit all messages, and switch between database types effortlessly.
下载 Cool Auth
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Cool Auth
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Cool Auth
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Cool Auth
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Cool Auth
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Cool Auth
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
CoolAuth 更新日志
未发布版本
认证与会话
- 添加了持久化登录会话,可在服务器重启后恢复认证状态。
- 将每个会话绑定到玩家的 UUID、用户名和 IP 地址。如果信息不匹配,则使保存的会话失效并要求进行密码认证。
- 设置会话有效期为成功密码登录后四小时。恢复会话不会延长其过期时间。过期的会话将被自动移除。
- 将之前内置的 220 分钟会话默认值迁移至 240 分钟。将
security.session_timeout设置为0可禁用会话功能。 - 当管理员更改密码、注销账户或批准密码找回时,撤销已记住的会话。
- 在断开连接期间保留失败登录尝试次数;成功认证后将清除该计数。
密码安全
- 以带盐 PBKDF2-HMAC-SHA256 哈希值存储新密码和修改后的密码,迭代次数为 210,000 次,派生密钥长度为 256 位。
- 在成功登录后,将现有的 BCrypt、OWE、TWE 以及明文兼容记录升级为 PBKDF2。
- 遇到格式错误的旧版哈希或加密失败时采取保守策略(Fail closed),而不是回退到以明文形式存储密码。
- 在迁移过程中保持现有密码记录可用。旧版 OWE/TWE 验证仍依赖于配置的旧版加密类型和密钥。
登录界面
- 在注册和登录屏幕上,以蓝色粗体显示包含玩家姓名的欢迎标题。
- 根据账户 UUID 的注册状态选择登录和注册提示:已注册的账户导向
/login,新账户导向/register。
构建与分发
- 添加了一个 GitHub Actions 工作流,针对推送到
main或dev分支以及拉取请求的情况,使用 Java 17 和 Maven 构建插件,也可手动触发运行。 - 将着色后的
CoolAuth-*.jar上传为CoolAuth-jar工作流工件。工件保留期为 30 天。
兼容性说明
- 现有的密码哈希将在其所有者下次成功登录时进行升级。
- 会话数据存储在插件数据文件夹中的
sessions.yml文件内。升级时不会迁移现有的内存会话;玩家将进行一次认证以创建持久化会话。 - Maven 项目版本仍为
2.0.4;本更新日志描述的是当前位于main和dev分支上的变更。
CoolAuth v2.0.3 - 功能摘要
新增功能
1. 密码强度要求
可配置的密码验证系统,用于强制执行安全密码。
- 最小和最大密码长度
- 要求包含大写字母 (A-Z)
- 要求包含小写字母 (a-z)
- 要求包含数字 (0-9)
- 要求包含特殊字符(可配置列表)
- 所有设置均可在 config.yml 中配置
2. BCrypt 加密
新增 BCrypt 作为第三种加密选项,提供工业标准的密码哈希处理。
- 选项 1:OWE - 使用带盐 SHA-256 的单向加密
- 选项 2:TWE - 使用 AES 的双向加密(可恢复)
- 选项 3:BCRYPT - 工业标准自适应哈希算法(新增)
- 可配置 BCrypt 轮数(推荐 10-12 轮)
- BCrypt 库已阴影打包至插件 JAR 文件中
3. 密码找回系统
完整的密码找回系统,支持 Discord Webhook 集成。
- 基于 GUI 的原因选择
- 可配置的找回原因列表
- 聊天输入框用于添加额外详情
- 唯一的 8 位字符找回验证码
- 带有嵌入消息的 Discord Webhook 通知
- 找回请求冷却系统
- 找回验证码过期时间
- 服务器重启后数据持久化保存
- 命令: /passwordrecovery 或 /pr
4. 新增管理员命令
扩展的管理员命令集,以便更好地管理服务器。
| 命令 | 描述 |
|---|---|
| /coolauth reload | 重新加载配置并重新连接存储 |
| /coolauth unregister [player] | 注销玩家账户 |
| /coolauth setpass [player] [password] | 设置玩家密码 |
| /coolauth info [player] | 查看玩家认证信息(IP、位置、状态) |
| /coolauth forcelogin [player] | 强制在线玩家进行身份验证 |
| /coolauth forceregister [player] [password] | 手动注册玩家 |
| /coolauth banip [ip] | 封禁 IP 地址 |
| /coolauth unbanip [ip] | 解封 IP 地址 |
| /coolauth approve [code] | 批准密码找回请求 |
| /coolauth deny [code] | 拒绝密码找回请求 |
| /coolauth lookup [ip] | 查看从某个 IP 注册的所有账户 |
5. Tab 补全
管理员命令完全支持 Tab 键自动补全。
- 子命令建议
- 在线玩家名称建议
- unbanip 命令的被封禁 IP 建议
- approve/deny 命令的活跃找回验证码建议
配置新增项
密码部分
password:
enabled: true
min_length: 8
max_length: 32
require_uppercase: true
require_lowercase: true
require_numbers: true
require_special: false
special_characters: "!@#$%^&*()_+-=[]{}|;:,.>?"
找回部分
recovery:
enabled: false
discord_webhook: "https://discord.com/api/webhooks/YOUR_WEBHOOK_HERE"
cooldown: 3600
code_expiry: 86400
reasons:
- "I forgot my password"
- "My account was compromised"
- "I lost access to my account"
- "Other"
gui_title: "&8&lPassword Recovery"
embed_color: "#3498db"
embed_title: "Password Recovery Request"
安全部分更新
security: encryption_type: "BCRYPT" bcrypt_rounds: 10
存储更新
数据库架构已更新,添加了新列:
- username - 存储玩家用户名
- registered_at - 注册时间戳
现有数据库自动迁移列。
新增消息
- 密码强度错误消息
- 找回系统消息
- 扩展的管理员命令消息
- IP 封禁/解封消息
- 玩家查找消息
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
使床在所有维度中爆炸的模组
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧