https://github.com/florianmichael/waybackauthlib
Addon for Mojang's AuthLib to support Yggdrasil authentication again
https://github.com/florianmichael/waybackauthlib
authlib backport mojang-authentication third-party yggdrasil
Last synced: 3 months ago
JSON representation
Addon for Mojang's AuthLib to support Yggdrasil authentication again
- Host: GitHub
- URL: https://github.com/florianmichael/waybackauthlib
- Owner: FlorianMichael
- License: apache-2.0
- Created: 2023-09-25T13:04:47.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-08-26T13:35:06.000Z (7 months ago)
- Last Synced: 2025-09-13T13:26:17.795Z (6 months ago)
- Topics: authlib, backport, mojang-authentication, third-party, yggdrasil
- Language: Java
- Homepage:
- Size: 285 KB
- Stars: 3
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# WaybackAuthLib
Addon for Mojang's AuthLib to support Yggdrasil authentication again
### This library required the AuthLib to be installed as a dependency
## Why?
With the release of AuthLib 5.0, Mojang has removed all API methods to log in via the Yggdrasil Authentication system,
as Yggdrasil has been officially terminated.
However, many third-party log in methods use the Yggdrasil interface as a reference, this library is an addon for the
AuthLib which adds all old methods back using the
internals of the AuthLib to be as compact as possible. This library will probably also be used in the future to restore
even more methods that have been removed from the AuthLib.
## Contact
If you encounter any issues, please report them on
the [issue tracker](https://github.com/FlorianMichael/WaybackAuthLib/issues).
If you just want to talk or need help with WaybackAuthLib feel free to join
my [Discord](https://florianmichael.de/discord).
## How to add this to your project
### Gradle/Maven
To use WaybackAuthLib with Gradle/Maven you can
use [the Maven Central repository](https://mvnrepository.com/artifact/de.florianmichael/WaybackAuthLib)
or [my own repository](https://maven.florianmichael.de/#/releases/de/florianmichael/WaybackAuthLib).
You can also find instructions how to implement it into your build script there.
### Jar File
If you just want the latest jar file you can download it
from [my build server](https://build.florianmichael.de/job/WaybackAuthLib), [GitHub Actions](https://github.com/FlorianMichael/WaybackAuthLib/actions)
or use the [releases tab](https://github.com/FlorianMichael/WaybackAuthLib/releases).
## Example usage
### Login with username and password / access token, log out and verify session
```java
final WaybackAuthLib authenticator = new WaybackAuthLib("", clientToken, Proxy.NO_PROXY);
authenticator.
setUsername(username);
authenticator.
setPassword(password);
// You can also use authenticator.setAcessToken(), the logIn method will then refresh the acess token
// if it is expired (once you logged in using username/password, the access token field will also be updated automatically)
authenticator.
logIn();
if(authenticator.
isLoggedIn()){
final GameProfile profile = authenticator.getCurrentProfile();
// Do something with the profile
}
final boolean isTokenValid = authenticator.checkTokenValidity();
if(isTokenValid){
// Do something
}
authenticator.
logOut(); // This will invalidate the access token and reset all storages
```