sandstone 0.1.2

Networking library for Minecraft: Java Edition servers
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109

use base64::Engine;
use base64::engine::general_purpose;
use serde::{Deserialize, Serialize};

use crate::util::mojang::http::{ApiClient, HttpError};

pub mod http;
mod mojang_testing;

/*
This file defines the Mojang API - used to get information about users, servers and encryption validation
The rate limit is allegedly 600 requests per 10 minutes
Reference = https://wiki.vg/Mojang_API
*/

/// Get the UUID of a username
/// This will return an error if it exceeds the rate limit or if no user with the given username exists
pub async fn get_uuid_from_username(name: String) -> Result<UuidRequestResponse, HttpError> {
	let url = format!("https://api.mojang.com/users/profiles/minecraft/{}", name);
	
	Ok(ApiClient::new().enable_debug_mode().await.get_parse(url, false).await?)
}

#[derive(Deserialize, Serialize, Debug, Clone, PartialEq, Eq, Hash)]
pub struct UuidRequestResponse {
	pub id: String,
	pub name: String,
	#[serde(skip_serializing_if = "Option::is_none")]
	pub legacy: Option<bool>,
	#[serde(skip_serializing_if = "Option::is_none")]
	pub demo: Option<bool>
}

/// Get the UUIDs of multiple usernames at once, in alphabetical order
/// This will return an error if it exceeds the rate limit
pub async fn get_uuids_from_usernames(names: Vec<String>) -> Result<Vec<UuidRequestResponse>, HttpError> {
	let body = serde_json::to_string(&names)?;
	
	let responses = ApiClient::new().enable_debug_mode().await.post_parse("https://api.minecraftservices.com/minecraft/profile/lookup/bulk/byname", body.as_str(), false).await?;
	
	Ok(responses)
}

/// Get details about a given UUID such as the name of the user, a list of moderation actions against their account
/// and most importantly, their skin base64 encoded
pub async fn get_player_details(uuid: String) -> Result<PlayerDetailsResponse, HttpError> {
	let url = format!("https://sessionserver.mojang.com/session/minecraft/profile/{}?unsigned=false", uuid);

	Ok(ApiClient::new().enable_debug_mode().await.get_parse(url, false).await?)
}

#[allow(non_snake_case)]
#[derive(Deserialize, Serialize, Debug, Clone, PartialEq, Eq)]
pub struct PlayerDetailsResponse {
	pub id: String,
	pub name: String,
	pub properties: Vec<SkinPropertyWrapper>,
	pub profileActions: Vec<String>,
	#[serde(skip_serializing_if = "Option::is_none")]
	pub legacy: Option<bool>,
}

#[derive(Deserialize, Serialize, Debug, Clone, PartialEq, Eq, Hash)]
pub struct SkinPropertyWrapper {
	pub name: String,
	pub value: String,
	#[serde(skip_serializing_if = "Option::is_none")]
	pub signature: Option<String>
}

impl SkinPropertyWrapper {
	pub fn get_skin_details(&self) -> Result<SkinProperty, HttpError> {
		let decoded = general_purpose::STANDARD.decode(&self.value)?;
		let decoded = String::from_utf8(decoded)?;

		Ok(serde_json::from_str(&decoded)?)
	}
}

#[allow(non_snake_case)]
#[derive(Deserialize, Serialize, Debug, Clone, PartialEq, Eq, Hash)]
pub struct SkinProperty {
	pub timestamp: u64,
	pub profileId: String,
	pub profileName: String,
	pub signatureRequired: bool,
	pub textures: SkinTexture,
}

#[allow(non_snake_case)]
#[derive(Deserialize, Serialize, Debug, Clone, PartialEq, Eq, Hash)]
pub struct SkinTexture {
	#[serde(skip_serializing_if = "Option::is_none")]
	pub SKIN: Option<URLBlock>,
	#[serde(skip_serializing_if = "Option::is_none")]
	pub CAPE: Option<URLBlock>,
}

#[derive(Deserialize, Serialize, Debug, Clone, PartialEq, Eq, Hash)]
pub struct URLBlock {
	pub url: String,
	#[serde(skip_serializing_if = "Option::is_none")]
	pub metadata: Option<SkinMetadata>
}

#[derive(Deserialize, Serialize, Debug, Clone, PartialEq, Eq, Hash)]
pub struct SkinMetadata {
	pub model: String
}