Struct RaknetListener 

pub struct RaknetListener { /* private fields */ }

A RakNet UDP server that accepts incoming connections.

Implementations

impl RaknetListener

pub async fn bind(sockaddr: &SocketAddr) -> Result<Self>

Bind a RakNet listener to the specified UDP address.

Call listen before accepting connections.

pub async fn from_std(socket: UdpSocket) -> Result<Self>

Creates a listener from a standard UDP socket.

pub async fn listen(&mut self)

Start receiving connection requests.

Call this before accept. Repeated calls have no effect.

pub async fn accept(&mut self) -> Result<RaknetSocket>

Wait for and accept the next incoming RakNet connection.

Call listen first.

Example

let mut listener = RaknetListener::bind("127.0.0.1:19132".parse().unwrap()).await.unwrap();
listener.listen().await;
let mut socket = listener.accept().await.unwrap();

pub fn get_guid(&self) -> u64

Get the GUID, a random number that uniquely identifies the listener instance.

pub async fn set_motd( &mut self, server_name: &str, max_connection: u32, mc_protocol_version: &str, mc_version: &str, game_type: &str, port: u16, ) -> Result<()>

Set the server-list MOTD returned in unconnected pong packets.

Future ping responses use the updated value.

Example

let mut listener = RaknetListener::bind("127.0.0.1:19132".parse().unwrap()).await.unwrap();
listener.set_motd("Bedrock Server", 20, "protocol", "version", "Survival", 19132).await?;

pub async fn get_motd(&self) -> String

Return the MOTD sent in unconnected pong packets.

Example

let listener = RaknetListener::bind("127.0.0.1:19132".parse().unwrap()).await.unwrap();
let motd = listener.get_motd().await;

pub fn local_addr(&self) -> Result<SocketAddr>

Return the local UDP address used by this listener.

Example

let mut socket = RaknetListener::bind("127.0.0.1:19132".parse().unwrap()).await.unwrap();
assert_eq!(socket.local_addr().unwrap().ip(), IpAddr::V4(Ipv4Addr::new(127, 0, 0, 1)));

pub async fn close(&mut self) -> Result<()>

Close the listener and all active connections.

Example

let mut socket = RaknetListener::bind("127.0.0.1:19132".parse().unwrap()).await.unwrap();
socket.close().await;

pub async fn set_full_motd(&mut self, motd: String) -> Result<()>

Set the full MOTD string used by future unconnected pong responses.

Example

let mut listener = RaknetListener::bind("127.0.0.1:19132".parse().unwrap()).await.unwrap();
listener.set_full_motd(String::from("motd")).await.unwrap();

pub async fn get_peer_raknet_version(&self, peer: &SocketAddr) -> Result<u8>

Trait Implementations

impl Drop for RaknetListener

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.