GitPedia

MCProtocolLib

A library for communication with a Minecraft client/server.

From GeyserMC·Updated June 28, 2026·View on GitHub·

MCProtocolLib is a simple library for communicating with Minecraft clients and servers. It allows developers to build custom bots, clients, or servers for Minecraft with ease. The project is written primarily in Java, distributed under the MIT License license, first published in 2012. Key topics include: java, library, minecraft, minecraft-protocol, protocol.

Latest release: 1.21.4-11.21.4-1
January 18, 2025View Changelog →

MCProtocolLib

MCProtocolLib is a simple library for communicating with Minecraft clients and servers. It allows developers to build custom bots, clients, or servers for Minecraft with ease.

Example Code

See the example folder for sample usage.

Adding as a Dependency

MCProtocolLib builds are published to the Open Collaboration repository.
Follow the below steps to add MCProtocolLib as a dependency to your project.

Maven

Add the Repository

xml
<repositories> <repository> <id>opencollab</id> <url>https://repo.opencollab.dev/main/</url> </repository> </repositories>

Add the Dependency

xml
<dependency> <groupId>org.geysermc.mcprotocollib</groupId> <artifactId>protocol</artifactId> <version>(version here)</version> </dependency>

Gradle (Groovy DSL)

Add the Repository

groovy
repositories { maven { name 'opencollab' url 'https://repo.opencollab.dev/main/' } }

Add the Dependency

groovy
dependencies { implementation 'org.geysermc.mcprotocollib:protocol:(version here)' }

Gradle (Kotlin DSL)

Add the Repository

kotlin
repositories { maven("https://repo.opencollab.dev/main/") { name = "opencollab" } }

Add the Dependency

kotlin
dependencies { implementation("org.geysermc.mcprotocollib:protocol:(version here)") }

Snapshots

To use snapshot builds, switch the URL to https://repo.opencollab.dev/maven-snapshots/.

Javadocs

You can find the Javadocs for MCProtocolLib on opencollab.

Building the Source

MCProtocolLib uses Gradle to manage dependencies. To build the source code, run ./gradlew clean build in the project root directory.

Support and Development

Please join the GeyserMC Discord server and visit the #mcprotocollib channel for discussion and support for this project.

License

MCProtocolLib is licensed under the MIT license.

Contributors

Showing top 12 contributors by commit count.

View all contributors on GitHub →

This article is auto-generated from GeyserMC/MCProtocolLib via the GitHub API.Last fetched: 6/29/2026