Broadcasterv1.1.2
Pythonby TheNINJALLOA wrapper plugin for MCXboxBroadcast to broadcast your server to Xbox Live.
pip install https://github.com/TheNINJALLO/endstone-broadcaster/releases/download/v1.1.2/endstone_broadcaster-1.1.2-py3-none-any.whl- Stars
- 3
PLUGINSBROADCASTER
Stable release of the schema 9 compatibility fix, promoted after the operator confirmed 1.1.2rc1 works on their setup. No functional changes from the prerelease; only package version and documentation updates.
- Supports MCXboxBroadcast builds 160/161/162 and config schemas 7/8/9.
- Preserves customized endpoints/query preferences, adds IPv6 defaults and removes obsolete web-query-fallback.
- Retains config backups, guards against future schemas and bounds automatic downloads to reviewed build 162.
- Restores matching JAR/config/version marker after update failures; retains recovery copies and blocks restart if rollback fails.
Validation: 67 source tests and 67 extracted-wheel tests pass; Ruff and wheel build pass. All packaged Python modules are byte-identical to 1.1.2rc1. Tagged CI tests Ubuntu/Windows on Python 3.11/3.14 and uploads the wheel after checks pass.
The operator confirmation applies to their setup, not universal live-platform validation. Cached JAR identity relies on its paired jar_version.txt. See FIX-REPORT.md for verification limits and recovery details.
Install: back up the old wheel and complete plugin data folder, stop Endstone, replace the old wheel with endstone_broadcaster-1.1.2-py3-none-any.whl, preserve account cache, and restart. Do not manually downgrade config-version. Rollback requires the old wheel AND its matching data-folder backup.
The v1.1.2rc1 prerelease remains in release history. GitHub supplies tagged source archives; the tag-triggered CI build supplies the wheel.
Fixes the wrapper rejecting config-version 9 after MCXboxBroadcast updates.
- Supports reviewed builds 160/161/162 and matching schemas 7/8/9.
- Preserves customized v7/v8 endpoints and query preferences.
- Adds IPv6 defaults, removes obsolete web-query-fallback for v9, and preserves backups.
- Refuses schema downgrades and bounds future automatic updates to reviewed build 162.
- Restores matching JAR/config/version marker after update failures; retains recovery copies and blocks restart if rollback fails.
Validation: 67 offline tests pass against source and extracted wheel; Ruff and independent review passed. GitHub CI passed on Ubuntu/Windows with Python 3.11/3.14 before publication.
PRE-RELEASE: Live Endstone/JVM/Xbox authentication and player joining have not been tested. Cached JAR identity relies on its paired jar_version.txt.
Install: back up the old wheel and complete plugin data folder, stop Endstone, replace the old wheel, preserve account cache, and restart. Do not manually downgrade config-version. Rollback requires the old wheel AND its matching data-folder backup.
GitHub supplies the tagged source archives; see FIX-REPORT.md for detailed verification and rollback notes. The tag-triggered CI build supplies the wheel asset after its checks pass.
Fix MCXboxBroadcast build 160 reporting HTTP 404 when an older Endstone/BDS backend accepts /v1/join but rejects the new status probe's query parameters.
- Automatically detect this route behavior through a loopback HTTP adapter, scoped to the configured backend.
- Preserve modern queries and refusal responses, keep HTTPS direct, and forward SDP offer/answer bytes unchanged.
- Keep the official JAR, configured address/port, and authentication cache. No extra public port or configuration is required.
Replace the broadcaster wheel with v1.1.1 and restart Endstone. Keep the existing plugin data folder. Endweave remains responsible for game protocol translation.
Validation: 42 tests, wheel build, and successful probes of the reported backend using build 160's actual Java client with its original 26.60 settings. An authenticated console join still needs to be checked after installation.
Changelog
1.1.0 — 2026-10-27
Update the wrapper for Minecraft 26.60 and MCXboxBroadcast Standalone build 160's NetherNet HTTP relay.
- Require Java 21 or newer. Detect the installed Java version and provision a portable Temurin 21 JRE when PATH or the cached Java 17 runtime is too old.
- Migrate old YAML to config schema 7 with a one-time original-file backup. Use the local backend signaling endpoint, enable NetherNet queries with metadata fallback, rename auto-follow to auto-friend, and remove the old transfer address and ICE port range.
- Preserve current-schema custom endpoints, query settings, webhooks, expiry settings, and authentication cache. Safely serialize server/world names.
- Validate downloaded JARs and release SHA-256 digests when available; reject builds older than 160 for this release.
- Run downloads and startup outside Endstone's main thread. Serialize process changes and prevent an in-flight download from starting a helper after plugin shutdown.
- Keep healthy helpers alive so upstream session rotation works. Restart exited helpers and wait for shutdown before replacing the JAR.
- Test migration and helper lifecycle on Windows/Linux and Python 3.11/3.14 before releasing a wheel.
Upgrade
Replace the wheel and restart Endstone. The first startup migrates config.yml and saves config.yml.pre-v7.bak. Legacy public transfer destinations are replaced with the local backend address; review remote-address and remote-port if using a separate container/backend.
The backend must support NetherNet and the connecting client's game protocol. Configure transport=nethernet and the backend's public UDP mappings in server.properties or your host panel. This release does not upgrade the Endstone server binary or provide game protocol translation.
Validation scope
The 31 automated tests cover the wrapper's migration, runtime, update, and lifecycle behavior. Local verification also provisioned Temurin 21, downloaded and verified the real build 160 JAR, confirmed protocol 2225 at runtime, and loaded the generated YAML with upstream's Java ConfigLoader. An authenticated Xbox/console join still requires validation on a running server with its actual network configuration.
Changes
- Fix: ail() now forwards all Java output — auth URLs and errors are no longer silently dropped
- Fix: Config crash resolved — query-server: false prevents null subMotd NPE
- Fix: stop() escape sequence corrected for graceful shutdown
- Feature: Auto-restart broadcaster every 15 minutes to keep session fresh
- Compliance: Removed banned startup/shutdown logs, unused equests dep, added MIT license
First public release. Features universal Java auto-provisioning and dynamic server.properties synchronization.
Not an official Minecraft product. Not approved by or associated with Mojang or Microsoft.
Not an official Minecraft product. Not approved by or associated with Mojang or Microsoft.