Sentinel 是一款轻量、强大且安全的 Minecraft 1.20+ 服务器身份验证插件。它以简洁和安全为核心设计理念,确保玩家在与世界交互前完成注册和登录,从而保护你的服务器免受未授权访问和潜在漏洞利用的侵害。

功能特性
-
?
/login <password>- 登录已注册的账号- 权限:
sentinel.login - 别名:
/l <password>
- 权限:
-
?
/register <password>- 创建新账号- 权限:
sentinel.register - 别名:
/r <password>
- 权限:
-
?
/changepassword <old> <new>- 安全地更改密码- 权限:
sentinel.changepassword
- 权限:
-
?️
/unregister <player>- 删除玩家账号(默认仅限 OP)- 权限:
sentinel.unregister
- 权限:
-
?
/sentinel reloadlang- 从配置文件中重载服务器语言(默认仅限 OP)- 权限:
sentinel.use
- 权限:
功能详情
-
? 受限模式: 未登录的玩家将被置于受限状态。
-
? 会话支持: 可自定义自动登录会话窗口(默认为 15 分钟)
-
? SQLite 存储: 所有数据本地存储在
Sentinel/auth.db中 -
?️ 安全日志记录: 与密码相关的命令会被过滤出日志,避免信息泄露
-
? 多版本支持: 完全兼容 Minecraft 1.20+,包括 1.21.x
-
? 基于区域的语言设置: 根据玩家的客户端区域设置自动选择语言。可用的翻译包括:
en-US,en-GB,es-ES,pt-BR,pt-PT,de-DE,ru-RU- 可通过在
lang/文件夹中放置.yml翻译文件来添加其他语言。
-
? UUID 模式: 通过配置文件支持灵活的玩家 UUID 模式:
adapt- 根据服务器的在线模式自动选择online- 使用 Mojang 认证的 UUID(绑定到 Mojang 账号)。offline- 基于玩家名称生成 UUID(绑定到用户名)。
-
?️ 服务器语言配置: 定义服务器的默认语言(主要用于控制台日志)
? 计划中 / 即将推出
- 目前暂无计划中的功能,但欢迎提供建议和提交 Pull Request!
? 需要帮助或希望贡献?
发现 Bug?有建议?想帮忙改进? 你可以:
- 在 issues 中报告 Bug、提出想法或功能请求。
- 提交 pull requests 以改进代码、文档或功能。
- 或在 GitHub 仓库中发起 discussion。
感谢使用 Sentinel!
Sentinel is a lightweight, powerful and secure authentication plugin for 1.20+ Minecraft servers. Built with simplicity and safety in mind, it ensures that players register and log in before interacting with the world, protecting your server from unauthorized access and potential exploits.

