Skip to content

Instantly share code, notes, and snippets.

@barneygale
Last active April 18, 2024 06:00
Show Gist options
  • Star 34 You must be signed in to star a gist
  • Fork 7 You must be signed in to fork a gist
  • Save barneygale/1209061 to your computer and use it in GitHub Desktop.
Save barneygale/1209061 to your computer and use it in GitHub Desktop.
import socket
import struct
import json
def unpack_varint(s):
d = 0
for i in range(5):
b = ord(s.recv(1))
d |= (b & 0x7F) << 7*i
if not b & 0x80:
break
return d
def pack_varint(d):
o = ""
while True:
b = d & 0x7F
d >>= 7
o += struct.pack("B", b | (0x80 if d > 0 else 0))
if d == 0:
break
return o
def pack_data(d):
return pack_varint(len(d)) + d
def pack_port(i):
return struct.pack('>H', i)
def get_info(host='localhost', port=25565):
# Connect
s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
s.connect((host, port))
# Send handshake + status request
s.send(pack_data("\x00\x00" + pack_data(host.encode('utf8')) + pack_port(port) + "\x01"))
s.send(pack_data("\x00"))
# Read response
unpack_varint(s) # Packet length
unpack_varint(s) # Packet ID
l = unpack_varint(s) # String length
d = ""
while len(d) < l:
d += s.recv(1024)
# Close our socket
s.close()
# Load json and return
return json.loads(d.decode('utf8'))
@markfickett
Copy link

Thanks for this! I wrote a simple OO wrapper using it as a base. https://github.com/markfickett/minecraftstatus/blob/master/mcstatus.py

@mid-kid
Copy link

mid-kid commented May 29, 2014

Thanks for this! I used the *_varint functions to create a simple chat client.

@thekeenant
Copy link

Used this in in a load balancer for Minecraft.

@hYdos
Copy link

hYdos commented Jul 21, 2018

using it for 1.13 server :D ty so much 👍

@djmanbr
Copy link

djmanbr commented Aug 19, 2018

This is working for newer versions?

@leowhitehead
Copy link

Great stuff, thanks a lot

@Bros112
Copy link

Bros112 commented Dec 21, 2021

There is an error for me:
Traceback (most recent call last): File "C:\GetInfo.py", line 55, in <module> print(get_info(host='play.hypixel.net',port=25565)) File "C:\GetInfo.py", line 37, in get_info s.send(pack_data("\x00\x00" + pack_data(host.encode('utf8')) + pack_port(port) + "\x01")) File "C:\GetInfo.py", line 25, in pack_data return pack_varint(len(d)) + d File "C:\GetInfo.py", line 19, in pack_varint o += struct.pack("B", b | (0x80 if d > 0 else 0)) TypeError: can only concatenate str (not "bytes") to str

While using:
print(get_info(host='play.hypixel.net',port=25565))

Help

@Miniontoby
Copy link

Miniontoby commented Jun 6, 2022

There is an error for me: Traceback (most recent call last): File "C:\GetInfo.py", line 55, in <module> print(get_info(host='play.hypixel.net',port=25565)) File "C:\GetInfo.py", line 37, in get_info s.send(pack_data("\x00\x00" + pack_data(host.encode('utf8')) + pack_port(port) + "\x01")) File "C:\GetInfo.py", line 25, in pack_data return pack_varint(len(d)) + d File "C:\GetInfo.py", line 19, in pack_varint o += struct.pack("B", b | (0x80 if d > 0 else 0)) TypeError: can only concatenate str (not "bytes") to str

While using: print(get_info(host='play.hypixel.net',port=25565))

Help

The script is written for python2, so it doesn't work with python3.

I cannot really edit the code so it will work at python3 for some reason... so yeah

@clarence112
Copy link

I've updated this to be compatible with python3

https://gist.github.com/clarence112/9a3e971283d7f4052a0c33f11de9b7c5

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment