PacketWeave

PacketWeave

PacketWeave is a shared library for Minecraft mods that transfer binary assets between clients and servers. Its transfer core helps mod developers split and reconstruct media, structure files, and other custom payloads with explicit resource limits.

Features

• Chunked transfers: Split files and byte arrays into indexed chunks and reconstruct chunks received out of order.
• Resource limits: Bound individual transfers, sessions per sender, total sessions, and memory use.
• Authorization hooks: Let the consuming mod check permissions when a transfer begins, receives chunks, and completes.
• Transfer cleanup: Cancel transfers, expire inactive sessions, and release state when a connection closes.
• Input checks: Reject duplicate chunks and invalid transfer geometry, detect files that change during sending, and provide SHA-256 digest utilities.
• Shared core: Use the same Java 8-compatible transfer implementation across supported loaders and Minecraft versions.

How it works

PacketWeave provides a public Java API for sending and receiving binary assets through Minecraft's native networking. Its transfer registry assembles indexed chunks, enforces resource budgets, invokes authorization callbacks, and cleans up transfer sessions.

It runs as a library dependency, with the same transfer core packaged for each supported loader.

Platform targets

Choose the native mod file matching your Minecraft version and loader. Do not install the development-only core jar as a replacement.

For mod developers

Compile against the public API, install the native PacketWeave runtime mod, and declare the required minimum version in loader metadata. Do not duplicate the public API classes inside a consuming mod. PacketWeave itself does not require Architectury API or Fabric API.

See the integration guide and API example for runtime dependency declarations, transfer limits, and adapter responsibilities.

Support and license

• Source code and documentation
• Report bugs
• MIT license