//! A low-level crate to send and receive Minecraft packets. //! //! You should probably use [`azalea`] or [`azalea_client`] instead, as //! `azalea_protocol` delegates much of the work, such as auth, to the user of //! the crate. //! //! [`azalea`]: https://crates.io/crates/azalea //! [`azalea_client`]: https://crates.io/crates/azalea-client //! //! See [`crate::connect::Connection`] for an example. // these two are necessary for thiserror backtraces #![feature(error_generic_member_access)] #![feature(provide_any)] use std::{fmt::Display, net::SocketAddr, str::FromStr}; #[cfg(feature = "connecting")] pub mod connect; #[cfg(feature = "packets")] pub mod packets; pub mod read; pub mod resolver; pub mod write; /// A host and port. It's possible that the port doesn't resolve to anything. /// /// # Examples /// /// `ServerAddress` implements TryFrom<&str>, so you can use it like this: /// ``` /// use azalea_protocol::ServerAddress; /// /// let addr = ServerAddress::try_from("localhost:25565").unwrap(); /// assert_eq!(addr.host, "localhost"); /// assert_eq!(addr.port, 25565); /// ``` #[derive(Debug, Clone)] pub struct ServerAddress { pub host: String, pub port: u16, } impl<'a> TryFrom<&'a str> for ServerAddress { type Error = String; /// Convert a Minecraft server address (host:port, the port is optional) to /// a `ServerAddress` fn try_from(string: &str) -> Result { if string.is_empty() { return Err("Empty string".to_string()); } let mut parts = string.split(':'); let host = parts.next().ok_or("No host specified")?.to_string(); // default the port to 25565 let port = parts.next().unwrap_or("25565"); let port = u16::from_str(port).map_err(|_| "Invalid port specified")?; Ok(ServerAddress { host, port }) } } impl From for ServerAddress { /// Convert an existing `SocketAddr` into a `ServerAddress`. This just /// converts the ip to a string and passes along the port. The resolver /// will realize it's already an IP address and not do any DNS requests. fn from(addr: SocketAddr) -> Self { ServerAddress { host: addr.ip().to_string(), port: addr.port(), } } } impl Display for ServerAddress { fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { write!(f, "{}:{}", self.host, self.port) } } #[cfg(test)] mod tests { use std::io::Cursor; use crate::{ packets::login::{ serverbound_hello_packet::ServerboundHelloPacket, ServerboundLoginPacket, }, read::read_packet, write::write_packet, }; use bytes::BytesMut; use uuid::Uuid; #[tokio::test] async fn test_hello_packet() { let packet = ServerboundHelloPacket { name: "test".to_string(), profile_id: Some(Uuid::nil()), } .get(); let mut stream = Vec::new(); write_packet(&packet, &mut stream, None, &mut None) .await .unwrap(); let mut stream = Cursor::new(stream); let _ = read_packet::( &mut stream, &mut BytesMut::new(), None, &mut None, ) .await .unwrap(); } #[tokio::test] async fn test_double_hello_packet() { let packet = ServerboundHelloPacket { name: "test".to_string(), profile_id: Some(Uuid::nil()), } .get(); let mut stream = Vec::new(); write_packet(&packet, &mut stream, None, &mut None) .await .unwrap(); write_packet(&packet, &mut stream, None, &mut None) .await .unwrap(); let mut stream = Cursor::new(stream); let mut buffer = BytesMut::new(); let _ = read_packet::(&mut stream, &mut buffer, None, &mut None) .await .unwrap(); let _ = read_packet::(&mut stream, &mut buffer, None, &mut None) .await .unwrap(); } }