ProtocolLib

ProtocolLib
Use the dev build for 1.8 through 26.2

Thanks for over 3 million downloads everyone!

If you love ProtocolLib or it has made your life significantly easier, consider a one-time donation, sponsoring the project or leaving a positive review below. It really means a lot!

Certain tasks are impossible to perform with the standard Bukkit API and may require working with and even modifying Minecraft directly. A common technique is to modify incoming and outgoing packets or to inject custom packets into the stream. This is quite cumbersome to do, however, and most implementations will break as soon as a new version of Minecraft has been released, mostly due to obfuscation.

ProtocolLib is a library that allows read and write access to the Minecraft protocol. It handles most of the overhead required with reflection and channel injection and provides wrappers to simplify packet modification. It is updated with most Minecraft updates so, ideally, individual plugins don't have to. ProtocolLib often doesn't need to be updated for minor updates, especially if there are few code changes (i.e. the 1.8 security updates)

Useful Links

• Releases
• Source Code
• Issue Tracker
• JavaDoc

Support
Before reporting a bug:

• Look for an update for ProtocolLib, there's a good chance your error or bug has already been fixed.
• Read the stack trace and make sure it's an error with ProtocolLib. ProtocolLib's package is com.comphenix.protocol. If you don't see that anywhere, it's not ProtocolLib.
• Check the common errors wiki page.

When reporting a bug:

• Use the issue tracker! Don't report bugs in the reviews. Please search for duplicates before reporting a new issue!
• Provide as much information as possible. Provide your ProtocolLib version and Spigot version.
• Provide any stack traces or "errors" using pastebin.

For server operators
Just download ProtocolLib from the link above. It doesn't do anything on its own, it simply allows other plugins to function.

For developers
A somewhat dated tutorial can be found here. A new tutorial is in progress on the wiki.

TinyProtocol
There is a lightweight alternative to ProtocolLib called TinyProtocol. It is essentially a mechanism to send and receive raw packets without structure modifiers or wrappers. It can be found here.

Maven repository
If you're using Maven, you'll be able to automatically download the jar, JavaDoc and associated sources from Maven Central. This repository is included by default if you're using Maven, but you must declare it explicitly in Gradle:
Then add it as a dependency like so:
Gradle:
NOTE: Previously the groupId was com.comphenix.protocol, but it was recently changed to net.dmulloy2 due to the Maven Central migration.

Commands
Protocol
Main administrative command. Supports the following sub-commands:

• config: Reload the configuration file.
• check: Check for new versions on BukkitDev.
• version: Displays the currently running version of ProtocolLib.