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.3

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.3
File Size Uploaded Provenance Actions
endstone_endweave-0.6.3.tar.gz 280.8 kB With provenance Details for endstone_endweave-0.6.3.tar.gz

Built distributions (wheels)

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

Total release size: 5.2 MB

Release files / endstone_endweave-0.6.3.tar.gz

Download URL endstone_endweave-0.6.3.tar.gz
Size 280.8 kB
Tags Source
SHA-256 checksum
How to use checksums
00eb6903cc2362b81a0cf6c5838bb3969c5d6e284d80a79df1e4ea1bd979fc42
BLAKE2b-256 checksum
How to use checksums
d8a1e8c8b66e602885ca073325608497c1e8ab0f0b2660eb8fbe227ab8a44460
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 25, 2026.

Transparency log

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

Download URL endstone_endweave-0.6.3-cp312-abi3-win_amd64.whl
Size 856.1 kB
Tags CPython 3.12 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
fb4a3919f4e521d4baea077130e6d5a1ba48135086180e558e3d47cd129377ec
BLAKE2b-256 checksum
How to use checksums
d161ea6983780bb85303b2d37d76ab2cef42658dee64bff2d061d30175dc5a02
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 25, 2026.

Transparency log

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

Download URL endstone_endweave-0.6.3-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
9fa55f2cf8d0e4e5b1c9b356b4ce4ce6c3e782522dc03445942d6bc524bc2bc5
BLAKE2b-256 checksum
How to use checksums
06046b8b1bfd5257a22f390b3aa9df4aae2cb8d3014ae4a25f7f4f3d0df9f527
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 25, 2026.

Transparency log

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

Download URL endstone_endweave-0.6.3-cp311-cp311-win_amd64.whl
Size 857.8 kB
Tags CPython 3.11 Windows x86-64
SHA-256 checksum
How to use checksums
a75b1c9510d028733ca6c94d0a647d48a521e3f6852c380d5302b51f7a109b2d
BLAKE2b-256 checksum
How to use checksums
0cc0aac20ee9b9049abc93bba978c6dd3751bd7f5f3ef2d62d9d5f3a4f967749
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 25, 2026.

Transparency log

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

Download URL endstone_endweave-0.6.3-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
7348d59afbb3d5bc9f1c5ce5400f2071515f9f72c43e4c6eec87a65aed393e47
BLAKE2b-256 checksum
How to use checksums
1279a47ed986b5fd291b6dd522b86daeaf7ecc9e4638ed24b89829afb4ec730b
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 25, 2026.

Transparency log

Security for endstone-endweave 0.6.3

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.3.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 25, 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