Skip to main content

Endweave

Seamlessly interweaving Bedrock protocol versions.

Build

An Endstone plugin that lets Bedrock clients connect to servers with different protocol versions by rewriting packets at the network layer. Inspired by ViaVersion.

Supported Versions

Endweave translates between any two of these:

Minecraft Version Protocol
26.40-26.44 2168
26.45 2169
26.50-26.52 2193
26.60 2225

26.45 puts the same bytes on the wire as 26.40-26.44 under a different number, so Endweave carries a client on either onto a server on the other by writing the server's number into the handshake, and translates nothing.

A protocol one past one in the table, as a release usually is after its last preview, is translated as that one until Endweave lists it. The log warns when that happens, as the two may not match.

Not translated

These versions are known to Endweave but not carried by the 0.5.0 engine:

Minecraft Version Protocol
1.21.120-1.21.123 859
1.21.124 860
1.21.130-1.21.132 898
26.0-26.3 924
26.10-26.13 944
26.20 975
26.30-26.32 1001

Endweave up to 0.4.3 translated 1.21.120 through 26.20, and 26.30 was never translated by any release. A client on one of these can still join a server speaking the same protocol; it just gets nothing from Endweave.

Quick Start

  1. Open the latest release and download the wheel that matches your server. Several are attached, one per platform and Python version:
    • win_amd64 for Windows, manylinux_2_28_x86_64 for Linux on glibc 2.28 or newer.
    • cp311 for Python 3.11, cp312-abi3 for 3.12 and later.
  2. Drop it in your server's plugins/ folder
  3. Restart the server

Endstone installs the file you drop in, so a wheel built for another platform or Python version is refused and the plugin does not load. The install also fetches a few dependencies from PyPI, so the server needs network access the first time it starts with Endweave in plugins/.

Players on newer clients will connect transparently. No additional configuration needed.

How It Works

Endweave handles protocol differences between Minecraft versions, allowing players to join servers on different protocol versions. Whether a client is newer or older than the server, packets are translated in real time. Only fields that actually changed get rewritten, and players already on the server's version go through zero extra processing. A packet the other version has no counterpart for is dropped rather than forwarded, so neither end is handed something it cannot read.

Since 0.5.0 the translation runs in a C++ engine compiled from bedrock-protocol rather than in Python.

Contributing

Issues and PRs welcome on GitHub.

License

Apache License 2.0

Metadata

Release files for endstone-endweave 0.6.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for endstone-endweave 0.6.2
File Size Uploaded Provenance
endstone_endweave-0.6.2.tar.gz 268.7 kB With provenance Details

Built distributions (wheels)

Table of built distributions (wheels) for endstone-endweave 0.6.2
File
endstone_endweave-0.6.2-cp312-abi3-win_amd64.whl CPython 3.12 abi3 Windows x86-64 Details
endstone_endweave-0.6.2-cp312-abi3-manylinux_2_28_x86_64.whl CPython 3.12 abi3 Linux glibc 2.28+ x86-64 Details
endstone_endweave-0.6.2-cp311-cp311-win_amd64.whl CPython 3.11 CPython 3.11 Windows x86-64 Details
endstone_endweave-0.6.2-cp311-cp311-manylinux_2_28_x86_64.whl CPython 3.11 CPython 3.11 Linux glibc 2.28+ x86-64 Details

Total release size: 5.1 MB

Release files / endstone_endweave-0.6.2.tar.gz

Download URL endstone_endweave-0.6.2.tar.gz
Size 268.7 kB
Tags Source
SHA-256 checksum
How to use checksums
d32c953f91718fb11351e8761856bda2058b4abe954cf6ddeced676c98c9fe40
BLAKE2b-256 checksum
How to use checksums
38c06d60fe0e79462ee308d8c6edeb90bfcda300c9d15f6579a95e96858b205a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 20, 2026.

Transparency log

Release files / endstone_endweave-0.6.2-cp312-abi3-win_amd64.whl

Download URL endstone_endweave-0.6.2-cp312-abi3-win_amd64.whl
Size 835.1 kB
Tags CPython 3.12 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
f88eaa03b066aabf743ab85461871d2e75c0d0d65eb56cfe86818fa6de1a07c3
BLAKE2b-256 checksum
How to use checksums
978c550387701f0e1676d55cc68a433d45646d6712696ece38c72eeef3301fb4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 20, 2026.

Transparency log

Release files / endstone_endweave-0.6.2-cp312-abi3-manylinux_2_28_x86_64.whl

Download URL endstone_endweave-0.6.2-cp312-abi3-manylinux_2_28_x86_64.whl
Size 1.6 MB
Tags CPython 3.12 Linux glibc 2.28+ x86-64 abi3
SHA-256 checksum
How to use checksums
18fa1a1438e8cb6f5f297b32f5d315c62c1740ab70f3c7e7eef1525e3b622eb5
BLAKE2b-256 checksum
How to use checksums
6b61b2f5304c50d5eaa5ac420164e1dde101a3a320a37a9391dcd93f52da3f05
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 20, 2026.

Transparency log

Release files / endstone_endweave-0.6.2-cp311-cp311-win_amd64.whl

Download URL endstone_endweave-0.6.2-cp311-cp311-win_amd64.whl
Size 836.2 kB
Tags CPython 3.11 Windows x86-64
SHA-256 checksum
How to use checksums
0067c0773326d99c69fc6e398d856e6a7367cf3dba494b5e9a1dd4a61b4d8502
BLAKE2b-256 checksum
How to use checksums
f224c2995c9e67161577cb21b13cb7693b19c2bf844af0f2f35611d35e370373
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 20, 2026.

Transparency log

Release files / endstone_endweave-0.6.2-cp311-cp311-manylinux_2_28_x86_64.whl

Download URL endstone_endweave-0.6.2-cp311-cp311-manylinux_2_28_x86_64.whl
Size 1.6 MB
Tags CPython 3.11 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
d664e4fc253eb475581549c354fa5d903e515f1cdf41c8744a5c850a2733982b
BLAKE2b-256 checksum
How to use checksums
b664b8d2467b061b97fa6c66fb7211cb8974d3729ea9c0771b5bea2543526692
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 20, 2026.

Transparency log

Security for endstone-endweave 0.6.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 5 files in this release have been uploaded with provenance metadata.

Select from 5 files

Attestation for endstone_endweave-0.6.2.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 20, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page