Mineuniverse
Mods
BasicAuth

BasicAuth

MOD
A lightweight authentication mod for offline Minecraft servers. Protect your server with password-based login/registration, no client-side mod required
by ALR2310
Download Claim this project
360 downloads
0 likes
0 followers
Updated Oct 14, 2026
0 hypes
Follow0
Server Utility
Advertisement Remove ads with Premium →

BasicAuth

A lightweight authentication mod for offline Minecraft servers. Protect your server with password-based login/registration, no client-side mod required.

Features

  • Password-protected accounts — players must /register and /login before they can interact with the world.
  • Locked out until authenticated — players who haven't logged in are frozen in place (or teleported to a configurable waiting area), can't break/place blocks, interact, attack, take damage, or chat.
  • On-screen reminders — a fading on-screen subtitle nags unauthenticated players to log in or register every few seconds.
  • Login timeout — auto-kicks players who take too long to authenticate.
  • Brute-force protection — kicks after too many failed /login attempts.
  • Reconnect grace period — players who disconnect unexpectedly (crash/network drop) while logged in can reconnect from the same IP within a configurable window without needing to log in again.
  • Waiting area — optionally teleport unauthenticated players to a fixed location instead of freezing them where they joined, then return them to their last known position after logging in.
  • Admin tools — reset a player's password, unregister an account, or list all registered accounts, right from the console or in-game.
  • Fully configurable — timeouts, password length, failed-attempt limits, and more, adjustable in-game via the Mods menu or in config/basicauth-common.toml.

Commands

Command Description
/register <password> <confirmPassword> Create an account and log in.
/login <password> Log in to an existing account.
/changepassword <old> <new> Change your password.
/logout Disconnect and clear your session.
/unregister <password> Delete your own account.
/basicauth reset <player> (Op) Reset a player's password to a random code.
/basicauth unregister <player> (Op) Delete a player's account.
/basicauth accounts (Op) List all registered accounts with their online status.

Configuration

All settings are available in-game via Mods → BasicAuth → Config, or by editing config/basicauth-common.toml:

Setting Default Description
loginTimeoutSeconds 60 Time before an unauthenticated player is kicked.
minPasswordLength / maxPasswordLength 3 / 64 Allowed password length.
maxFailedAttempts 5 Failed /login attempts before a kick.
gracePeriodSeconds 3600 Reconnect window after an unexpected disconnect.
waitingAreaEnabled false Teleport unauthenticated players to a fixed location.
waitingAreaDimension / X / Y / Z — Where the waiting area is.
basicauth-1.21.1-1.0.0.jar
MC 1.21.1, NeoForge, Server
Release 2026-07-28 Get
basicauth-1.21.2-1.0.0.jar
MC NeoForge, Server, 1.21.2
Release 2026-07-28 Get
basicauth-1.21.3-1.0.0.jar
MC 1.21.3, NeoForge, Server
Release 2026-07-28 Get
basicauth-1.21.4-1.0.0.jar
MC 1.21.4, NeoForge, Server
Release 2026-07-28 Get
basicauth-1.21.5-1.0.0.jar
MC 1.21.5, NeoForge, Server
Release 2026-07-28 Get
basicauth-1.21.6-1.0.0.jar
MC 1.21.6, NeoForge, Server
Release 2026-07-28 Get
basicauth-1.21.7-1.0.0.jar
MC 1.21.7, NeoForge, Server
Release 2026-07-28 Get
basicauth-1.21.8-1.0.0.jar
MC 1.21.8, NeoForge, Server
Release 2026-07-28 Get
basicauth-1.21.9-1.0.0.jar
MC NeoForge, Server, 1.21.9
Release 2026-07-28 Get
basicauth-1.21.10-1.0.0.jar
MC NeoForge, Server, 1.21.10
Release 2026-07-28 Get
basicauth-1.21.11-1.0.0.jar
MC NeoForge, Server, 1.21.11
Release 2026-07-28 Get
basicauth-26.1-1.0.0.jar
MC NeoForge, Server, 26.1
Release 2026-07-28 Get
basicauth-26.1.2-1.0.0.jar
MC NeoForge, Server, 26.1.2
Release 2026-07-28 Get
basicauth-26.2-1.0.0.jar
MC NeoForge, Server, 26.2
Release 2026-07-28 Get
basicauth-1.20.1-1.0.0.jar
MC 1.20.1, Forge, Server
Release 2026-07-28 Get

More from ALR2310

Advertisement Remove ads with Premium →

You Might Also Like