Minecraft MITM proxy with function of rewriting packets, written in pure Python 3
Project description
MCRP: Minecraft Rewrite Proxy
Minecraft MITM proxy with function of rewriting packets, written in pure Python 3.
About
MCRP provides cool interface to interact with minecraft packets goes via proxy.
Supported versions
This note about Play state only! Handshaking, Status, Login fully supported and version-independent.
Absolutely Supported: Minecraft 1.8-1.8.9 Chat supported: Minecraft 1.12.2 For more information on supported protocols, visit the cubelib page on gitlab, because protocol support lies with it.
MCWP
MineCraft Watching Proxy
MCWP is a python script written and distibuted with MCRP It launching MCRP mitm proxy in back and setting global packet handlers to and from the server and then filtering packets with user-defined config and printing it's content in color. How to write filter configuration see in examples
$> mcwp -h
__ __ ____ ____ ____ __ __ ____
| \/ | / ___|| _ \ | _ \ _ \ \ / /| _ \
| |\/| || | | |_) || |_) |(_) \ \ /\ / / | |_) |
| | | || |___ | _ < | __/ _ \ V V / | __/
|_| |_| \____||_| \_\|_| (_) \_/\_/ |_| v0.1.7
usage: mcwp [-h] [-c config.yaml] [-v] [-l addr] [-u addr] [-d decmod] [-ll]
[--leave-debug-journals]
Minecraft Watching Proxy
optional arguments:
-h, --help show this help message and exit
-c config.yaml Path to YAML config file
-v If passed, enables verbose logging
-l addr Proxy listen addr [localhost:25565] (enclose ipv6 like
[::])
-u addr Proxy upstream server addr [localhost:25575]
-d decmod Protocol decryption module
-ll If passed, enables low level debug logging
--leave-debug-journals
If passed, leaves debug journals
Requirements
- Python 3 (tested and developed under
Python 3.7.9
) - cubelib >= 1.0.3-pre.1
- ruamel.yaml == 0.17.21
- pycryptodome
Installation
MCRP is published in PyPI, so latest release can be installed with one simple command:
pip install -U mcrp
or bleeding edge from git sources (unstable) (may not work at all!):
git clone https://gitlab.com/seeklay/MCRP.git
cd mcrp/
pip3 install .
Usage examples
$> mcwp -c examples\conf_blacklist.yaml -v -ll -d md --leave-debug-journals
__ __ ____ ____ ____ __ __ ____
| \/ | / ___|| _ \ | _ \ _ \ \ / /| _ \
| |\/| || | | |_) || |_) |(_) \ \ /\ / / | |_) |
| | | || |___ | _ < | __/ _ \ V V / | __/
|_| |_| \____||_| \_\|_| (_) \_/\_/ |_| v0.1.7-pre1
[02/20/2023 09:33:01 PM] [INFO] MCRP: Running MCRP v0.1.7-pre1 (cubelib version 1.0.4-pre1)
[02/20/2023 09:33:01 PM] [INFO] MCRP: Proxying config is: 127.0.0.1:25565 -> 127.0.0.1:25575
[02/20/2023 09:33:01 PM] [INFO] MCRP: Using protocol decryptor: Yggdrasil-Server-DecMod/v0.1
[02/20/2023 09:33:01 PM] [INFO] MCRP: Debug journals enabled!
[02/20/2023 09:33:01 PM] [DEBUG] MCRP/CRYPTO: Generating 1024 RSA key...
[02/20/2023 09:33:02 PM] [INFO] MCRP: Registred direct handlers list[1]:
[02/20/2023 09:33:02 PM] [INFO] MCRP: <class 'cubelib.proto.version_independent.ServerBound.Handshaking.Handshake'>
[02/20/2023 09:33:02 PM] [INFO] MCRP: Registred relative handlers list[0]:
[02/20/2023 09:33:02 PM] [DEBUG] MCRP: Entering mainloop
[02/20/2023 09:33:02 PM] [INFO] MCRP: Waiting for client connection...
[02/20/2023 09:33:02 PM] [INFO] MCRP: New client, creating connection to the server
[02/20/2023 09:33:02 PM] [INFO] MCRP: Connected to the server
[02/20/2023 09:33:02 PM] [INFO] MCRP: Reseting state to Handshaking
[02/20/2023 09:33:02 PM] [INFO] root: ServerBound Handshaking.Handshake(ProtoVer=47, ServerName='lc', ServerPort=25565, NextState=NextState.Status)
[02/20/2023 09:33:02 PM] [INFO] root: ServerBound Status.Request()
[02/20/2023 09:33:02 PM] [INFO] root: ClientBound Status.Response(JsonRsp='{"description":"A Minecraft Server","players":{"max":20,"online":0},"version":{"name":"Spigot 1.8.8","protocol":47}}')
[02/20/2023 09:33:02 PM] [INFO] root: ServerBound Status.Ping(Uniq=133772128)
[02/20/2023 09:33:02 PM] [INFO] root: ClientBound Status.Pong(Uniq=133772128)
[02/20/2023 09:33:02 PM] [INFO] MCRP: Client disconnected
[02/20/2023 09:33:02 PM] [INFO] MCRP: Server disconnected
[02/20/2023 09:33:02 PM] [INFO] MCRP: Waiting for client connection...
See examples/ for MCRP usage details
Protocol decryption
MCWP
For protocol decryption enabling you need user to use your instance of yggdrasil-server
Add -d md
arg to mcwp command to use standard yggdrasil server decryption module
This module will spoof server publickey, read shared secret and spoof session on sessionserver.
Then you will see decrypted packets.
MCRP
If you want to manipulate encrypted packets from your script you need to add decryptor
keyword argument to MCRewriteProxy constructor like this:
proxy = MCRewriteProxy(("localhost", 25565), ("localhost", 25575), logging.INFO,
decryptor=decryptor_class)
where decryptor_class is heir of MCRP.ProtocolDecryptor
like MCWPDecryptor
in md.py, oh yes you can import MCWPDecryptor
from md.py and use it here too
TODO
- Rewrite networking with ku
- еще ченить можно добавить =P
Author
License
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.