
Modrinth · Minecraft mod
Alternative Authentication
Use third-party authentication servers, like Ely.by, on your server without interfering with Mojang authentication
Quick answer
Which Alternative Authentication release should I use?
Alternative Authentication 1.3.0+26.1 targets 26.1, 26.1.1, 26.1.2 with Fabric. Do not install it on the client. It must be installed on the dedicated server. All 1 required mods have matching files.
Where it goes
Is Alternative Authentication required on the client, server, or both?
Do not install it on the client. It must be installed on the dedicated server.
This file is marked server-only.
What else does Alternative Authentication 1.3.0+26.1 need?
1.3.0+26.1. Change the file and its required mods may change too.
Install Fabric API first. We found matching files for this game-version and loader setup.
We only count dependency files that match this setup. A file for another loader does not fill the gap.
Before you install it
Add Alternative Authentication without breaking your instance.
Built for Alternative Authentication 1.3.0+26.1. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use 1.3.0+26.1. It targets 26.1, 26.1.1, 26.1.2 with Fabric; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
Install Fabric API first. We found matching files for this game-version and loader setup.
- 03
Put it on the correct side
Do not install it on the client. It must be installed on the dedicated server.
- 04
Pick the file you checked
Use the “Get this file” button beside 1.3.0+26.1. It opens that exact file at the source.
About this project
What does Alternative Authentication add?
Alternative Authentication
Alternative Authentication is a server-side mod that allows multiple third-party or custom authentication servers to coexist alongside Mojang's. By default, two providers are configured: Mojang and Ely.by. You can add, remove, or reorder them freely.
Requirements:
online-mode=trueinserver.propertiesenforce-secure-profile=falseis recommended, players joining via third-party providers don't have signed chat keys
Server-side only. Players using a third-party auth provider on the client need a compatible launcher or injector.
Features
- ⚙️ Configurable list of authentication providers.
- 🔐 Sequential provider fallback when a player joins the server
- 🔒 Optional fallback prevention: if a username exists on a provider but authentication fails, further providers are not tried.
- 👕 Player texture support (skin and cape) via third-party skin servers
- 📝 Whitelist support across all configured providers
How It Works
Joining the Server
When a player connects, each configured provider is tried in order until one successfully authenticates the session. If no provider succeeds, the player is denied access.
If preventFallbackIfPlayerExists is enabled and a player's username is found on a provider but authentication fails, no further providers are attempted. This prevents a user registered on a fallback service from impersonating an account on an earlier provider.
Whitelist
When a player is added to the whitelist, each provider is queried in order until the username is resolved to a UUID. If the player is not found on any provider, they cannot be added. The order in which providers are checked is determined by the providers list in the config.
What if two players share the same username across providers?
By default, the first provider to resolve the username wins. If you need to whitelist a player whose username exists on a non-primary provider, temporarily reorder the providers list and add them manually with /whitelist add.
Configuration
The config file is created automatically at config/alternative-auth.json on first launch.
configVersion
The internal schema version. Managed automatically by the mod, do not edit this manually.
debugMode
When true, detailed logs are written to the console during authentication and whitelist operations. Useful for troubleshooting. Disabled by default.
preventFallbackIfPlayerExists
When true, stops the provider chain if a username is found on the current provider but authentication fails. Prevents username spoofing via fallback services, non-premium players with usernames unique to a fallback service are not affected. Disabled by default.
providers
The ordered list of authentication providers. Each entry supports the following fields:
| Field | Required | Description |
|---|---|---|
name |
✅ | Display name for the provider |
checkUrl |
✅ | Session validation endpoint, queried when a player joins the server |
profileUrl |
✅ | Single username to UUID lookup endpoint, used for whitelist operations |
profilesUrl |
✅ | Batch username to UUID lookup endpoint |
propertyUrl |
❌ | Endpoint for fetching player properties such as skin and cape. Use {0} for the player's username and {1} for their UUID |
{
"configVersion": 1,
"debugMode": false,
"preventFallbackIfPlayerExists": false,
"providers": [
{
"name": "Mojang",
"checkUrl": "https://sessionserver.mojang.com/session/minecraft/hasJoined",
"profileUrl": "https://api.minecraftservices.com/minecraft/profile/lookup/name/",
"profilesUrl": "https://api.minecraftservices.com/minecraft/profile/lookup/bulk/byname"
},
{
"name": "Ely.by",
"checkUrl": "https://authserver.ely.by/session/hasJoined",
"profileUrl": "https://authserver.ely.by/api/users/profiles/minecraft/",
"profilesUrl": "https://authserver.ely.by/api/profiles/minecraft",
"propertyUrl": "http://skinsystem.ely.by/textures/signed/{0}"
}
]
}
FAQ
Q: Can't join the server, "Invalid signature for profile public key"
A: Install No Chat Reports on your server. Installing it on the client is recommended but not required.
Q: Is Forge or NeoForge supported?
A: NeoForge support is planned.
Q: When will the mod be updated to the latest Minecraft version?
A: The mod targets the latest stable release and is updated as time allows. Snapshot support is not planned.
Q: I found a bug, have a suggestion, or the mod isn't working correctly
A: Feel free to open an issue on GitHub!
Project description from Modrinth.
Pick your setup
Alternative Authentication 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
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
2 loader builds1.21.3
2 loader buildsShowing the newest 12 of 46 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
Alternative Authentication versions and loaders
1.3.0+26.1
alternative-auth-1.3.0+26.1.jar
28 Mar 2026
1.3.0+1.21.9-1.21.11
alternative-auth-1.3.0+1.21.9-1.21.11.jar
28 Mar 2026
1.2.0+1.21.9-1.21.11
alternative-auth-1.2.0+1.21.9-1.21.11.jar
29 Dec 2025
1.2.0+1.21.5-1.21.8
alternative-auth-1.2.0+1.21.5-1.21.8.jar
29 Dec 2025
1.1.1+1.20.2-1.21.4
alternative-auth-1.1.1+1.20.2-1.21.x.jar
19 Feb 2025
1.1.1+1.16-1.20.1
alternative-auth-1.1.1+1.16-1.20.1.jar
19 Feb 2025
1.1.1+1.14-15.2
alternative-auth-1.1.1+1.14-1.15.2.jar
19 Feb 2025
1.0.1+1.21.3
alternative-auth-1.0.1+1.21.3.jar
24 Oct 2024
1.0.1+1.21.2
alternative-auth-1.0.1.jar
22 Oct 2024
1.0.0+1.21.1
alternative-auth-1.0.0+1.21.1.jar
26 Sept 2024
Looking for an older file? The official Modrinth project page is in Resources.