org.shanerx.mojang

Class Mojang

java.lang.Object

org.shanerx.mojang.Mojang

public class Mojang
extends java.lang.Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Mojang.ServiceStatus This enum represents the possible Mojang API servers availability statuses.
static class	Mojang.ServiceType This enum represents the various portions of the Mojang API.
static class	Mojang.SkinType This enum represents the skin types "Alex" and "Steve".

Constructor Summary

Constructors

Constructor and Description
Mojang() Constructor.

Method Summary

Modifier and Type	Method and Description
Mojang	connect() Opens the connection with the Mojang API.
java.util.Map<java.lang.String,java.lang.Long>	getNameHistoryOfPlayer(java.lang.String uuid) Retrieves all the username a certain UUID has had in the past, including the current one.
PlayerProfile	getPlayerProfile(java.lang.String uuid) Returns the PlayerProfile object which holds and represents the metadata for a certain account.
SalesStats	getSaleStatistics(SalesStats.Options... options) Returns the official mojang's product sales statistics.
java.util.List<java.lang.String>	getServerBlacklist() Returns a list of blacklisted hostnames, belonging to servers that were blocked due to Mojang's EULA infringement.
Mojang.ServiceStatus	getStatus(Mojang.ServiceType service) Retrieves the status of a portion of the API.
java.lang.String	getUUIDOfUsername(java.lang.String username) Retrieves the current UUID linked to a username.
java.lang.String	getUUIDOfUsername(java.lang.String username, java.lang.String timestamp) Retrieves the UUID linked to a username at a certain moment in time.
void	resetSkin(java.lang.String uuid, java.lang.String token) Resets the skin to the default.
void	updateAndUpload(java.lang.String uuid, java.lang.String token, Mojang.SkinType skinType, java.lang.String file) Updates the skin of a player using a URI.
void	updateSkin(java.lang.String uuid, java.lang.String token, Mojang.SkinType skinType, java.lang.String skinUrl) Updates the skin of a player using a URI.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Mojang

public Mojang()

Constructor. Initializes member variables.

Method Detail

connect

public Mojang connect()

Opens the connection with the Mojang API. Should always be called after creating the API object.

Example: Mojang api = new Mojang().connect();

Returns:

the api itself. Useful for concatenation.

getStatus

public Mojang.ServiceStatus getStatus(Mojang.ServiceType service)

Retrieves the status of a portion of the API. Check the enum entries for Mojang.ServiceStatus for possible response types.

Parameters:

service - the service type

Returns:

the status of said service

getUUIDOfUsername

public java.lang.String getUUIDOfUsername(java.lang.String username)

Retrieves the current UUID linked to a username.

Parameters:

username - the username

Returns:

the UUID as a String

getUUIDOfUsername

public java.lang.String getUUIDOfUsername(java.lang.String username,
                                          java.lang.String timestamp)

Retrieves the UUID linked to a username at a certain moment in time.

Parameters:

username - the username

timestamp - the Java Timestamp that represents the time

Returns:

the UUID as a String

getNameHistoryOfPlayer

public java.util.Map<java.lang.String,java.lang.Long> getNameHistoryOfPlayer(java.lang.String uuid)

Retrieves all the username a certain UUID has had in the past, including the current one.

Parameters:

uuid - the UUID

Returns:

a map with the username as key value and the Timestamp as a Long

getPlayerProfile

public PlayerProfile getPlayerProfile(java.lang.String uuid)

Returns the PlayerProfile object which holds and represents the metadata for a certain account.

Parameters:

uuid - the UUID of the player

Returns:

the PlayerProfile object}

updateSkin

public void updateSkin(java.lang.String uuid,
                       java.lang.String token,
                       Mojang.SkinType skinType,
                       java.lang.String skinUrl)

Updates the skin of a player using a URI. This means that the image file will not be uploaded to Mojang's servers, hence the API will need to query the given URI.

Parameters:

uuid - the UUID of said player

token - the token used for API authentication

skinType - the type of the skin

skinUrl - a direct URL to the skin

updateAndUpload

@Untested
public void updateAndUpload(java.lang.String uuid,
                                      java.lang.String token,
                                      Mojang.SkinType skinType,
                                      java.lang.String file)

Updates the skin of a player using a URI. The raw skin data will be uploaded to Mojang's servers and stored there potentially forever.

Parameters:

uuid - the UUID of said player

token - the token used for API authentication

skinType - the type of the skin

file - the raw image data

resetSkin

public void resetSkin(java.lang.String uuid,
                      java.lang.String token)

Resets the skin to the default.

Parameters:

uuid - the UUID of the player

token - the token used for API authentication

getServerBlacklist

public java.util.List<java.lang.String> getServerBlacklist()

Returns a list of blacklisted hostnames, belonging to servers that were blocked due to Mojang's EULA infringement.

N.B.: These may not be in human friendly form as they were hashed. You may want to use third-party services to obtain an (unofficial) list.

Returns:

a List of all the blocked hostnames

getSaleStatistics

@Untested
public SalesStats getSaleStatistics(SalesStats.Options... options)

Returns the official mojang's product sales statistics.

Parameters:

options - the query options

Returns:

the stats