CurseForge · Minecraft mod
BasicAuth
A lightweight authentication mod for offline Minecraft servers. Protect your server with password-based login/registration, no client-side mod required
Quick answer
Which BasicAuth release matches 26.1?
basicauth-26.1-1.0.0.jar targets 26.1 with NeoForge. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.
Where it goes
Is BasicAuth required on the client, server, or both?
The project page does not say whether this file belongs on the client, dedicated server, or both.
The source does not explicitly classify this release as client-only or server-only.
What else does basicauth-26.1-1.0.0.jar need?
basicauth-26.1-1.0.0.jar on 26.1. Every mod below is checked against that same setup.
This file does not list any required mods. Do not add a library just because a different file uses it.
This file does not list any required or optional mods.
Before you install it
Add BasicAuth without breaking your instance.
Built for basicauth-26.1-1.0.0.jar on 26.1. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use basicauth-26.1-1.0.0.jar. It targets 26.1 with NeoForge; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
This file does not list any required mods. Do not add a library just because a different file uses it.
- 03
Put it on the correct side
The project page does not say whether this file belongs on the client, dedicated server, or both.
- 04
Pick the file you checked
Use the “Get this file” button beside basicauth-26.1-1.0.0.jar. It opens that exact file at the source.
About this project
What does BasicAuth add?
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
/registerand/loginbefore 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
/loginattempts. - 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. |
Project description from CurseForge.
Pick your setup
BasicAuth by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
26.1.2
1 loader build26.1
1 loader build1.21.11
1 loader build1.21.10
1 loader build1.21.9
1 loader build1.21.8
1 loader build1.21.7
1 loader build1.21.6
1 loader build1.21.5
1 loader build1.21.4
1 loader build1.21.3
1 loader buildShowing the newest 12 of 15 game versions. Older files are in the list below.
Check the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
BasicAuth versions and loaders
basicauth-26.1-1.0.0.jar
28 Jul 2026
Looking for an older file? The official CurseForge project page is in Resources.