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,
    pub cached: bool,
    pub meta: HashMap<String, String>,
}

Full server status returned to callers after a successful ping.

Assembled by McClient from a PingResult (produced by the wire protocol) plus resolved network metadata (IP, port, DNS info).

Most callers access this through the typed wrappers JavaServerStatus and BedrockServerStatus which provide ergonomic accessors. Use .raw() on those wrappers or match on ServerData directly when you need fields not surfaced by the accessors.

Serde

ServerStatus implements Serialize and Deserialize. The meta field is skipped in serialisation when empty.

Fields

online: bool

true if the server responded successfully within the timeout.

ip: String

Resolved IP address of the server, e.g. "172.65.197.160".

port: u16

Port that was connected to.

hostname: String

Original hostname as provided to the ping call, e.g. "mc.hypixel.net". This is the value sent in the Minecraft handshake packet.

latency: f64

Round-trip latency in milliseconds. 0.0 for cached responses.

dns: Option<DnsInfo>

DNS resolution metadata. None only in unusual error paths.

data: ServerData

Edition-specific payload — match on ServerData to access fields.

cached: bool

true when this result was served from the response cache without a network request. latency will be 0.0 in this case.

Prefer JavaServerStatus::is_cached or BedrockServerStatus::is_cached over accessing this field directly.

meta: HashMap<String, String>

Protocol-specific extra fields forwarded from PingResult::meta.

Empty for Java Modern and Bedrock (they have fully-typed models). Skipped in serialisation when empty.

Implementations

impl ServerStatus

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

Returns (online_players, max_players) regardless of edition.

Returns None only if data is a future variant with no player count.

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.