@breezil/packet-defsTyped Minecraft protocol packets

Fully typed packet definitions for the Breezil ecosystem. Minecraft 1.8.9 is ready today, with every version on the way.

Getting Started

API Reference

View on GitHub

🧩

Typed packet defs

Every Minecraft 1.8.9 (protocol version 47) packet described as a documented TypeScript interface, with per-field notes on the values you can expect. 1.8.9 is complete today, and the same treatment is planned for every Minecraft version.

🗂️

Organized by state and direction

Definitions are grouped by protocol state and direction (handshake, login, status, play clientbound and serverbound) so they line up with how packets flow on the wire.

🔢

Buffer-typed binary fields

Raw byte fields use Node's Buffer type, so encryption keys, tokens, and chunk data stay honest. That is why the package depends on @types/node.

🛰️

Shared across Breezil

One source of truth for what is on the wire, used by the Breezil proxy to decode raw network frames by numeric packet id straight into typed shapes.

📦

Full type declarations

Ships as a typed library with .d.ts declarations published alongside the build, so consumers get autocompletion and type safety out of the box.