---
title: Changelog
description: What changed in mc-protocol, reconstructed from the repository's commits and grouped by commit date. No tagged releases yet.
---

this page is rebuilt from the repository's commits, not from release notes. there are no tagged releases yet, so entries are grouped by the date each commit was authored. every bullet links to the commit it comes from.

## 18 September 2026

- world generation got configurable: caves, ores, terrain shape and structures are all options now. [de8d277](https://github.com/GDLev/mc-protocol/commit/de8d277)
- `ChunkHelper` can generate a seeded world instead of only flat ones. [5add915](https://github.com/GDLev/mc-protocol/commit/5add915)
- versioned entry modules. `mc-protocol/26.2` pins a version, the root import tracks the newest one. only Minecraft Java 26.2 (protocol 776) is built in; the multi-version layout is there, the other versions aren't. [cfd5d98](https://github.com/GDLev/mc-protocol/commit/cfd5d98)
- the protocol version is negotiated per connection. groundwork for serving several built-in versions from one `Server`; today that's still just 776. [1fa4001](https://github.com/GDLev/mc-protocol/commit/1fa4001)
- `helpers.forVersion()` binds the data-backed helpers (items, blocks, chunks and maps) to a protocol version. [d78fd31](https://github.com/GDLev/mc-protocol/commit/d78fd31)

## 17 September 2026

- named item helpers, plus this website. [19b9a1f](https://github.com/GDLev/mc-protocol/commit/19b9a1f)
- command tree, particle and entity metadata helpers. [01ec43e](https://github.com/GDLev/mc-protocol/commit/01ec43e)
- new `Proxy` class that sits between a client and a server and lets you intercept packets. [0d8f604](https://github.com/GDLev/mc-protocol/commit/0d8f604) `once` handlers are honored on the proxy too. [865b66a](https://github.com/GDLev/mc-protocol/commit/865b66a)
- map helpers with RGB to map color conversion. [0b0cb18](https://github.com/GDLev/mc-protocol/commit/0b0cb18)
- servers negotiate compression, and client and proxy were checked against it. [043db3a](https://github.com/GDLev/mc-protocol/commit/043db3a) compression is on by default at the vanilla threshold. [2944c3d](https://github.com/GDLev/mc-protocol/commit/2944c3d)
- fix: automatic negotiation now finishes before your packet listeners run, so you don't see half-set-up connections. [79685b5](https://github.com/GDLev/mc-protocol/commit/79685b5)
- look up vanilla block state ids by name and properties. [11594c3](https://github.com/GDLev/mc-protocol/commit/11594c3)
- packet flag helper with named bit maps. [e13e3c3](https://github.com/GDLev/mc-protocol/commit/e13e3c3) fix: flag map bits are validated and serverbound ability flags are split out. [4de17ac](https://github.com/GDLev/mc-protocol/commit/4de17ac)

## 16 September 2026

- the project history was imported into this repository. this is where the git log starts. [cf5264e](https://github.com/GDLev/mc-protocol/commit/cf5264e)
- fix: protocol framing, connection lifecycle and wire encoding were corrected. [35d6031](https://github.com/GDLev/mc-protocol/commit/35d6031)

---

want the raw version? the [full commit history](https://github.com/GDLev/mc-protocol/commits/master) is on GitHub.
