using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Threading.Tasks;
/// !!! ATTENTION !!!
/// By using these functions you agree to the ToS of the Mojang API.
/// You should note that all public APIs are rate limited so you are expected to cache the results.
/// This is currently set at 600 requests per 10 minutes but this may change.
/// Source: https://wiki.vg/Mojang_API
/// !!! ATTENTION !!!
namespace MinecraftClient.Protocol
{
// Enum to display the status of different services
public enum ServiceStatus { red, yellow, green };
///
/// Information about a players Skin.
/// Empty string if not available.
///
public class SkinInfo
{
public readonly string SkinUrl;
public readonly string CapeUrl;
public readonly string SkinModel;
public SkinInfo(string skinUrl = "", string capeUrl = "", string skinModel = "")
{
SkinUrl = skinUrl;
CapeUrl = capeUrl;
SkinModel = skinModel;
}
}
///
/// Status of the single Mojang services
///
public class MojangServiceStatus
{
public readonly ServiceStatus MinecraftNet;
public readonly ServiceStatus SessionMinecraftNet;
public readonly ServiceStatus AccountMojangCom;
public readonly ServiceStatus AuthserverMojangCom;
public readonly ServiceStatus SessionserverMojangCom;
public readonly ServiceStatus ApiMojangCom;
public readonly ServiceStatus TexturesMinecraftNet;
public readonly ServiceStatus MojangCom;
public MojangServiceStatus(ServiceStatus minecraftNet = ServiceStatus.red,
ServiceStatus sessionMinecraftNet = ServiceStatus.red,
ServiceStatus accountMojangCom = ServiceStatus.red,
ServiceStatus authserverMojangCom = ServiceStatus.red,
ServiceStatus sessionserverMojangCom = ServiceStatus.red,
ServiceStatus apiMojangCom = ServiceStatus.red,
ServiceStatus texturesMinecraftNet = ServiceStatus.red,
ServiceStatus mojangCom = ServiceStatus.red)
{
MinecraftNet = minecraftNet;
SessionMinecraftNet = sessionMinecraftNet;
AccountMojangCom = accountMojangCom;
AuthserverMojangCom = authserverMojangCom;
SessionserverMojangCom = sessionserverMojangCom;
ApiMojangCom = apiMojangCom;
TexturesMinecraftNet = texturesMinecraftNet;
MojangCom = mojangCom;
}
}
///
/// Provides methods to easily interact with the Mojang API.
///
public static class MojangAPI
{
// Initialize webclient for all functions
private static readonly HttpClient httpClient = new();
// Can be removed in newer C# versions.
// Replace with DateTimeOffset.FromUnixTimeMilliseconds()
///
/// Converts a Unix time to a normal Datetime
///
/// A unix timestamp as double
/// Datetime of unix timestamp
private static DateTime UnixTimeStampToDateTime(double unixTimeStamp)
{
// Unix timestamp is seconds past epoch
DateTime dateTime = new(1970, 1, 1, 0, 0, 0, 0, DateTimeKind.Utc);
dateTime = dateTime.AddMilliseconds(unixTimeStamp).ToLocalTime();
return dateTime;
}
// Can be removed in newer C# versions.
///
/// Converts a string to a ServiceStatus enum.
///
/// string to convert
/// ServiceStatus enum, red as default.
private static ServiceStatus StringToServiceStatus(string s)
{
if (Enum.TryParse(s, out ServiceStatus servStat))
{
return servStat;
}
else
{
// return red as standard value.
return ServiceStatus.red;
}
}
///
/// Obtain the UUID of a Player through its name
///
/// Playername
/// UUID as string
public static string NameToUuid(string name)
{
try
{
Task fetchTask = httpClient.GetStringAsync("https://api.mojang.com/users/profiles/minecraft/" + name);
fetchTask.Wait();
string result = Json.ParseJson(fetchTask.Result).Properties["id"].StringValue;
fetchTask.Dispose();
return result;
}
catch (Exception) { return string.Empty; }
}
///
/// Obtain the Name of a player through its UUID
///
/// UUID of a player
/// Players UUID
public static string UuidToCurrentName(string uuid)
{
// Perform web request
try
{
Task fetchTask = httpClient.GetStringAsync("https://api.mojang.com/user/profiles/" + uuid + "/names");
fetchTask.Wait();
var nameChanges = Json.ParseJson(fetchTask.Result).DataArray;
fetchTask.Dispose();
// Names are sorted from past to most recent. We need to get the last name in the list
return nameChanges[^1].Properties["name"].StringValue;
}
catch (Exception) { return string.Empty; }
}
///
/// Get the name history from a UUID
///
/// UUID of a player
/// Name history, as a dictionary
public static Dictionary UuidToNameHistory(string uuid)
{
Dictionary tempDict = new();
List jsonDataList;
// Perform web request
try
{
Task fetchTask = httpClient.GetStringAsync("https://api.mojang.com/user/profiles/" + uuid + "/names");
fetchTask.Wait();
jsonDataList = Json.ParseJson(fetchTask.Result).DataArray;
fetchTask.Dispose();
}
catch (Exception) { return tempDict; }
foreach (Json.JSONData jsonData in jsonDataList)
{
if (jsonData.Properties.Count > 1)
{
// Time is saved as long in the Unix format.
// Convert it to normal time, before adding it to the dictionary.
//
// !! FromUnixTimeMilliseconds does not exist in the current version. !!
// DateTimeOffset creationDate = DateTimeOffset.FromUnixTimeMilliseconds(Convert.ToInt64(jsonData.Properties["changedToAt"].StringValue));
//
// Workaround for converting Unix time to normal time.
DateTimeOffset creationDate = UnixTimeStampToDateTime(Convert.ToDouble(jsonData.Properties["changedToAt"].StringValue));
// Add Keyvaluepair to dict.
tempDict.Add(jsonData.Properties["name"].StringValue, creationDate.DateTime);
}
// The first entry does not contain a change date.
else if (jsonData.Properties.Count > 0)
{
// Add an undefined time to it.
tempDict.Add(jsonData.Properties["name"].StringValue, new DateTime());
}
}
return tempDict;
}
///
/// Get the Mojang API status
///
/// Dictionary of the Mojang services
public static MojangServiceStatus GetMojangServiceStatus()
{
List jsonDataList;
// Perform web request
try
{
Task fetchTask = httpClient.GetStringAsync("https://status.mojang.com/check");
fetchTask.Wait();
jsonDataList = Json.ParseJson(fetchTask.Result).DataArray;
fetchTask.Dispose();
}
catch (Exception)
{
return new MojangServiceStatus();
}
// Convert string to enum values and store them inside a MojangeServiceStatus object.
return new MojangServiceStatus(minecraftNet: StringToServiceStatus(jsonDataList[0].Properties["minecraft.net"].StringValue),
sessionMinecraftNet: StringToServiceStatus(jsonDataList[1].Properties["session.minecraft.net"].StringValue),
accountMojangCom: StringToServiceStatus(jsonDataList[2].Properties["account.mojang.com"].StringValue),
authserverMojangCom: StringToServiceStatus(jsonDataList[3].Properties["authserver.mojang.com"].StringValue),
sessionserverMojangCom: StringToServiceStatus(jsonDataList[4].Properties["sessionserver.mojang.com"].StringValue),
apiMojangCom: StringToServiceStatus(jsonDataList[5].Properties["api.mojang.com"].StringValue),
texturesMinecraftNet: StringToServiceStatus(jsonDataList[6].Properties["textures.minecraft.net"].StringValue),
mojangCom: StringToServiceStatus(jsonDataList[7].Properties["mojang.com"].StringValue)
);
}
///
/// Obtain links to skin, skinmodel and cape of a player.
///
/// UUID of a player
/// Dictionary with a link to the skin and cape of a player.
public static SkinInfo GetSkinInfo(string uuid)
{
Dictionary textureDict;
string base64SkinInfo;
Json.JSONData decodedJsonSkinInfo;
// Perform web request
try
{
Task fetchTask = httpClient.GetStringAsync("https://sessionserver.mojang.com/session/minecraft/profile/" + uuid);
fetchTask.Wait();
// Obtain the Base64 encoded skin information from the API. Discard the rest, since it can be obtained easier through other requests.
base64SkinInfo = Json.ParseJson(fetchTask.Result).Properties["properties"].DataArray[0].Properties["value"].StringValue;
fetchTask.Dispose();
}
catch (Exception) { return new SkinInfo(); }
// Parse the decoded string to the JSON format.
decodedJsonSkinInfo = Json.ParseJson(System.Text.Encoding.UTF8.GetString(Convert.FromBase64String(base64SkinInfo)));
// Assert temporary variable for readablity.
// Contains skin and cape information.
textureDict = decodedJsonSkinInfo.Properties["textures"].Properties;
// Can apparently be missing, if no custom skin is set.
// Probably for completely new accounts.
// (Still exists after changing back to Steve or Alex skin.)
if (textureDict.ContainsKey("SKIN"))
{
return new SkinInfo(skinUrl: textureDict["SKIN"].Properties.ContainsKey("url") ? textureDict["SKIN"].Properties["url"].StringValue : string.Empty,
capeUrl: textureDict.ContainsKey("CAPE") ? textureDict["CAPE"].Properties["url"].StringValue : string.Empty,
skinModel: textureDict["SKIN"].Properties.ContainsKey("metadata") ? "Alex" : "Steve");
}
// Tested it on several players, this case never occured.
else
{
// This player has assumingly never changed their skin.
// Probably a completely new account.
return new SkinInfo(capeUrl: textureDict.ContainsKey("CAPE") ? textureDict["CAPE"].Properties["url"].StringValue : string.Empty,
skinModel: DefaultModelAlex(uuid) ? "Alex" : "Steve");
}
}
///
/// Gets the playermodel that is assigned to the account by default.
/// (Before the skin is changed for the first time.)
///
/// UUID of a Player
/// True if the default model for this UUID is Alex
public static bool DefaultModelAlex(string uuid)
{
return HashCode(uuid) % 2 == 1;
}
///
/// Creates the hash of an UUID
///
/// UUID of a player.
///
private static int HashCode(string hash)
{
byte[] data = GuidExtensions.ToLittleEndian(new Guid(hash)).ToByteArray();
ulong msb = 0;
ulong lsb = 0;
for (int i = 0; i < 8; i++)
msb = (msb << 8) | (uint)(data[i] & 0xff);
for (int i = 8; i < 16; i++)
lsb = (lsb << 8) | (uint)(data[i] & 0xff);
var hilo = msb ^ lsb;
return ((int)(hilo >> 32)) ^ (int)hilo;
}
}
}