MITM proxy tool for Minecraft: Bedrock Edition
ProxyPass is a MITM proxy for Minecraft: Bedrock Edition that sits between an unmodified vanilla client and server.
It helps protocol developers inspect, forward, and optionally modify packets in real time, making protocol debugging and vanilla behavior analysis much easier.
ProxyPass requires the backend server to run with online mode disabled (online-mode=false).
With online mode disabled, the server does not verify client identity, so ProxyPass can relay traffic between the client and server.
If online mode is enabled, the server will reject ProxyPass because it cannot provide valid authentication.
Make sure your server is configured correctly before testing.
- Protocol library used in this project
Contributions are welcome.
- Open an Issue for bug reports, feature requests, or protocol discussions.
- Open a Pull Request for fixes, improvements, and new packet support.
- Keep changes focused and provide clear descriptions of behavior changes.
This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0). See the full text in LICENSE.
Core AGPL-3.0 requirements (summary):
- If you modify this software and distribute it, or make it available over a network, you must release the complete corresponding source code under AGPL-3.0.
- You must keep existing copyright and license notices in all source files.
- You may not impose any further restrictions on the recipients' exercise of the rights granted herein.
- Any derivative work or combined work must also be licensed under AGPL-3.0.
This summary is for convenience only. The LICENSE file is the authoritative legal text.