deepslate-protocol 0.1.0

Minecraft protocol primitives for the Deepslate proxy.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90

//! Status (server list ping) packets.

use bytes::{Buf, BufMut};

use crate::types::{self, ProtocolError};

use super::Packet;

/// Serverbound status request (packet ID 0x00 in STATUS state).
/// This packet has no fields.
#[derive(Debug, Clone)]
pub struct StatusRequestPacket;

impl Packet for StatusRequestPacket {
    const PACKET_ID: i32 = 0x00;

    fn decode(_buf: &mut impl Buf) -> Result<Self, ProtocolError> {
        Ok(Self)
    }

    fn encode(&self, _buf: &mut impl BufMut) {}
}

/// Clientbound status response (packet ID 0x00 in STATUS state).
#[derive(Debug, Clone)]
pub struct StatusResponsePacket {
    /// JSON string containing the server status.
    pub json: String,
}

impl Packet for StatusResponsePacket {
    const PACKET_ID: i32 = 0x00;

    fn decode(buf: &mut impl Buf) -> Result<Self, ProtocolError> {
        let json = types::read_string(buf)?;
        Ok(Self { json })
    }

    fn encode(&self, buf: &mut impl BufMut) {
        types::write_string(buf, &self.json);
    }
}

/// Serverbound ping request (packet ID 0x01 in STATUS state).
#[derive(Debug, Clone)]
pub struct PingRequestPacket {
    /// Arbitrary payload echoed by the server.
    pub payload: i64,
}

impl Packet for PingRequestPacket {
    const PACKET_ID: i32 = 0x01;

    fn decode(buf: &mut impl Buf) -> Result<Self, ProtocolError> {
        if buf.remaining() < 8 {
            return Err(ProtocolError::UnexpectedEof);
        }
        Ok(Self {
            payload: buf.get_i64(),
        })
    }

    fn encode(&self, buf: &mut impl BufMut) {
        buf.put_i64(self.payload);
    }
}

/// Clientbound pong response (packet ID 0x01 in STATUS state).
#[derive(Debug, Clone)]
pub struct PongResponsePacket {
    /// The payload echoed from the ping request.
    pub payload: i64,
}

impl Packet for PongResponsePacket {
    const PACKET_ID: i32 = 0x01;

    fn decode(buf: &mut impl Buf) -> Result<Self, ProtocolError> {
        if buf.remaining() < 8 {
            return Err(ProtocolError::UnexpectedEof);
        }
        Ok(Self {
            payload: buf.get_i64(),
        })
    }

    fn encode(&self, buf: &mut impl BufMut) {
        buf.put_i64(self.payload);
    }
}