Features
-
🔑
/login <password>- Log in to your registered account- Permission:
sentinel.login - Aliases:
/l <password>
- Permission:
-
🆕
/register <password>- Create a new account- Permission:
sentinel.register - Aliases:
/r <password>
- Permission:
-
🔄
/changepassword <old> <new>- Change your password securely- Permission:
sentinel.changepassword
- Permission:
-
🗑️
/unregister <player>- Delete a player account (OP only as default)- Permission:
sentinel.unregister
- Permission:
-
🔧
/sentinel reloadlang- Reload server's language from config (OP only as default)- Permission:
sentinel.use
- Permission:
Functionalities
-
🚷 Restricted Mode: Players who are not logged in are placed in a restricted state.
-
🕒 Session Support: Customizable auto-login session window (15 minutes by default)
-
🧱 SQLite Storage: All data stored locally in
Sentinel/auth.db -
🛡️ Secure Logging: Password-related commands are filtered from logs to avoid exposure
-
🧩 Multi-Version Support: Fully compatible with Minecraft 1.20+, including 1.21.x
-
🌐 Locale-Based Language: Each player's language is selected automatically based on their client locale. Available translations include:
en-US,en-GB,es-ES,pt-BR,pt-PT,de-DE,ru-RU- Additional locales can be added by placing
.ymltranslation files in thelang/folder.
-
🆔 UUID Modes: Supports flexible player UUID modes via config:
adapt- Automatically chooses based on the server’s online modeonline- Use Mojang authenticated UUIDs (accounts tied to Mojang accounts).offline- Generate UUIDs based on player names (accounts tied to usernames).
-
🖥️ Server Language Config: Defines the server's default language (used mainly for console logs)
📢 Planned / Coming Soon
- Currently no planned features, but open to suggestions and pull requests!
🤝 Need Help or Want to Contribute?
Found a bug? Have a suggestion? Want to help improve it? You can:
- Open issues for bugs, ideas, or feature requests.
- Submit pull requests to improve the code, docs, or features.
- Or start a discussion in the GitHub repository.
Thank you for using Sentinel!
下载 Sentinel
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Sentinel
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Sentinel
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Sentinel
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Sentinel
The Fortress Update
-
小版本更新与构建工具改进
- 版本号从 0.2.2 变更为 0.3.0
- Shadow 插件升级至 9.2.2
- Gradle wrapper 从 8.8 升级至 9.8.0(基于 JDK 25 构建)
- 添加了 JUnit 5 测试配置和测试任务
-
安全/认证重构
- 新增了专用的 AuthService 层,以集中管理登录/注册/密码逻辑
- 认证现在采用“失败关闭”策略:数据库错误将拒绝登录和注册,而不是允许玩家进入
- 为失败的登录尝试添加了速率限制/锁定跟踪(按玩家和按 IP)
- 添加了登录超时强制机制
- 添加了密码验证规则(默认长度为 8 到 64 个字符),并在
/register中添加了密码确认 - 添加了密码哈希抽象和 bcrypt 成本配置(默认成本为 12;现有哈希仍可正常工作)
- 基于会话的自动登录现在是可选的,且默认关闭,绑定 IP 和客户端品牌,默认持续时间缩短为 5 分钟,并带有风险警告
- 添加了 Floodgate 兼容性支持和跳过认证选项(默认关闭)
- 添加了精确命令别名匹配,并且
/login、/register和/changepassword现在对其他插件的命令日志隐藏(CoreProtect, EssentialsX commandspy) - 密码哈希和数据库操作现在在主线程之外运行
-
玩家限制/会话行为
- 重新设计了加入/离开处理,以更严格地限制未认证玩家
- 未认证玩家现在被明确禁止破坏、放置、交互、丢弃、拾取、受到伤害以及点击物品栏,除了旁观者模式之外
- 添加了针对未能及时认证的玩家的超时处理
- 添加了登出命令支持以及自动登出/会话失效处理
- 改进了登录后/登出后/注销后的状态恢复/保存行为
- 对于在 Sentinel 安装之前加入的玩家,原始的 OP、游戏模式和位置现在被正确保存
- 注销账户会重置其存储的状态,因此重新注册的名称不再继承前所有者的 OP、游戏模式或位置
- 限制在
/reload后保持一致
-
数据库和用户身份变更
- 数据库移至插件的数据文件夹
- SQLite 现在使用 WAL 模式和忙等待超时,具有自动重连和警告功能
- 添加了 name_key 跟踪,用于不区分大小写的名称检查(如果
Steve已存在,则steve无法注册) - 添加了未注册账户的状态重置跟踪
- 添加了离线/在线模式下 UUID 解析的改进
-
兼容性和更新处理
- 添加了 Minecraft 版本解析和兼容性回退逻辑(修复了在 26.x 上恢复药水效果时的崩溃问题)
- 添加了用于注册表差异的回退适配器
- 修复了
plugin.yml中的api-version,之前被读取为1.2而不是1.20 - 更新了对较新 Paper/MC 条件的支持,包括 26.3
- 修复了在异步聊天线程上进行的检查的线程安全问题
-
文档/配置更新
- README 大幅扩展,增加了配置和安全说明
- config.yml 增加了登录/会话/密码/Floodgate 设置
- 命令别名从 plugin.yml 移至 config.yml 中的
commands.aliases(默认为/l;移除了/r别名以避免与 EssentialsX 冲突) - 语言文件更新了新消息,并将英国英语文件从
en_GB.yml重命名为en-GB.yml
-
新增测试
- MinecraftVersionTest
- AttemptTrackerTest
- SessionManagerTest
- CommandMatcherTest
- PasswordRulesTest
-
⚠️ 破坏性更改
/register现在需要输入两次密码:/register <password> <password>- 会话自动登录默认关闭
- 命令别名的配置位于 config.yml 中,且
/r不再是别名 - 未注册的账户将丢失其存储的 OP/游戏模式/位置
- 仅因大小写不同而不同的名称不能再分别注册
完整更新日志:
更新内容
- 在
config.yml中添加了会话持续时间设置,由 @Hydr46605 提交于
新贡献者
- @Hydr46605 在 完成了首次贡献
完整更新日志:
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