Skip to content

ProtocolExtension

Adds more packets to extend server possibilities! [#killaislop]

FabricPaper
Loaders
FabricPaper
Downloads on Modrinth
2.2K
Followers on Modrinth
1
versions
154
Updated
July 9, 2026Jul 9
Published
in 2025

At a glance

Runs on Fabric and Paper
For Minecraft 1.20.6–26.2
Needed in the game and on the server
Latest version — 15+26.2 from July 9, 2026
Requires PacketEvents
License Zlib — free
Where it's needed
In gamerequiredOn serverrequired

Needed both in the game and on the server

Game versions1.20.6–26.2

🏛️ ProtocolExtension extends server possibilities by adding more packets* to the game.

Note: If you're using my mods, please do not buy Minecraft.


📦 Setup (only for server owners)
ProtocolExtension can only be installed as a client on Fabric, and as a server on Paper (and forks). I may add more compatibility in the future but it is not considered currently. The project JAR is both for the server, and the client.
  1. Download the ProtocolExtension latest JAR file
  2. Download the PacketEvents latest JAR file
  3. Upload both JARs to the server plugins folder

Of course, all players also need to install the ProtocolExtension JAR file (to be able to have the custom packets work), but it doesn't have any dependencies on the client.

(You can make a plugin that kicks players for not using this as a mod, however it's optional to do so - because most plugins I make use this just as a QoL thing, not an essential part of any process)
Older versions of ProtocolExtension are not supported. If you need an update for an older Minecraft version, please request it on the GitHub Issues page - if it's not too different from the latest (in terms of code), I might make a version for it. ProtocolExtension will be undergoing a rewrite onto Avoid Framework. Don't worry, this will bring even more Minecraft versions support!
🪶 Packets
    [Serverbound]
  • Activate (internal) - sent first to notify the server of the ProtocolExtension support
  • KeyPressedC2S - received when the client presses a non-special key in-game
  • MouseMoveC2S - received when the client moves the mouse in a screen
  • ChatOpenedC2SPayload - received when the client opens the chat screen
  • ChatClosedC2SPayload - received when the client closes the chat screen
    [Clientbound]
  • Activate (internal) - sent back to notify the client of the ProtocolExtension support
  • ToggleHUDS2C - sent to click F1 on behalf of the client**
  • HUDPutElementS2C - adds an element with a given id, position and text to the in-game HUD
  • HUDDeleteElementS2C - deletes an element with a given id from the ingame HUD
  • HUDClearS2C - clears all elements from the ingame HUD
  • HUDSettingHotbarS2C - toggles hotbar visibility on the ingame HUD
  • MoveToggleS2C - toggles movement ticking in the client logic
  • ServerCommandS2C - sets the player's sneaking and sprinting modes
  • SetWindowTitleS2C - appends a text literal to the game window title
  • SetPerspectiveS2C - sets the client's perspective
  • ToggleRenderingS2C - toggles whether the game renders for the client
  • ClearChatS2CPayload - clears the client's chat

🛡️ Security

ProtocolExtension treats your device safety seriously, and minimizes the provided data as much as possible. The server cannot:

  • evaluate raw code on your client
  • log your keyboard or mouse states when used outside of the game
  • view any HUD elements not created by it
All HUD elements the server makes are automatically removed after you leave the server.
🏮 API

ProtocolExtension has an API to send the custom packets to the clients. A documentation will be available for it soon. To install it, you need to embed the ProtocolExtension jar in your maven.pom/build.gradle as compile-only; more info here.

* it actually uses CustomPayload packets
** toggle HUD visibility

FAQ

How to install ProtocolExtension?

Install Fabric for your Minecraft version, download ProtocolExtension for the same version and loader, put the file into the mods folder and launch the game with the loader profile.

Which Minecraft versions does ProtocolExtension support?

ProtocolExtension has builds for Minecraft 1.20.6–26.2.

Is ProtocolExtension needed on the server?

Needed in the game and on the server

License and source
zlib Licensefree to use and share with credit to the author
Original — Modrinth↗Files unchanged, verified with SHA-512Is this your mod? For rights holders

The site uses cookies: the necessary ones for sign-in and the theme, plus the Yandex Metrica and LiveInternet visit counters — they show us how the site is used. We have no advertising cookies. More