A minecraft authentication library that allows microsoft (xbox live) accounts to be logged in and returns a minecraft profile with an access token as well as xbox profile settings. This library also allows for storage of the authentication data and therefore sessions can be refreshed without a new login on the users side.
To build just run ./gradlew build. You will find the jars in the build/libs directory.
This project requires gson and java 17 as dependency.
To include this project you can use the maven build of this project which will resolve all required dependencies automatically. The latest version is the latest tag in github.
repositories {
maven {
url = "https://repo.u-team.info"
}
}
dependencies {
implementation "net.hycrafthd:minecraft_authenticator:3.0.5"
}<repositories>
<repository>
<id>u-team-repo</id>
<url>https://repo.u-team.info/</url>
</repository>
</repositories>
<dependencies>
<dependency>
<groupId>net.hycrafthd</groupId>
<artifactId>minecraft_authenticator</artifactId>
<version>3.0.5</version>
</dependency>
</dependencies>The main public facing api is the Authenticator class. This class is documented and you should have a look here about more information. The following code snippets are just some simple usage demonstrations.
// Build authenticator
final Authenticator authenticator = Authenticator.ofMicrosoft(authorizationCode).shouldAuthenticate().build();
try {
// Run authentication
authenticator.run();
} catch (final AuthenticationException ex) {
// Always check if result file is present when an exception is thrown
final AuthenticationFile file = authenticator.getResultFile();
if (file != null) {
// Save authentication file
file.writeCompressed(outputStream);
}
// Show user error or rethrow
throw ex;
}
// Save authentication file
final AuthenticationFile file = authenticator.getResultFile();
file.writeCompressed(outputStream);
// Get user
final Optional<User> user = authenticator.getUser();// Build authenticator
final Authenticator authenticator = Authenticator.of(existingAuthFile).shouldAuthenticate().build();
try {
// Run authentication
authenticator.run();
} catch (final AuthenticationException ex) {
// Always check if result file is present when an exception is thrown
final AuthenticationFile file = authenticator.getResultFile();
if (file != null) {
// Save authentication file
file.writeCompressed(outputStream);
}
// Show user error or rethrow
throw ex;
}
// Save authentication file
final AuthenticationFile file = authenticator.getResultFile();
file.writeCompressed(outputStream);
// Get user
final Optional<User> user = authenticator.getUser();// Build authenticator
final Authenticator authenticator = Authenticator.ofMicrosoft(authorizationCode)
.customAzureApplication(clientId, redirectUrl)
.shouldRetrieveXBoxProfile()
.shouldAuthenticate()
.build();
try {
// Run authentication
authenticator.run();
} catch (final AuthenticationException ex) {
// Always check if result file is present when an exception is thrown
final AuthenticationFile file = authenticator.getResultFile();
if (file != null) {
// Save authentication file
file.writeCompressed(outputStream);
}
// Show user error or rethrow
throw ex;
}
// Save authentication file
final AuthenticationFile file = authenticator.getResultFile();
file.writeCompressed(outputStream);
// Get user
final Optional<User> user = authenticator.getUser();
// Get XBox profile
final Optional<XBoxProfile> xBoxProfile = authenticator.getXBoxProfile();This project is licensed under apache 2 license. For more information see here.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent