NullPass

模组

· 作者 DeM0RG

适用于 Minecraft NeoForge 1.21.1 的轻量级服务端认证模组。NullPass 通过注册和登录指令、安全哈希密码、可配置的认证限制,且无需安装客户端模组,为你的服务器提供保护。

0 本站下载 0 关注 更新于 3 个月前

最新 1.0-NULL · 1.21.1 · NeoForge

一键开服(送7天)

NullPass 是一款适用于运行 NeoForge 1.21.1 的 Minecraft 服务器的简易身份验证模组。它仅需安装在服务端:玩家可使用普通的兼容客户端加入服务器,无需自行安装该模组。

新玩家需要注册账号,而已注册的玩家在游玩前必须登录。在身份验证完成之前,NullPass 会阻止玩家移动、聊天、使用大部分命令、与世界交互、攻击实体或打开容器。

密码绝不会以明文形式保存。

功能特性

  • 仅服务端安装。
  • 安全的账号注册与身份验证。
  • 使用加盐 PBKDF2 进行密码哈希处理;密码不以明文存储。
  • 可配置密码长度限制。
  • /register 和 /login 命令,支持可选的短别名。
  • /changepassword 以及可选的 /logout 命令。
  • 身份验证前对移动、聊天、命令、交互、物品栏/容器、破坏方块及攻击行为进行限制。
  • 支持在聊天栏、动作栏(action bar)或Boss栏中显示身份验证提示。
  • 可配置提示重复间隔。
  • 可配置注册/登录超时时间;未认证玩家超时后将被踢出。
  • 可配置错误登录尝试次数上限。
  • 错误密码反馈包含当前尝试次数,例如 (1/3)。
  • 可选的已重连玩家会话记忆功能。
  • 可选的记忆会话仅限同一 IP 地址。
  • 支持自定义消息,使用旧版 Minecraft 颜色代码(&)。
  • 提供英文和俄文语言资源;默认配置消息为俄语。

为什么使用 NullPass?

NullPass 适用于离线模式或私人的 Minecraft 服务器,需要为这些服务器提供基于密码的登录层。它使身份验证流程保持专注且可配置,同时无需每位玩家都安装额外的模组。

当你想要实现以下目标时,请使用 NullPass:

  • 保护离线模式服务器上的玩家账号;
  • 防止未认证玩家与世界交互;
  • 强制实施登录截止时间并限制密码猜测尝试;
  • 在正常重连后提供便捷的重连会话恢复期;
  • 自定义所有面向玩家的提示消息及其显示位置。

基础语法

命令 描述
/register <password> <confirmPassword> 创建账号并验证玩家身份。
/login <password> 验证已注册玩家的登录。
/changepassword <oldPassword> <newPassword> 更改已验证玩家的密码。
/logout 结束当前的身份验证会话(需在配置中启用)。
/reg <password> <confirmPassword> /register 的短别名(需启用 shortCommands)。
/l <password> /login 的短别名(需启用 shortCommands)。

密码作为单个命令参数读取,因此不能包含空格。

配置

NullPass 使用 NeoForge 通用配置文件。模组首次启动后,请编辑服务器 config 目录中生成的 nullpass-common.toml 文件,然后重启服务器以应用更改。

主要选项

选项 默认值 描述
shortCommands true 启用 /reg 和 /l 别名。
sessionExpireSeconds 60 正常重连时可恢复已验证会话的时间长度。设为 0 以禁用记忆会话功能。
requireSameIpForSession true 要求重连玩家使用相同的 IP 地址以恢复会话。
messageDisplay ACTIONBAR 注册/登录提示的显示位置:CHAT、ACTIONBAR 或 BOSSBAR。
messageRepeatSeconds 3 提示重复间隔。设为 0 以禁用重复提示。
allowLogoutCommand true 允许玩家使用 /logout。
authenticationTimeoutSeconds 60 用于注册或登录的可用时间。设为 0 以禁用超时。
maxLoginAttempts 3 断开玩家连接前的最大错误 /login 尝试次数。设为 0 以禁用此限制。
password.minLength 4 允许的密码最小长度。
password.maxLength 32 允许的密码最大长度。

示例

shortCommands = true
sessionExpireSeconds = 60
requireSameIpForSession = true
messageDisplay = "ACTIONBAR"
messageRepeatSeconds = 3
allowLogoutCommand = true
authenticationTimeoutSeconds = 60
maxLoginAttempts = 3

[password]
minLength = 4
maxLength = 32

消息与颜色

所有面向玩家的消息均可在 messages 部分进行修改。NullPass 支持使用 & 的旧版颜色代码,例如:

[messages]
login = "&6NullPass &7| &fPlease log in: /login <password>"
wrongPassword = "&6NullPass &7| &cIncorrect password."
authenticationTimeout = "&6NullPass &7| &fYou did not authenticate."
loginAttemptsExceeded = "&6NullPass &7| &fThe maximum number of login attempts has been exceeded."

当启用 maxLoginAttempts 时,错误密码消息会在最后一次失败尝试前自动附加一个灰色的计数器:

NullPass | Incorrect password. (1/3)
NullPass | Incorrect password. (2/3)

在最后一次失败尝试时,玩家将因达到上限而被断开连接,并显示配置的 loginAttemptsExceeded 消息。

安装

  1. 在你的服务器上为 Minecraft 1.21.1 安装 NeoForge。
  2. 将 NullPass JAR 文件放入服务器的 mods 目录。
  3. 启动服务器一次以生成配置文件。
  4. 如有需要,编辑 config/nullpass-common.toml。
  5. 重启服务器。

客户端无需安装 NullPass。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源