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
91
92
//! Minecraft Java Edition network protocol for the ghast client library.
//!
//! Layers, bottom to top:
//!
//! - [`codec`]: bounds-checked [`Reader`] over [`bytes::Bytes`] (zero-copy byte arrays
//! and strings), [`McWrite`] for encoding, VarInt/VarLong.
//! - [`types`], [`nbt`], [`chat`]: hand-written shared types — [`BlockPos`] with the
//! per-version bit layout, slots, lazily parsed NBT ([`nbt::RawNbt`]), chat JSON.
//! - Generated packet modules per protocol version (`v1_8` = protocol 47, `v1_12_1` = 338,
//! `v1_12_2` = 340, `v1_16_5` = 754, `v26_1` = 775, `v26_2` = 776), each with typed packets, one enum per state
//! and direction, and id constants. The definitions themselves live once in [`defs`]
//! and are shared by every version whose code for them is identical. A [`Version`]
//! marker type ties a version's packet sets together so a version-agnostic layer can be
//! written generically; [`versions`] is the table of known protocol numbers.
//! - [`frame`]: length framing, zlib compression with partial inflation, the
//! AES-128-CFB8 hook ([`crypto`]), and the per-id [`PacketFilter`] that drops unwanted
//! packets before they are decoded.
//! - [`io`] (feature `tokio`): async framed reader/writer.
//!
//! Decoding never panics on untrusted input: every failure is a [`DecodeError`] or
//! [`FrameError`], and allocations are bounded by the input size.
//!
//! ```
//! use ghast_protocol::{FrameDecoder, FrameEncoder, PacketSet, RawPacket};
//! use ghast_protocol::v1_8::play::serverbound::{KeepAlive, ServerboundPlayPacket};
//!
//! let mut enc = FrameEncoder::new();
//! enc.write_packet(&KeepAlive { keep_alive_id: 42 }).unwrap();
//! let mut dec = FrameDecoder::new();
//! dec.push(&enc.take());
//! let raw: RawPacket = dec.next_packet().unwrap().unwrap();
//! let p = ServerboundPlayPacket::decode_raw(&raw).unwrap();
//! assert_eq!(p, ServerboundPlayPacket::KeepAlive(KeepAlive { keep_alive_id: 42 }));
//! ```
// 1.12.1 rides on the 1.12.2 feature: its module is aliases of 1.12.2's definitions except the
// keep-alive packets (VarInt ids, as in 1.8).
pub use ;
pub use ;
pub use ;
pub use ;
pub use ;
pub use BlockPos;
pub use ProtocolVersion;