BasicAuth

BasicAuth

一个面向离线 Minecraft 服务器的轻量级认证模组。通过基于密码的登录/注册来保护你的服务器，无需客户端模组。

功能特性

• 密码保护账户 —— 玩家必须先执行 /register 和 /login 才能与世界交互。
• 未认证前锁定 —— 未登录的玩家将被冻结在原地（或传送到可配置的等待区域），无法破坏/放置方块、交互、攻击、受到伤害或聊天。
• 屏幕提醒 —— 一个淡出的屏幕副标题每隔几秒就会提醒未认证的玩家登录或注册。
• 登录超时 —— 自动踢出认证耗时过长的玩家。
• 防暴力破解 —— 多次 /login 尝试失败后将踢出玩家。
• 重连宽限期 —— 已登录玩家意外断开（崩溃/网络中断）后，可在可配置的时间窗口内从同一 IP 重新连接，无需再次登录。
• 等待区域 —— 可选择将未认证玩家传送到固定位置，而不是冻结在他们加入时的位置；登录后会将他们送回最后已知位置。
• 管理员工具 —— 可直接从控制台或游戏内重置玩家密码、删除账户或列出所有已注册账户。
• 完全可配置 —— 超时时间、密码长度、失败尝试限制等均可通过 Mods 菜单或编辑 config/basicauth-common.toml 在游戏内调整。

命令

命令	描述
/register <密码> <确认密码>	创建账户并登录。
/login <密码>	登录现有账户。
/changepassword <旧密码> <新密码>	修改你的密码。
/logout	断开连接并清除你的会话。
/unregister <密码>	删除你自己的账户。
/basicauth reset <玩家>	(管理员) 将玩家密码重置为随机代码。
/basicauth unregister <玩家>	(管理员) 删除玩家的账户。
/basicauth accounts	(管理员) 列出所有已注册账户及其在线状态。

配置

所有设置均可通过游戏内 Mods → BasicAuth → Config 访问，或编辑 config/basicauth-common.toml：

设置项	默认值	描述
loginTimeoutSeconds	60	未认证玩家被踢出前的等待时间。
minPasswordLength / maxPasswordLength	3 / 64	允许的密码长度。
maxFailedAttempts	5	踢出前的 /login 失败尝试次数。
gracePeriodSeconds	3600	意外断开后的重连窗口。
waitingAreaEnabled	false	将未认证玩家传送到固定位置。
waitingAreaDimension / X / Y / Z	—	等待区域的位置。