Struct JavaStatus 

pub struct JavaStatus {
    pub version: JavaVersion,
    pub players: JavaPlayers,
    pub description: String,
    pub favicon: Option<String>,
    pub map: Option<String>,
    pub gamemode: Option<String>,
    pub software: Option<String>,
    pub plugins: Option<SmallVec<[JavaPlugin; 8]>>,
    pub mods: Option<SmallVec<[JavaMod; 8]>>,
    pub raw_data: Value,
}

Full status payload returned by a Java Edition server.

Produced by parsing the JSON body of the Status Response packet (0x00). Accessed via JavaServerStatus accessors or directly through ServerData::Java.

Serde behaviour

favicon is excluded from serialisation (#[serde(skip_serializing)]) to avoid bloating JSON output — it is a base64 PNG that can be hundreds of KB. raw_data is excluded entirely (#[serde(skip)]).

Fields

version: JavaVersion

Server version information (name string + protocol number).

players: JavaPlayers

Online / max player counts plus an optional sample list.

description: String

Primary server description (MOTD). May contain §-color codes. Use JavaServerStatus::motd_clean to get a plain-text version.

favicon: Option<String>

Base64-encoded 64×64 PNG favicon. None if the server does not send one. Excluded from JSON serialisation — use JavaServerStatus::favicon or save_favicon to access it.

map: Option<String>

Current map/world name. Only present on servers that expose it (e.g. via a status plugin).

gamemode: Option<String>

Game mode string (e.g. "Survival"). Plugin-specific, not standard.

software: Option<String>

Server software name (e.g. "Paper 1.21.4"). Plugin-specific.

plugins: Option<SmallVec<[JavaPlugin; 8]>>

Plugin list. SmallVec<[_; 8]> avoids a heap allocation for servers with 8 or fewer plugins, which covers most vanilla/lightly-modded setups. None when the server does not expose plugin information.

mods: Option<SmallVec<[JavaMod; 8]>>

Mod list (Forge/Fabric servers). Same allocation strategy as plugins. None when the server does not expose mod information.

raw_data: Value

Raw JSON response body. Excluded from serialisation. Useful for accessing non-standard fields added by server plugins.

Implementations

impl JavaStatus

pub fn save_favicon(&self, filename: &str) -> Result<(), McError>

Save the server favicon to a PNG file on disk.

Strips the optional data:image/png;base64, URI prefix before decoding.

Errors

• McError::Protocol — no favicon available (field is None).
• McError::Protocol — base64 decoding failed (malformed data).
• McError::Io — file could not be created or written.

Example

let client = McClient::builder().build();
if let Ok(s) = client.java("mc.hypixel.net").await {
    s.save_favicon("hypixel_icon.png")?;
}

Trait Implementations

impl Clone for JavaStatus

fn clone(&self) -> JavaStatus

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for JavaStatus

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for JavaStatus

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for JavaStatus

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

where __S: Serializer,

Serialize this value into the given Serde serializer.