Struct ServerStatus 

pub struct ServerStatus {
    pub online: bool,
    pub ip: String,
    pub port: u16,
    pub hostname: String,
    pub latency: f64,
    pub dns: Option<DnsInfo>,
    pub data: ServerData,
}

Server status information.

This structure contains all information about a Minecraft server’s status. Even if the server is offline, some fields may still be populated (e.g., DNS info).

Example

use rust_mc_status::{McClient, ServerEdition};

let client = McClient::new();
let status = client.ping("mc.hypixel.net", ServerEdition::Java).await?;

println!("Hostname: {}", status.hostname);
println!("IP: {}", status.ip);
println!("Port: {}", status.port);
println!("Online: {}", status.online);
println!("Latency: {:.2}ms", status.latency);

Fields

online: bool

Whether the server is online and responding.

This field is always true for successful pings. If the server is offline or unreachable, the ping() method returns an error instead.

ip: String

Resolved IP address of the server.

This is the actual IP address that was connected to, which may differ from the hostname if SRV records were used or if the hostname resolves to multiple IP addresses.

Example: "172.65.197.160"

port: u16

Port number of the server.

This is the actual port that was connected to. For Java servers, this may differ from the default port (25565) if an SRV record was found.

Example: 25565 (Java) or 19132 (Bedrock)

hostname: String

Original hostname used for the query.

This is the hostname that was provided to the ping() method, before any DNS resolution or SRV lookup.

Example: "mc.hypixel.net"

latency: f64

Latency in milliseconds.

This is the round-trip time (RTT) from sending the ping request to receiving the response. Lower values indicate better network connectivity.

Example: 45.23 (45.23 milliseconds)

dns: Option<DnsInfo>

Optional DNS information (A records, CNAME, TTL).

This field contains DNS resolution details if available. It may be None if DNS information could not be retrieved or if an IP address was used directly instead of a hostname.

data: ServerData

Server data (Java or Bedrock specific information).

This field contains edition-specific server information including version, players, plugins, mods, and more. Use pattern matching to access the data:

match data {
    ServerData::Java(java) => println!("Java server: {}", java.version.name),
    ServerData::Bedrock(bedrock) => println!("Bedrock server: {}", bedrock.version),
}

Implementations

impl ServerStatus

pub fn players(&self) -> Option<(i64, i64)>

Get player count information.

Returns a tuple of (online, max) players, or None if not available.

Example

if let Some((online, max)) = status.players() {
    println!("Players: {}/{}", online, max);
}

Trait Implementations

impl Clone for ServerStatus

fn clone(&self) -> ServerStatus

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ServerStatus

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ServerStatus

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ServerStatus

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.